Claude Code 部署指南
Anthropic 官方 AI 编程助手，支持终端内智能编码、代码分析与项目管理。
💡 前置条件
- Node.js 18+ 运行环境（Windows 安装 | macOS 安装 | Linux 安装）
- TokenSwitch 账号及有效的 Claude Code 令牌（创建 Key）
首次安装跳过引导（代理渠道必读）
通过 TokenSwitch 等代理渠道使用 Claude Code 时，首次启动会进入官方引导流程并尝试连接 Anthropic 官方服务器，导致无法正常使用。以下两种方法可跳过引导：
方法一：CC-Switch 自动配置（推荐）
使用 CC-Switch 配置工具 会自动处理引导跳过，无需手动操作。
方法二：手动修改配置文件
在用户主目录下创建或编辑 ~/.claude.json 文件，写入以下内容：
json
{
"hasCompletedOnboarding": true
}| 系统 | 文件路径 |
|---|---|
| Windows | C:\Users\<用户名>\.claude.json |
| macOS | /Users/<用户名>/.claude.json |
| Linux | /home/<用户名>/.claude.json |
⚠️ 注意
必须在首次运行 Claude Code 之前完成此配置，否则会进入官方引导流程。
CC-Switch 快速配置（推荐）
CC-Switch 提供图形化界面，一键完成所有配置，适合大多数用户。
配置步骤
- 下载并安装 CC-Switch 配置工具
- 打开 CC-Switch，进入 Claude Code 标签页
- 点击 添加服务商，填写以下信息：
| 配置项 | 值 |
|---|---|
| 名称 | TokenSwitch（或自定义名称） |
| API Base URL | https://tokenswitch.cc |
| API Key | 你的 Claude Code 令牌 |
| 模型 | 根据需要选择（如 claude-sonnet-4-20250514） |
- 保存配置后，可通过系统托盘图标快速切换不同服务商
💡 系统托盘快速切换
CC-Switch 安装后会常驻系统托盘，右键点击托盘图标即可在多个服务商之间一键切换，无需重新打开配置界面。
手动安装与配置
如果不使用 CC-Switch，可以手动安装 Claude Code 并配置环境变量。
Windows
安装 Claude Code
方式一：PowerShell 原生安装（推荐）
powershell
irm https://cli.anthropic.com/install.ps1 | iex方式二：npm 安装（备选）
powershell
npm install -g @anthropic-ai/claude-code配置环境变量
临时设置（当前终端会话）：
powershell
$env:ANTHROPIC_AUTH_TOKEN = "你的TokenSwitch令牌"
$env:ANTHROPIC_BASE_URL = "https://tokenswitch.cc"永久设置（系统环境变量）：
powershell
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的TokenSwitch令牌", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://tokenswitch.cc", "User")设置完成后重启终端窗口使配置生效。
macOS
安装 Claude Code
方式一：Homebrew 安装（推荐）
bash
brew install claude-code方式二：curl 脚本安装
bash
curl -fsSL https://cli.anthropic.com/install.sh | sh方式三：npm 安装（备选）
bash
npm install -g @anthropic-ai/claude-code配置环境变量
编辑 ~/.zshrc（或 ~/.bashrc），添加以下内容：
bash
export ANTHROPIC_AUTH_TOKEN="你的TokenSwitch令牌"
export ANTHROPIC_BASE_URL="https://tokenswitch.cc"使配置生效：
bash
source ~/.zshrcLinux
安装 Claude Code
方式一：curl 脚本安装（推荐）
bash
curl -fsSL https://cli.anthropic.com/install.sh | sh方式二：npm 安装（备选）
bash
npm install -g @anthropic-ai/claude-code配置环境变量
编辑 ~/.bashrc（或 ~/.zshrc），添加以下内容：
bash
export ANTHROPIC_AUTH_TOKEN="你的TokenSwitch令牌"
export ANTHROPIC_BASE_URL="https://tokenswitch.cc"使配置生效：
bash
source ~/.bashrc验证安装
配置完成后，在终端中运行：
bash
claude如果成功进入 Claude Code 交互界面，说明部署完成。
常见问题
claude: command not found
| 可能原因 | 解决方法 |
|---|---|
| 未正确安装 | 重新执行安装命令 |
| PATH 未配置 | 检查 Node.js 全局 bin 目录是否在 PATH 中 |
| 终端未刷新 | 重启终端窗口或执行 source ~/.zshrc |
连接失败 / 鉴权错误
| 可能原因 | 解决方法 |
|---|---|
| API Key 错误 | 检查令牌是否复制完整，无多余空格 |
| Base URL 错误 | 确认 ANTHROPIC_BASE_URL 为 https://tokenswitch.cc |
| 令牌组不匹配 | 确认使用的是 Claude Code 专用令牌组 |
| 余额不足 | 登录 TokenSwitch 控制台检查余额 |
| 未跳过引导 | 参考上方"首次安装跳过引导"章节 |
环境变量不生效
- Windows：重启终端窗口，或重启电脑
- macOS/Linux：执行
source ~/.zshrc或source ~/.bashrc - 使用
echo $ANTHROPIC_BASE_URL验证变量是否已设置
下一步
✅ Claude Code 部署完成！
- CC-Switch 配置工具 — 图形化管理多个服务商
- 常见问题 — 更多疑难解答