以下是从零开始安装 Claude Code 的详细操作步骤，涵盖环境准备、安装过程与验证方法。请根据你的操作系统选择对应的分支操作。

(PS: 官方文档：

接入 Claude Code | DeepSeek API Docs)

---

一、安装 Node.js 18 或更高版本

Claude Code 基于 Node.js 运行，需要 Node.js 18+（建议使用最新的 LTS 版本）。

1. 检查是否已安装 Node.js

打开终端（或命令提示符），输入：

node --version

• 如果显示 v18.x.x 或更高版本，则已满足要求，可跳过安装步骤。

• 如果显示 command not found 或版本过低，请继续安装。

2. 安装 Node.js

• Windows / macOS： 访问 Node.js 官网，下载 LTS 版本 的安装包，运行安装程序（一路默认选项即可）。

• Linux： 使用包管理器安装，例如 Ubuntu/Debian：

  curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
  sudo apt install -y nodejs

  其他发行版请参考 NodeSource 指南。

安装完成后，重新打开终端，再次运行 node --version 确认版本。

---

二、Windows 用户：安装 Git for Windows

macOS / Linux 用户可跳过这一步，因为系统自带或可安装 Git，但一般 Claude Code 不强制要求（除非使用某些 Git 集成功能）。为了确保兼容性，推荐所有用户都安装 Git。

1. 访问 Git for Windows 下载页。

2. 下载适合你系统（32/64位）的安装程序（如 Git-2.45.2-64-bit.exe）。

3. 运行安装程序，保持默认选项 直到完成（特别是要确保 Git Bash 和 Git from the command line 被选中）。

4. 安装完成后，重启终端（或重启电脑），输入 git --version 验证是否成功。

---

三、使用 npm 全局安装 Claude Code

打开终端（Windows 用户推荐使用 Git Bash 或 PowerShell，普通 CMD 也可）。

执行以下命令：

npm install -g @anthropic-ai/claude-code

可能遇到的问题及解决：

• 权限错误（EACCES）： 在 Linux/macOS 上，可以加 sudo 执行：

  sudo npm install -g @anthropic-ai/claude-code

  或者修复 npm 全局目录权限。

• 网络慢/超时： 可以切换为淘宝镜像：

  npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

• Windows 提示 “不能运行脚本”： 以管理员身份打开 PowerShell，执行：

  Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

  然后重新运行安装命令。

安装过程会显示进度条，完成后提示 added xxx packages in xxs。

---

四、验证安装是否成功

在终端中执行：

claude --version

如果正常显示版本号（例如 0.1.0），则安装成功。 若提示 claude: command not found，请检查：

• 是否成功执行了 npm install -g（重新运行一次看是否有报错）。

• npm 全局安装的目录是否在系统的 PATH 中。

  • 查看全局目录：npm config get prefix

  • 将该目录下的 bin 文件夹（Windows 为同级目录）添加到系统环境变量。

---

五、下一步：使用 Claude Code

安装完成后，输入 claude 即可启动交互式命令行工具。首次使用可能需要登录或配置 API 密钥（根据官方指南操作）。

---

总结步骤一览（复制用）：

1. 安装 Node.js 18+ → node --version

2. Windows 用户安装 Git for Windows → git --version

3. npm install -g @anthropic-ai/claude-code

4. claude --version

如有任何错误信息，请根据提示进行排错或提供具体报错内容。

---

六、配置环境变量

（一）Linux / macOS 用户

1. 临时设置（仅当前终端会话有效）

打开终端，逐行执行以下命令（将 <你的 DeepSeek API Key> 替换为真实 Key）：

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<你的 DeepSeek API Key>
export ANTHROPIC_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max

验证：输入 echo $ANTHROPIC_AUTH_TOKEN 应显示你的 API Key（部分遮盖是正常的）。

2. 永久生效（推荐）

将上述 export 语句添加到你的 shell 配置文件中（取决于你使用的 shell）：

• Bash：~/.bashrc 或 ~/.bash_profile

• Zsh：~/.zshrc

• Fish：~/.config/fish/config.fish（语法略有不同）

示例（Bash/Zsh）：

echo '
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=sk-你的真实Key
export ANTHROPIC_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max
' >> ~/.bashrc

然后执行 source ~/.bashrc 使其立即生效。

---

（二）Windows 用户

方式一：PowerShell（临时设置，仅当前窗口有效）

打开 PowerShell（建议使用 Windows Terminal 或 PowerShell 7），执行：

$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="<你的 DeepSeek API Key>"
$env:ANTHROPIC_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_EFFORT_LEVEL="max"

验证：输入 $env:ANTHROPIC_AUTH_TOKEN 应显示你的 Key。

方式二：永久设置（通过系统环境变量）

1. 按 Win + R，输入 sysdm.cpl 并回车。

2. 切换到 高级 选项卡 → 点击 环境变量。

3. 在 用户变量（或系统变量）区域，点击 新建，依次添加以下变量：

变量名	变量值
ANTHROPIC_BASE_URL	https://api.deepseek.com/anthropic
ANTHROPIC_AUTH_TOKEN	你的 DeepSeek API Key（如 sk-xxxx）
ANTHROPIC_MODEL	deepseek-v4-pro[1m]
ANTHROPIC_DEFAULT_OPUS_MODEL	deepseek-v4-pro[1m]
ANTHROPIC_DEFAULT_SONNET_MODEL	deepseek-v4-pro[1m]
ANTHROPIC_DEFAULT_HAIKU_MODEL	deepseek-v4-flash
CLAUDE_CODE_SUBAGENT_MODEL	deepseek-v4-flash
CLAUDE_CODE_EFFORT_LEVEL	max

1. 点击 确定 保存，然后 重启终端（或重启电脑）使设置生效。

💡 你也可以使用命令行设置永久环境变量（PowerShell 管理员）：

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","https://api.deepseek.com/anthropic","User")

其余变量同理，但操作较繁琐，建议直接用图形界面。

---

（三）验证环境变量是否生效

Linux/macOS

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN | cut -c1-10   # 只显示前10位，避免泄露

Windows (PowerShell)

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN.Substring(0,10)

---

（四）启动 Claude Code

完成上述配置后，在同一个终端中（若设置了永久变量则任意新终端）直接输入：

claude

Claude Code 会读取这些环境变量，将请求发送到 DeepSeek 的 Anthropic 兼容接口，并使用你配置的模型（注意 deepseek-v4-pro[1m] 和 deepseek-v4-flash 需确保在 DeepSeek 平台确实存在对应模型名称，如名称有差异请根据官方文档调整）。

---

常见问题

• claude: command not found：说明第一步安装未成功，请回到安装步骤重新执行 npm install -g @anthropic-ai/claude-code。

• API 调用返回 401：检查 ANTHROPIC_AUTH_TOKEN 是否设置正确且未过期。

• 模型不存在错误：登录 DeepSeek 平台查看可用的模型名称，修正环境变量中的模型名（如可能是 deepseek-chat 或 deepseek-reasoner）。

• Windows 提示“无法加载 PowerShell 配置文件”：忽略，不影响环境变量设置，只需确保在执行 claude 之前运行过 $env:... 命令。

如果需要将环境变量设置写成脚本（例如每次运行前自动加载），也可以创建一个 set-env.ps1 文件，每次先执行它再运行 claude。