CC Switch 完全新手教程：注册、安装、配置，5 分钟接入 ClaudeAPI.com
如果你刚接触 Claude Code，想用 ClaudeAPI.com 接入，但又不知道怎么改配置文件——这篇教程就是为你准备的。
CC Switch 是目前 GitHub 上最流行的 Claude Code 配置管理工具（⭐ 68K+），它用可视化界面彻底代替手动编辑 JSON/TOML 配置文件，让你一键切换 API 提供商。本文将一步一步带你完成从注册到实际调用的全流程。
CC Switch 是什么？
CC Switch 是一款跨平台桌面应用（Windows / macOS / Linux），用来统一管理 Claude Code、Codex、Gemini CLI 等 AI 编程工具的 API 配置。
一句话总结：你不需要再手动找
settings.json在哪里、不需要记环境变量怎么写。打开 CC Switch，填入 API Key，点一下"激活"，搞定。
核心功能一览：
| 功能 | 说明 |
|---|---|
| 可视化 Provider 管理 | 填表单替代手改 JSON |
| 一键切换 | 托盘菜单直接切，无需重启终端 |
| 内置 50+ 预设 | 主流 API 平台开箱即用 |
| MCP 统一管理 | 跨工具同步 MCP 服务配置 |
| 连接速度测试 | 自动测延迟，帮你选最快线路 |
| 云端同步 | 支持 Dropbox / OneDrive / iCloud |
准备工作：先安装 Claude Code
CC Switch 是 Claude Code 的配置管理器，所以你需要先把 Claude Code 本体装好。
Windows（PowerShell）：
irm https://claude.ai/install.ps1 | iex
irm https://claude.ai/install.ps1 | iex
macOS / Linux：
curl -fsSL https://claude.ai/install.sh | bash
curl -fsSL https://claude.ai/install.sh | bash
安装完成后验证：
claude --version
claude --version
看到版本号就说明 Claude Code 已就绪。
不想用命令行？也可以下载 Claude Code 桌面版（支持 Windows / macOS）。
第一步：注册 ClaudeAPI.com，获取 API Key
-
访问 claudeapi.com，点击注册
-
完成邮箱验证后，进入控制台
-
在 API Keys 页面点击「创建新密钥」
-
复制你的 API Key（只显示一次，请立即保存）
ClaudeAPI.com 可用模型参考：
| 模型 | 模型 ID | 输入价格 | 推荐场景 |
|---|---|---|---|
| Claude Opus 4.7 | claude-opus-4-7 |
$4.000/1M | 复杂推理、长上下文 |
| Claude Opus 4.6 | claude-opus-4-6 |
$4.000/1M | 复杂推理、长上下文 |
| Claude Sonnet 4.6 | claude-sonnet-4-6 |
$2.400/1M | 日常开发（默认推荐） |
| Claude Haiku 4.5 | claude-haiku-4-5-20251001 |
$0.800/1M | 轻量快速任务 |
第二步：下载安装 CC Switch
官方仓库： github.com/farion1231/cc-switch
官方网站： ccswitch.io
下载页面（含所有版本）： github.com/farion1231/cc-switch/releases
Windows
| 文件 | 说明 |
|---|---|
CC-Switch-v{版本}-Windows.msi |
推荐 - 支持自动更新的 MSI 安装包 |
CC-Switch-v{版本}-Windows-Portable.zip |
便携版，解压即用，不写注册表 |
系统要求：Windows 10 及以上（x64）
macOS
方式一：Homebrew（推荐）
brew tap farion1231/ccswitch
brew install --cask cc-switch
brew tap farion1231/ccswitch
brew install --cask cc-switch
方式二：手动下载
| 文件 | 说明 |
|---|---|
CC-Switch-v{版本}-macOS.dmg |
推荐 - 拖入 Applications 即完成 |
CC-Switch-v{版本}-macOS.zip |
ZIP 压缩包 |
系统要求：macOS 12（Monterey）及以上
CC Switch for macOS 已通过 Apple 代码签名和公证，直接打开无需额外操作。
Linux
| 发行版 | 推荐格式 | 安装命令 |
|---|---|---|
| Ubuntu / Debian | .deb |
sudo apt install ./CC-Switch-*.deb |
| Fedora / RHEL | .rpm |
sudo dnf install ./CC-Switch-*.rpm |
| Arch Linux | .AppImage |
chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage |
| 其他发行版 | .AppImage |
同上 |
第三步：在 CC Switch 中创建 ClaudeAPI.com Provider
安装完成后打开 CC Switch，按如下步骤操作：
填写以下配置信息：
配置模型映射
在模型设置区域填入：
| 字段 | 推荐值 |
|---|---|
| 默认主模型 | claude-sonnet-4-6 |
| 默认 Opus 模型 | claude-opus-4-7 |
| 默认 Sonnet 模型 | claude-sonnet-4-6 |
| 默认 Haiku 模型 | claude-haiku-4-5-20251001 |
5. 点击「Save」保存
第四步：激活并测试调用
激活 Provider
在 Provider 列表中找到刚创建的「ClaudeAPI」，点击「Activate」（或「Enable」）。
CC Switch 会自动将 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 写入 ~/.claude/settings.json，无需手动操作。
测试连接
CC Switch 内置了连接速度测试功能：
- 在 Provider 旁边点击「Test」
- 等待延迟测试完成
- 看到绿色状态指示灯 = 连接成功
验证 Claude Code 已生效
打开终端，输入：
claude
claude
如果 Claude Code 正常启动并能响应，说明一切配置成功。
你也可以用 Claude Code 的 /model 命令检查当前使用的模型：
/model
/model
第五步：日常使用与高级配置
从系统托盘快速切换
CC Switch 安装后会常驻系统托盘。如果你有多个 Provider（比如一个用 ClaudeAPI.com、一个用官方 Anthropic），可以右键托盘图标直接切换，不需要打开主界面。
在 Claude Code 会话中切换模型
进入 Claude Code 后，使用 /model 命令可以在会话内切换模型：
/model
/model
这会打开交互式选择菜单，无需退出重启。
创建多个 Provider 场景示例
很多用户会配置多个 Provider 用于不同场景：
| Provider 名称 | 用途 |
|---|---|
ClaudeAPI-Sonnet |
日常编码（性价比最优） |
ClaudeAPI-Opus |
复杂推理、架构分析 |
ClaudeAPI-Haiku |
批量任务、快速响应 |
配置方式相同，只需在模型映射中指定不同的默认主模型即可。
常见问题
Q：切换 Provider 后 Claude Code 没有生效？
切换后需要重启终端（或在 Claude Code 内输入 /exit 退出再重新运行 claude）。如果使用 CC Switch 的本地代理功能，则支持热切换无需重启。
Q：ANTHROPIC_BASE_URL 填错了会怎样？
Claude Code 会返回 401 或连接错误。请确认填写的是 https://gw.claudeapi.com（注意是 gw 前缀，不是 api）。
Q：API Key 忘记保存了怎么办？
登录 claudeapi.com 控制台，在 API Keys 页面创建一个新的密钥，旧密钥可以直接作废。
Q：CC Switch 会保存我的 API Key 吗？安全吗？
CC Switch 将数据存储在本地 SQLite 数据库（~/.cc-switch/cc-switch.db）中，不上传至任何服务器。开启云同步功能时，密钥会同步到你自己配置的云盘（Dropbox / OneDrive / iCloud / WebDAV），平台本身不持有你的密钥。
小结
完成以上步骤后，你的工作流就是：
- ClaudeAPI.com 提供 API 额度和模型访问能力
- CC Switch 管理配置，告别手动改文件
- Claude Code 作为你的 AI 编程助手正常工作
整个流程 5 分钟以内。有了 CC Switch，多个 Provider 之间的切换只需点一下，彻底解放双手。
如果在配置过程中遇到问题，欢迎加入 ClaudeAPI.com 用户社区 提问，也可以参考 CC Switch 官方仓库的 Issues 页面。
相关阅读：
