Claude Code 部署指南

Anthropic 官方 AI 编程助手，支持终端内智能编码、代码分析与项目管理。

前置条件

• Node.js 18+ 运行环境（Windows 安装 | macOS 安装 | Linux 安装）
• TokenSwitch 账号及有效的 Claude Code API Key（创建 Key）

首次安装跳过引导（代理渠道必读）

通过 TokenSwitch 等代理渠道使用 Claude Code 时，首次启动会进入官方引导流程并尝试连接 Anthropic 官方服务器，导致无法正常使用。以下两种方法可跳过引导：

方法一：CC-Switch 自动配置（推荐）

使用 CC-Switch 配置工具 会自动处理引导跳过，无需手动操作。

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

在用户主目录下创建或编辑 ~/.claude.json 文件，写入以下内容：

{
  "hasCompletedOnboarding": true
}

系统	文件路径
Windows	C:\Users\<用户名>\.claude.json
macOS	/Users/<用户名>/.claude.json
Linux	/home/<用户名>/.claude.json

注意

必须在首次运行 Claude Code 之前完成此配置，否则会进入官方引导流程。

CC-Switch 快速配置（推荐）

CC-Switch 提供图形化界面，一键完成所有配置，适合大多数用户。

配置步骤

1. 下载并安装 CC-Switch 配置工具
2. 打开 CC-Switch，进入 Claude Code 标签页
3. 点击 添加服务商，填写以下信息：

配置项	值
名称	TokenSwitch（或自定义名称）
API Base URL	https://tokenswitch.cc
API Key	你的 Claude Code API Key
模型	根据需要选择（如 claude-opus-4-7）

4. 保存配置后，可通过系统托盘图标快速切换不同服务商

系统托盘快速切换

CC-Switch 安装后会常驻系统托盘，右键点击托盘图标即可在多个服务商之间一键切换，无需重新打开配置界面。

手动安装与配置

如果不使用 CC-Switch，可以手动安装 Claude Code，并写入 Claude Code 本地配置文件。

配置文件位置

Claude Code 推荐把代理配置写入 settings.json 的 env 字段，而不是只在当前 shell 中临时设置环境变量。

Windows

安装 Claude Code

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

创建配置文件

配置路径：%USERPROFILE%\.claude\settings.json

New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude"
notepad "$env:USERPROFILE\.claude\settings.json"

写入以下内容，并把 sk-xxxxxxxxxxxxxxxx 替换为你的 API Key：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://tokenswitch.cc",
    "API_TIMEOUT_MS": "600000"
  }
}

macOS

安装 Claude Code

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

创建配置文件

配置路径：~/.claude/settings.json

mkdir -p ~/.claude
nano ~/.claude/settings.json

写入以下内容，并把 sk-xxxxxxxxxxxxxxxx 替换为你的 API Key：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://tokenswitch.cc",
    "API_TIMEOUT_MS": "600000"
  }
}

Linux

安装 Claude Code

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

创建配置文件

配置路径：~/.claude/settings.json

mkdir -p ~/.claude

cat > ~/.claude/settings.json << 'EOF'
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://tokenswitch.cc",
    "API_TIMEOUT_MS": "600000"
  }
}
EOF

将示例中的 sk-xxxxxxxxxxxxxxxx 替换为你的 API Key。

配置文件说明

参数	说明	值
ANTHROPIC_AUTH_TOKEN	Claude Code 鉴权令牌	你的 API Key
ANTHROPIC_BASE_URL	Anthropic 兼容接口地址	https://tokenswitch.cc
API_TIMEOUT_MS	请求超时时间，适合长任务	600000

注意

Claude Code / Anthropic 原生 Base URL 通常不带 /v1。如果工具界面使用 ANTHROPIC_API_KEY 字段，也填写同一个 sk- API Key。

验证安装

配置完成后，在终端中运行：

claude

如果成功进入 Claude Code 交互界面，说明部署完成。

常见问题

claude: command not found

可能原因	解决方法
未正确安装	重新执行安装命令
PATH 未配置	检查 Node.js 全局 bin 目录是否在 PATH 中
终端未刷新	重启终端窗口

连接失败 / 鉴权错误

可能原因	解决方法
API Key 错误	检查 API Key 是否复制完整，无多余空格
Base URL 错误	确认 ANTHROPIC_BASE_URL 为 https://tokenswitch.cc
写到了错误文件	确认配置文件路径为 ~/.claude/settings.json 或 %USERPROFILE%\.claude\settings.json
令牌组不匹配	确认使用的是支持 Claude Code 的 API Key
余额不足	登录 TokenSwitch 控制台检查余额
未跳过引导	参考上方“首次安装跳过引导”章节

配置文件不生效

• 检查 JSON 格式是否正确（注意引号和逗号）
• 检查文件路径是否正确：~/.claude/settings.json
• 修改配置后重启 Claude Code 和终端窗口

下一步

Claude Code 部署完成！

• CC-Switch 配置工具 — 图形化管理多个服务商
• 常见问题 — 更多疑难解答