Claude 客户端配置
本页配置的是 Claude Code 终端客户端（命令行 claude）。
推荐全程用 CC-Switch 管理，无需手改配置文件。
一、安装 Claude Code
Windows PowerShell
irm https://claude.ai/install.ps1 | iex
Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash
验证
claude --version
能看到版本号即安装成功。若提示命令不存在，请重新打开终端后再试。
二、配置鹊桥（推荐：CC-Switch）
- 打开 CC-Switch
- 选择 Claude Code
- 右上角 「+」 → 自定义配置
- 填写：
| 字段 | 填写内容 |
|---|---|
| 名称 | 鹊桥（可自定义） |
| 请求地址 / Base URL | https://5202828.xyz |
| API Key / 密钥 | 控制台复制的 sk-... |
- 保存后 启用 该配置
- 新开一个终端，执行：
cd 你的项目目录
claude
提示
Claude / Anthropic 协议地址一般 不要 加 /v1。
令牌在 创建 API 令牌 获取。
更细的 CC-Switch 步骤见：配置鹊桥
三、备用：环境变量方式
不使用 CC-Switch 时，可手动设置：
Windows PowerShell（用户级永久）：
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://5202828.xyz", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-你的令牌", "User")
关闭终端重开后验证：
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_API_KEY
macOS / Linux：
echo 'export ANTHROPIC_BASE_URL="https://5202828.xyz"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="sk-你的令牌"' >> ~/.bashrc
source ~/.bashrc
使用 zsh 时，把 ~/.bashrc 换成 ~/.zshrc。
备注
不同版本 Claude Code 读取的变量名可能略有差异（如 ANTHROPIC_API_KEY / ANTHROPIC_AUTH_TOKEN）。
优先使用 CC-Switch，可少踩坑。
四、开始使用
cd 你的项目目录
claude
进入交互后随便问一句「回复 OK」，能正常返回即表示已走通鹊桥。
常见问题
| 现象 | 处理 |
|---|---|
| 命令找不到 | 重开终端；确认安装脚本写了 PATH |
| PowerShell 执行策略限制 | Set-ExecutionPolicy -Scope CurrentUser RemoteSigned |
| 401 鉴权失败 | 令牌是否完整、是否被禁用 |
| 配置不生效 | CC-Switch 是否点了启用；是否新开终端 |
| 仍走官方 | 检查 Base URL 是否为 https://5202828.xyz |
下一步：配置编辑器插件 → Claude 插件（VS Code）