最快 3 步完成 Claude Code 配置 | 无需代理 | 延迟 < 200ms | 支持支付宝/微信充值
快速开始：3 步自动接入（推荐）
已有 ClaudeAPI.com 账号？按以下步骤操作，2 分钟完成全部配置。
Step 1：安装工具CC Switch
cc-switch 提供可视化 Web 管理界面，比命令行更直观，尤其适合首次添加配置或更换 API Key 时使用
下载链接：https://github.com/farion1231/cc-switch/blob/main/README_ZH.md
Step 2：ClaudeAPI.com 后台一键导入配置
进入 claudeapi.com 后台，在 API 密钥页面按需创建密钥，设置令牌名称、余额和访问限制。
在 API 密钥处点击使用方法 “CC Switch”，自动将配置导入 cc-switch：
在 CC Switch 中确认导入供应商配置是否正确，点击导入：
即可看到从 ClaudeAPI 导入的配置项：
Step 3：启动 Claude Code
cc-switch use default && claude
cc-switch use default && claude
完成！ 你现在拥有高可用接入支持人民币充值的 Claude Code 环境。
测试：
点击“测试模型”，显示“运行正常”，则API密钥一键配置成功，查看用量。
需要命令行方式配置，或想了解 Web 界面手动添加？见下方详细配置。
cc-switch 管理详细配置
前置条件
- Node.js 18+ 已安装
- 已有 ClaudeAPI.com 的 API Key（没有的话访问 claudeapi.com 注册获取）
三步概览
| 步骤 | 做什么 | 命令 |
|---|---|---|
| Step 1 | 安装 cc-switch 和 Claude Code | npm install -g @hobeeliu/cc-switch @anthropic-ai/claude-code |
| Step 2 | 填入 Key 和接入地址，完成初始化 | cc-switch init |
| Step 3 | 切换配置，启动 Claude Code | cc-switch use default && claude |
cc-switch 提供可视化 Web 管理界面，比命令行更直观，尤其适合首次添加配置或更换 API Key 时使用。
cc-switch web
cc-switch web
浏览器会自动打开 cc-switch 界面，显示当前所有配置和状态。
添加配置： 点右上角橙色「+」按钮 → 选「自定义配置」→ 填写三项：
| 字段 | 填写内容 |
|---|---|
| 供应商名称 | ClaudeAPI.com（方便识别，随意填） |
| API Key | 你的 sk-... Key |
| 请求地址 | https://gw.claudeapi.com（末尾不要加斜杠） |
填完保存，回到主界面就能看到新配置。高级选项（代理、计费等）保持默认即可。
原理：cc-switch 做了什么？
Claude Code 从 ~/.claude/settings.json 的 env 字段读取 API 配置：
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "你的Key",
"ANTHROPIC_BASE_URL": "https://gw.claudeapi.com"
}
}
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "你的Key",
"ANTHROPIC_BASE_URL": "https://gw.claudeapi.com"
}
}
执行 cc-switch use 时，cc-switch 自动把对应配置写入这个文件。切换即时生效，无需重启 Claude Code。
更换 API Key
Key 到期或换新 Key 时，在 Web 界面里点编辑图标修改，更新后点击保存和启用，确认新 Key 生效。
常用命令速查
| 命令 | 说明 |
|---|---|
cc-switch init |
首次初始化，创建 default 配置 |
cc-switch list |
列出所有已保存的配置（* 标记当前激活） |
cc-switch current |
显示当前激活的配置名 |
cc-switch use <name> |
切换到指定配置，立即生效 |
cc-switch view <name> |
查看指定配置的详细内容 |
cc-switch new <name> -i |
交互式创建新配置 |
cc-switch test -c |
测试当前配置的 API 连通性（推荐） |
cc-switch test --all |
批量测试所有配置 |
cc-switch edit <name> --field env.ANTHROPIC_AUTH_TOKEN |
更换指定配置的 API Key |
cc-switch edit -c |
编辑当前激活配置（打开编辑器） |
cc-switch import <file> |
从备份文件恢复配置 |
cc-switch web |
启动可视化 Web 管理界面 |
cc-switch update |
检查并更新 cc-switch 到最新版本 |
cc-switch rm <name> |
删除指定配置 |
cc-switch cp <src> <dst> |
复制配置 |
cc-switch --version |
查看 cc-switch 版本 |
常见问题
Q：cc-switch use 之后 Claude Code 需要重启吗？
不需要。cc-switch use 直接修改 settings.json，Claude Code 下次 API 调用时自动读取新配置。
Q：settings.json 在哪里？
Windows: C:\Users\<用户名>\.claude\settings.json
macOS/Linux: ~/.claude/settings.json
Windows: C:\Users\<用户名>\.claude\settings.json
macOS/Linux: ~/.claude/settings.json
Q：cc-switch 支持 OpenAI 格式吗？
cc-switch 专为 Claude Code 设计，管理的是 Claude Code 的 settings.json。如果你需要 OpenAI 兼容格式，ClaudeAPI.com 同时支持，兼容地址为 https://gw.claudeapi.com/v1。
Q：如何确认当前在用哪个配置？
cc-switch current
# 输出示例：Current configuration: default
cc-switch current
# 输出示例：Current configuration: default
为什么选择 ClaudeAPI.com
| 对比项 | api.anthropic.com | ClaudeAPI.com |
|---|---|---|
| 境内访问稳定性 | 需要自行解决网络问题 | 境内可直接访问 |
| 平均延迟 | 视网络情况而定 | < 200ms |
| Claude Code 兼容性 | 原生支持 | 100% 兼容，格式相同 |
| cc-switch 支持 | 支持 | 支持（推荐默认配置） |
| 支付方式 | 需境外信用卡 | 支付宝 / 微信 / 人民币 |
总结
cc-switch 是 Claude Code 多配置管理的核心工具，配合 ClaudeAPI.com 接入点：
- 一次初始化，永久生效
- 多配置并存，一条命令切换
- settings.json 自动管理，无需手动修改
- cc-switch test 一键验证连通性
