用 CC Switch 配置归壹

CC Switch 负责管理连接配置，Claude Code 或 Codex 才是实际使用 AI 的 Agent。新手只需选其中一个 Agent；不用同时安装两个，也不用先学写代码。以下按 CC Switch 当前官方手册说明，按钮位置随版本可能略有变化。

第 1 步：下载并安装 CC Switch#

1. 1

   打开官方下载页

   前往 CC Switch 官方下载页，或 官方 GitHub Releases。两处提供相同发行文件。

2. 2

   选择自己的电脑系统

   Windows 下载对应架构的 .msi 安装包；Mac 下载 .dmg 通用包；Linux 按系统选择支持的包。不要把手机安装包当成电脑软件。

3. 3

   安装并打开

   Windows 双击安装包，按提示完成；Mac 打开 .dmg，将 CC Switch 拖入「应用程序」后打开。看到工具主界面，就可以继续。

第 2 步：在「应用」页安装一个 Agent#

1. 1

   打开「应用」

   点击 CC Switch 侧栏底部「应用」。列表会显示受管工具及安装状态。

2. 2

   安装 Claude Code 或 Codex

   找到你想用的工具，点击未安装项旁的安装按钮，按提示完成。首次建议只选一个；这里说的 Claude Code 是编程 Agent，不是 Claude Desktop。

3. 3

   确认能在侧栏看到它

   安装完成后在 CC Switch 侧栏选择这个 Agent。如果旧版本没有「应用」页，请使用当前官方版本或参考 官方安装手册；不必运行来历不明的一键配置脚本。

第 3 步：准备归壹配置#

第 4 步：添加「归壹」供应商#

1. 1

   先选 Agent，再添加

   在侧栏选择 Claude Code 或 Codex，进入「直连」，点击页头「添加供应商」（+），选择「自定义配置」。

2. 2

   填写名称、地址和密钥

   名称填写「归壹」；请求地址按上表选择；API Key 粘贴你自己的归壹密钥。不要填网站登录密码。

3. 3

   填写模型

   填入密钥可访问、支持对应协议的完整模型 ID。可以点「获取模型列表」后选择，也可按实际 ID 手动添加；Codex 的「模型映射」和默认模型设置见独立教程。

4. 4

   保存并切换

   点击页脚「添加」，回到供应商列表后，点击归壹卡片的「切换／启用」，确认它变成「使用中」。仅仅保存卡片还不等于已切换。

第 5 步：启动 Agent#

打开电脑的终端：Mac 可在「应用程序 → 实用工具」打开「终端」；Windows 可从开始菜单打开「终端」或 PowerShell。以下两条命令按你安装的 Agent 任选一条，不要把网页上的代码当成已经执行。

claude

codex

看到输入位置后，发送「你好，请用一句话介绍自己，不要读取或修改文件」。如出现首次使用提示，按屏幕说明确认；配置 Codex 后应关闭并重新打开终端再启动。Claude Code 的首次安装引导处理见独立教程。

第 6 步：确认调用确实经过归壹#

1. 1

   看 Agent 是否收到回答

   简单问候有回复，说明这次基础调用已经返回结果。

2. 2

   到归壹看日志

   打开 使用日志，按时间找到这一笔，核对模型和费用。

3. 3

   再逐步尝试任务

   先尝试空白目录中的小任务，再处理真实项目。模型列表读取成功或普通 Chat 请求成功，都不能单独证明 Agent 的工具调用、流式输出和多轮任务完整兼容。

本教程依据 CC Switch 官方快速上手 和 添加供应商手册 整理。具体模型的可用性、价格和 Agent 兼容能力，以归壹当前说明与实际调用结果为准。