用 CC Switch 配置 Claude Code
选择 Messages 原生协议，填好归壹地址、密钥和模型，再启动 Claude Code。
这篇针对 Claude Code Agent，不是 Claude Desktop。先按 CC Switch 安装教程 在「应用」页安装 Claude Code，再回到侧栏开始配置。
先确认模型支持 Messages#
Claude Code 原生使用 Anthropic Messages。选择归壹中明确支持此协议和工具调用的模型，确认当前密钥分组有权限、余额与密钥额度可用。只有 OpenAI Chat Completions 可用的模型，不适用下面的原生直连步骤。
第 1 步：添加归壹供应商#
- 1
选中 Claude Code
在 CC Switch 左侧选择「Claude Code」（部分版本可能简写「Claude」），进入「直连」。
- 2
添加自定义配置
点击页头「添加供应商」（+），选择「自定义配置」。按下面的表填写。
| 字段 / 设置 | 填写什么 |
|---|---|
| 名称 | 归壹 · Claude Code |
| 请求地址 / Base URL | https://univto.com |
| API Key | YOUR_GUIYI_API_KEY（占位文字，替换成你自己的归壹 API 密钥） |
| 模型 / 默认模型 | 归壹实际开放、支持 Messages 的完整模型 ID |
| 上游格式（如果显示） | Anthropic Messages（原生） |
https://univto.com模型可通过「获取模型列表」选择，也可按完整 ID 手动填写。如果表单提供主模型、快速模型或角色映射，只选择当前归壹明确支持的型号，不要把显示昵称当成实际模型 ID。
第 2 步：保存并切换#
- 1
添加供应商
点击页脚「添加」。
- 2
切换到归壹
返回列表后，点击归壹卡片的「切换／启用」，确认显示「使用中」。Claude Code 当前支持配置热重载；首次配置建议开一个新会话。
第 3 步：启动并问一句话#
在电脑终端中进入一个空白测试目录，再输入下面的启动命令。第一次先不让 Agent 编辑文件或运行命令。
claude你好，请用一句话介绍自己，不要读取或修改文件。第 4 步：到归壹核对日志#
收到回复后，打开 归壹使用日志，按时间核对模型和扣费。之后可在测试目录里逐步验证工具读取、流式输出与多轮任务；模型列表成功或一次普通 Chat 回复，都不能替代完整 Agent 验收。
| 遇到的情况 | 先检查 |
|---|---|
| 401 / 密钥无效 | 是否粘贴完整归壹 API Key，密钥是否过期或停用 |
| 404 / 路径错误 | 基础地址应为 https://univto.com，不要重复 /v1 或填完整 /messages |
| 有回复，但工具任务报错 | 模型与线路是否支持 Messages 的工具调用、流式输出及对应参数 |
| 切换后仍像在用旧配置 | 归壹卡片是否显示「使用中」；退出当前会话后重新启动 |
操作名称依据 CC Switch 官方快速上手 与 添加供应商手册。模型支持情况以归壹当前说明及实际调用结果为准。