📦 环境准备

Node.js 24.14

安装完成后，打开终端验证：

node --version
npm --version

Git 2.54

来源	下载地址
Git 官方	https://git-scm.com/install/windows
清华镜像	https://mirrors.tuna.tsinghua.edu.cn/github-release/git-for-windows/git/
npmmirror 镜像	https://registry.npmmirror.com/binary.html?path=git-for-windows/v2.54.0.windows.1/

安装完成后验证：

git --version

🚀 安装 Claude Code

使用国内镜像安装（推荐）：

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

如果遇到权限问题（Linux/Mac），可加 sudo：

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

安装完成后验证：

claude --version

🔐 PowerShell 执行策略（Windows 用户）

首次运行前，需要放开 PowerShell 脚本执行权限：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

⚠️ 仅对当前用户生效，不影响系统其他用户。如果仍无法运行，请以管理员身份打开 PowerShell 再执行上述命令。

⚙️ 配置文件

配置文件路径：

Linux / Mac：~/.claude/settings.json
Windows：%USERPROFILE%\.claude\settings.json

方案一：对接 DeepSeek

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的_DeepSeek_API_Key",
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-chat"
  }
}

方案二：对接 MiniMax

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的_MiniMax_API_Key",
    "ANTHROPIC_BASE_URL": "https://minimax.a7m.com.cn",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M2.7-highspeed"
  }
}

💡 如果网络访问受限，可在 env 中添加代理配置（端口号请根据你本地代理软件实际端口调整）：

"HTTP_PROXY": "http://127.0.0.1:7897",
"HTTPS_PROXY": "http://127.0.0.1:7897"

📋 配置字段说明

字段	说明
`ANTHROPIC_BASE_URL`	第三方 API 的 base URL，需兼容 Anthropic 协议
`ANTHROPIC_AUTH_TOKEN`	对应平台的 API Key
`ANTHROPIC_MODEL`	指定使用的模型名称
`ANTHROPIC_DEFAULT_SONNET_MODEL`	当 model 设为 sonnet 时实际调用的模型
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`	设为 `1` 可禁用遥测等非必要流量
`HTTP_PROXY` / `HTTPS_PROXY`	HTTP/HTTPS 代理地址（如 `http://127.0.0.1:7897`）

✅ 快速检查清单

Node.js 24.14 安装完成
Git 2.54 安装完成
claude-code 全局安装成功（claude --version 验证）
PowerShell 执行策略已设置（Windows 用户）
settings.json 配置完毕，填入正确的 API Key
（可选）代理端口配置正确

📖 部署 Claude Code 完整教程