适合谁
适合已经安装或准备使用Claude Code，但不想手动维护多份环境变量和配置的新手。本文推荐通过CC Switch集中管理Provider，但前提是你使用的服务在当前控制台中明确提供了Claude Code所需的网关与认证说明。
如果控制台没有相应说明，不要强行套用Codex配置。两个客户端的协议、认证变量和最终请求路径并不相同。
开始前准备
- 打开小贺API控制台：
https://api.xiao-he.top。 - 登录后创建自己的API Key，并且不向任何人发送完整Key。
- 安装Claude Code，确认命令或桌面客户端可以正常打开。
- 从CC Switch官方渠道安装最新稳定版CC Switch。
- 确认当前控制台提供Claude Code的兼容说明，至少能核对地址来源、认证方式和模型范围。
- 准备一个不会改动重要文件的测试目录，用于第一次验证。
完整步骤
第一步：在控制台创建个人API Key
访问 https://api.xiao-he.top，注册或登录后创建自己的API Key。先记住两点：控制台入口不等于Claude Code最终需要填写的完整网关地址；Key只属于你的账户，配置或远程协助时也不应复制给他人。
第二步：确认Claude Code的当前兼容说明
在控制台中找到Claude Code或对应网关的当前说明，核对三件事：完整地址从哪里复制、认证使用什么字段、当前支持哪些模型或协议。Claude Code常见变量名可能包括 ANTHROPIC_BASE_URL，但变量名出现不代表所有服务都能互通，仍应以当前页面为准。
第三步：在CC Switch选择Claude Code并添加Provider
打开CC Switch，选择 Claude Code。不要在Codex标签页中添加后直接认为Claude Code也会读取。若控制台当前提供导入入口，可优先使用导入；否则新增Provider，并逐项填写当前界面要求的地址、认证和模型字段。
填写时只使用控制台和CC Switch当前界面提供的字段：
- Provider名称只用于自己区分，例如“我的Claude Code配置”。
- API Key粘贴到对应认证字段，不要发到截图或日志。
- 地址从当前控制台复制，不额外猜测路径后缀。
- 模型和协议由控制台和客户端说明共同决定，不使用Codex的旧值替代。
第四步：保存、切换并重启Claude Code
保存后，将该Provider设为当前Claude Code配置。完全退出Claude Code再重新打开，避免旧进程或旧环境变量仍在生效。首次验证前，不要同时修改多个变量，否则出现错误时无法判断是哪一项导致的问题。
第五步：运行一个最小任务
进入一个测试目录，先运行不会改文件的小任务，例如：
请先不要修改任何文件。
请列出当前目录的主要文件，并说明你建议先阅读哪几个文件来理解这个项目。
能返回与当前目录有关的正常结果，才是配置基本可用的证据。之后再让Claude Code做一个小改动，并自行检查改动、测试和结果。
实际示例
假设你已经在 https://api.xiao-he.top 创建了个人Key：正确做法是先登录控制台核对Claude Code的当前支持说明，再在CC Switch的Claude Code页面添加Provider，保存、切换、完全重启客户端，然后执行只读任务。
错误做法是把Codex的Provider、模型名、地址后缀或认证变量直接复制过去。即使两边都叫“API Key”，底层协议也可能不同，最终会表现为401、404、模型不存在或连接失败。
常见问题与报错
401 Unauthorized
先检查Key是否完整、是否复制到了正确认证字段、CC Switch是否已经切换到新Provider，以及Claude Code是否已完全重启。不要把完整Key贴到报错截图中求助。
404、模型不存在或接口格式不匹配
优先检查当前控制台是否明确提供Claude Code兼容网关和支持模型。404常与地址或最终请求路径有关；模型不存在通常是模型名称或权限范围不匹配。不要通过不断更换猜测值来排错。
CC Switch已切换，但Claude Code仍读取旧配置
关闭所有Claude Code进程后重开，检查旧环境变量、终端配置文件或项目级设置是否覆盖了CC Switch管理的值。每次只去掉或修改一个覆盖来源，再重复同一个最小任务。
我不会安装或配置
先准备自己的电脑和个人API Key。基础的Claude Code安装、CC Switch配置、中文设置、Skills安装与第一次小任务验证，可按当前安排申请免费远程协助；Key仍由你自己在控制台创建和输入。
完成后的检查方法
- 已在
https://api.xiao-he.top当前控制台创建个人API Key。 - 已确认当前页面有Claude Code对应的地址、认证或兼容说明。
- CC Switch当前选择Claude Code，且Provider已保存并切换。
- 没有把Codex的字段直接复制到Claude Code。
- 已完全重启Claude Code并完成一次只读最小任务。
- API Key没有出现在截图、仓库、聊天记录或公开环境变量中。
资料来源
- CC Switch使用教程
用于核对CC Switch安装与客户端选择入口。
- CC Switch：添加Provider说明
不同版本界面和字段名称可能变化，以当前界面为准。
- Claude Code：连接LLM网关
Claude Code的网关地址、认证与协议需按官方文档和服务端当前说明分别确认。
FAQ
Claude Code能直接使用Codex的Provider吗？
不能默认可以。Claude Code使用自己的协议和认证变量，必须以当前控制台的Claude Code说明和实际最小任务验证为准。
地址是否应该直接填写api.xiao-he.top？
api.xiao-he.top是小贺API控制台入口。Claude Code需要的完整地址、认证方式和模型字段，应登录控制台后按当前说明复制，不能猜固定后缀。
远程协助时需要把Key发给客服吗？
不需要。API Key应由你自己创建并在自己的客户端输入；远程协助可以指导界面位置和检查步骤，不应要求公开Key。