Claude Code 部署指南 部署

资源	地址
官方文档	docs.claude.com

📋 前置要求

请先完成 Node.js 环境安装，确保 Node.js 18+ 已正确安装。

⚡ 首次安装必读：跳过初始化报错

使用中转渠道时，Claude Code 首次启动会出现以下报错：

Welcome to Claude Code
Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ERR_BAD_REQUEST

这是因为 Claude Code 首次启动会尝试连接官方 API 进行初始化确认，中转渠道无法通过此步骤。安装完成后、首次启动前，请先执行以下任一方法跳过：

方法一：手动修改配置文件

在用户主目录下找到 ~/.claude.json 文件，添加 "hasCompletedOnboarding": true 字段：

⚠️ 注意 JSON 格式

添加字段前，需要在上一个字段末尾补一个英文逗号，否则 JSON 格式错误会导致 Claude Code 无法启动。

{
  "installMethod": "unknown",
  "autoUpdates": true,
  "firstStartTime": "2025-07-14T06:11:03.877Z",
  "userID": "xxxx",
  "projects": {},  // 这里要加英文逗号
  "hasCompletedOnboarding": true  // 新增此字段
}

修改保存后，重新运行 claude 即可正常使用。

🚀 安装 Claude Code

🖥️ Windows 平台 🖥️ Windows

方法一：官方安装脚本 推荐

使用 PowerShell：

irm https://claude.ai/install.ps1 | iex

使用 CMD：

curl -fsSL https://claude.ai/install.cmd | cmd

方法二：npm 全局安装 备选

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

🍏 macOS 平台 🍏 macOS

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

🐧 Linux 平台 🐧 Linux

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

⌨️ 配置 CC Code 中转

方法一：环境变量配置 推荐

Windows PowerShell（当前会话）：

$env:ANTHROPIC_BASE_URL="https://ai.cccode.org"
$env:ANTHROPIC_AUTH_TOKEN="您的CC Code Key"
claude

Windows 永久配置（系统环境变量）：

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://ai.cccode.org", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "您的CC Code Key", "User")

macOS/Linux（当前会话）：

export ANTHROPIC_BASE_URL="https://ai.cccode.org"
export ANTHROPIC_AUTH_TOKEN="您的CC Code Key"
claude

macOS/Linux 永久配置（写入 ~/.zshrc 或 ~/.bashrc）：

echo 'export ANTHROPIC_BASE_URL="https://ai.cccode.org"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="您的CC Code Key"' >> ~/.zshrc
source ~/.zshrc

方法二：配置文件 备选

编辑 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.cccode.org",
    "ANTHROPIC_AUTH_TOKEN": "您的CC Code Key"
  }
}

✅ 验证配置

claude

如果进入正常的交互界面，说明配置成功。

下一步

• 使用 CodeX
• 使用 Gemini CLI
• 查看常见问题