Claude Code 跨平台安装指南
Claude Code 作为当前 AI 编码领域的强力工具，支持在多种操作系统上运行。本文基于实际工程经验，梳理了 Windows（含 WSL）、Linux 及 macOS 下的安装与配置流程，重点解决环境依赖与变量配置问题。
前置准备
无论选择哪种系统，都需要确保基础开发环境就绪：
- Node.js 环境：建议版本 20+，旧版（如 18）可能遇到兼容性问题。推荐使用
nvm进行版本管理。node -v && npm -v - Git 工具：用于拉取代码或管理依赖。
- API 密钥：从官方控制台获取 API Key 并妥善保管。
Windows 环境安装
Windows 用户有两种主流路径：原生 PowerShell/CMD 或 WSL 子系统。
方案一：原生环境直装
直接在终端执行以下命令即可全局安装：
npm uninstall -g @anthropic-ai/claude-code
npm install -g @anthropic-ai/claude-code
安装完成后重启终端，通过版本号确认：
claude -v
环境变量配置： 需在系统环境变量中添加以下三项：
ANTHROPIC_BASE_URL：指向 API 服务地址ANTHROPIC_API_KEY：你的密钥ANTHROPIC_AUTH_TOKEN：认证令牌
方案二：WSL 子系统
若习惯 Linux 命令行体验，可启用 WSL2：
- 开启功能：控制面板中勾选'适用于 Linux 的 Windows 子系统'和'虚拟机平台'，重启生效。
- 安装发行版：管理员模式下运行
wsl --install自动部署 Ubuntu。 - 集成 Docker：如需容器化部署，Docker Desktop 需勾选 "Use WSL 2 based engine" 并在设置中启用 WSL 集成。
进入 WSL 后，安装步骤与 Linux 一致（见下文），注意挂载 Windows 目录时路径格式为 /mnt/d/...。
Linux / macOS 环境安装
这两个系统安装逻辑基本相同，原生支持 Ubuntu 18.04+、Debian 10+ 及 macOS 10.15+。
一键安装脚本
打开终端执行环境检查与安装：
curl -fsSL https://download.aicodemirror.com/env_deploy/env-install.sh | bash
注：若使用官方源，可直接使用 npm 安装。
卸载与重装
如遇冲突，先清理旧版本：
npm uninstall -g @anthropic-ai/claude-code
随后重新安装：
npm install -g @anthropic-ai/claude-code
配置 API 密钥
创建密钥后，执行配置脚本注入环境变量：
apt-get install jq curl -fsSL https://download.aicodemirror.com/env_deploy/env-deploy.sh | bash -s --
