本地同时装了 Claude Code 和 Codex 的人大概率会碰到同一个问题默认配置只能跑官方模型想临时切到 DeepSeek 或者通义千问就得去翻配置文件、改环境变量、重启终端稍不注意还会把原本能用的配置弄坏。这篇文章要把“给 Claude Code 和 Codex 配置三家不同模型提供方”这件事讲清楚。这里的三家我按最常见需求理解为 Anthropic 官方、OpenAI 官方、DeepSeek 或千问这类兼容模型再配合社区常用的 cc-switch 切换器实现点一下就能切换的效果。适合的读者是已经装过 Node.js、跑过命令行工具但对配置机制不熟悉的人。这类场景最值得关注的不是安装命令而是三件事配置到底写在哪里、切换器到底做了什么、切完之后怎么验证。把这三条线串起来后面换任何模型都不会慌。1. 先搞清楚配置写在哪里再谈一键切换1.1 Claude Code 的配置入口settings.json 和 envClaude Code 的配置分好几层包括项目级配置、用户级配置、环境变量。对模型接入来说最常用的是用户级配置文件~/.claude/settings.json。这个文件里有一个env字段用来设置环境变量Claude Code 在启动时会读取这些变量决定请求发到哪里、用哪个模型、带哪个密钥。和模型接入直接相关的变量有三个ANTHROPIC_BASE_URL控制接口地址ANTHROPIC_AUTH_TOKEN或ANTHROPIC_API_KEY控制鉴权ANTHROPIC_MODEL控制主模型名称。还有一个ANTHROPIC_SMALL_FAST_MODEL负责后台快速任务比如生成标题、压缩上下文这类轻量操作。所以所谓“给 Claude Code 切换模型提供方”本质上就是改这几个环境变量。你可以在 shell 里用 export 临时导出但那样换一个终端就失效不适合长期维护。我更建议直接写在配置文件的env里方便切换器统一管理。一个典型的官方配置长这样{ env: { ANTHROPIC_MODEL: claude-sonnet-4-20250514, ANTHROPIC_SMALL_FAST_MODEL: claude-haiku-4-20250514, ANTHROPIC_BASE_URL: https://api.anthropic.com, ANTHROPIC_AUTH_TOKEN: 这里放你的 API Key } }注意实际能用的 model id 要以你账户里开通的模型为准。不同地区、不同账号等级能看到的模型不完全一样网上文章给的 model id 不一定在你的环境里可用。1.2 Codex 的配置入口config.toml 和 model_providersOpenAI Codex 的配置入口是~/.codex/config.toml。这个文件是 TOML 格式里面可以定义多个model_providers每个 provider 都有自己的base_url、env_key、wire_api。和 Claude Code 把环境变量都塞进 JSON 的方式相比Codex 结构上更接近“多供应商”设计。一个官方 OpenAI 配置示例model gpt-5 model_provider openai [model_providers.openai] name OpenAI base_url https://api.openai.com/v1 env_key OPENAI_API_KEY wire_api responses你需要理解wire_api这个字段。它说的是用哪种 API 协议格式去请求模型。OpenAI 官方新模型常用responses协议而很多第三方兼容服务只支持chat协议。如果写错了会出现请求发出去但模型不认的情况报错类型还不是一眼能看出来的那种。1.3 为什么需要专门的切换器手动改文件当然能跑但两个 CLI 的配置格式不一样一个 JSON一个 TOML每次换模型都要处理路径、格式、Key 前缀非常容易漏。cc-switch 这类工具做的事情就是把两套配置文件抽象成一份“供应商列表”你点一下某个供应商它帮你重写对应 CLI 的配置文件。理解这一点很重要。切换器不是魔法它只是改文件的工具。如果它写错了位置或者版本不匹配最终排查时你还是要回到 settings.json 和 config.toml 本身。所以别把切换器当成黑盒要能看懂它改了什么。2. 环境准备三个提供方的 API Key 和 CLI 前置条件2.1 Node.js 环境检查Claude Code 和 Codex 都是基于 Node.js 的命令行工具所以电脑上必须先有 Node.js。安装完成后先在终端里确认版本node -v npm -v如果提示找不到命令说明 Node.js 没装好或者没有加入系统 PATH。Windows 环境经常遇到装完后新开的终端才生效macOS 和 Linux 则要确认 nvm 或 Homebrew 的路径没问题。这里不要急着继续。node 和 npm 能正常输出版本后面才有意义。很多模型配置错误的根源其实是本机 Node.js 环境太旧导致 CLI 安装不完整。2.2 安装 Claude Code 和 Codex CLI用 npm 全局安装是目前最直接的路径npm install -g anthropic-ai/claude-code npm install -g openai/codex装完检查版本claude --version codex --version如果你之前装过旧版本建议先卸载再重装避免命令被旧包占用。有些系统上codex会被其他软件占用重装时注意看 npm 提示的输出路径确认最终调用的是openai/codex这个包。2.3 三个模型提供方的 API Key 从哪里来不要在配置阶段混用密钥。不同平台的 Key 前缀、鉴权头、请求地址都不一样混用最常见的现象是 401 或 403。模型提供方获取位置Key 通常特征常见模型标识示例Anthropic 官方Anthropic Consolesk-ant- 开头claude-sonnet-4-20250514OpenAI 官方OpenAI Platformsk- 开头gpt-5、gpt-5-codexDeepSeekDeepSeek 开放平台sk- 开头deepseek-chat、deepseek-reasoner阿里云百炼千问阿里云百炼控制台sk- 开头qwen3-coder、qwen-max以当前常见情况来说Anthropic 官方 Key 适合配给 Claude CodeOpenAI 官方 Key 适合配给 CodexDeepSeek 和千问的 Key 则用来接入 Codex 的兼容 provider。如果你要把千问这类 OpenAI 兼容服务配给 Claude Code要额外确认它是否提供 Anthropic 协议兼容端点否则直接配会出现协议错误这不是参数大小问题是协议不匹配。3. 先把单条链路跑通官方模型优先3.1 Claude Code 连接 Anthropic 官方建议先把 Claude Code 配回 Anthropic 官方确保基础链路是通的。编辑~/.claude/settings.json时先把ANTHROPIC_MODEL、ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN填好保存后重新打开终端。验证命令可以直接用非交互模式claude -p 只回复两个字正常如果能看到回复说明 base_url、Key、模型名三样都没问题。如果报认证错误先确认 Key 有没有复制全、有没有多余空格、是不是当前账号可用的 Key。如果报模型不存在再确认 model id 是否和账户开通的一致。3.2 Codex 连接 OpenAI 官方Codex 首次运行会引导登录。想用 API Key 模式可以把OPENAI_API_KEY写进环境变量或者在~/.codex/config.toml里配置好 provider然后确保当前model_provider指向openai。验证命令codex exec 只回复两个字正常Codex 的exec子命令适合做单次验证不进入交互界面。跑通之后再考虑切换到 DeepSeek 或千问。3.3 验证时怎么判断“真的生效”不要只看 CLI 能不能启动要看它实际请求的模型是谁。最直接的判断方式是发一条消息后看返回内容是否正常以及是否出现模型标识信息。验证顺序建议固定成三步命令能正常返回内容说明 base_url、API Key、模型名三者匹配。如果返回 401/403优先怀疑 Key 和鉴权头。如果返回 model not found优先怀疑模型 id 或该模型在端点下不可用。注意这一步只用一条最简单的话来验证。不要一上来就丢一个复杂仓库进去否则模型报错时你很难分清是配置问题还是任务本身问题。4. 用 cc-switch 把三个供应商做成一个可切换列表4.1 cc-switch 到底做了什么cc-switch 是社区常用的配置切换工具支持 Claude Code 和 Codex 两套 CLI。它本身不提供模型也不代理请求只负责把不同供应商的配置写入对应的 CLI 配置文件中。有图形界面版也有命令行版具体安装方式以仓库 README 为准。一般从 GitHub Releases 下载对应系统的安装包安装后启动能看到一个供应商列表界面。我建议你在使用前先备份配置文件cp ~/.claude/settings.json ~/.claude/settings.json.bak cp ~/.codex/config.toml ~/.codex/config.toml.bak备份这一个动作能省下很多手动恢复时间。4.2 在切换器里添加三家模型配置不同版本界面字段会有些差异但核心字段基本一致供应商名称、Base URL、API Key、模型 ID。下面是一份常用配置参考供应商名称目标 CLIBase URL模型 ID用途Claude OfficialClaude Codehttps://api.anthropic.comclaude-sonnet-4-20250514主力重构、长任务OpenAI OfficialCodexhttps://api.openai.com/v1gpt-5仓库级理解、测试生成DeepSeekCodexhttps://api.deepseek.com/v1deepseek-chat日常低成本问答QwenCodexhttps://dashscope.aliyuncs.com/compatible-mode/v1qwen3-coder批量小任务、命名、翻译添加后保存。注意你在切换器里看到的字段名可能是api_base、api_key、model_name也可能是base_url、apiKey意思都一样。4.3 切换之后要做什么点击切换后并不代表当前正在运行的 CLI 会立即感知。你需要做三件事手动打开配置文件确认 base_url、key、model 字段真的变了。完全退出当前终端或 CLI 进程重新打开。用一条简单 exec 命令验证。如果打开配置文件发现内容没变说明切换器写到了别的路径或者当前用户目录和你预期的不一致。这时候不要反复点切换按钮先查路径。4.4 不想用图形界面时怎么管理如果你更习惯命令行和文本编辑可以不用切换器直接维护一份自己的配置模板。把常用的三个供应商写成三段配置片段切换时注释掉不需要的取消注释要用的。这种做法适合对配置文件已经熟悉的人缺点是手动过程容易出错适合作为切换器的补充而不是替代。5. 三家模型怎么选能力边界和参数差异5.1 Anthropic 官方 Claude适合重活Anthropic 官方模型在长上下文、复杂重构、多文件理解方面表现稳定。Claude Code 默认的 agent 行为也比较保守适合逐步推进任务。代价是成本相对高配额限制更严格。用 Claude 官方模型时不要一开始就把 max_tokens 调到极大值。先让模型完成第一轮分析再根据上下文需要决定是否增加输出上限。很多时候任务卡住不是因为模型能力不够而是单次输出上限被设得太小导致回答被截断。5.2 OpenAI Codex适合仓库级任务Codex 官方模型和代码仓库的关联能力比较强适合让它在整个仓库里搜索、定位、生成测试。注意wire_apiOpenAI 官方模型可能走responses第三方服务一般走chat。这个字段如果不匹配请求会失败而且错误信息不一定直观。如果你发现“cc switch local proxy failed while handling codex endpoint /responses”这类报错大概率是切换器通过本地代理去处理 Codex 的/responses请求时目标端点不支持 responses 协议。优先方案是把该 provider 的wire_api改成chat或者改用支持 responses 协议的模型端点。5.3 DeepSeek 和千问适合低成本高频任务DeepSeek 和千问这类模型接入 Codex 后能覆盖不少日常场景代码翻译、补注释、写测试用例、生成提交信息、修小 bug。成本低速度也快适合高频调用。但它们和官方模型的 agent 能力有差距尤其是复杂工具调用时可能会出现“模型理解了指令但没有按结构化格式返回工具调用”的情况。这时候不要急着换模型先降低任务复杂程度例如让模型先输出分析再执行修改分两步完成。5.4 兼容接口的关键参数怎么调参数含义建议model模型 ID以服务商控制台为准大小写敏感base_urlAPI 地址不要多写斜杠注意协议 http/httpsenv_key读哪一个环境变量的 Key和实际导出的变量名一致wire_api用 responses 还是 chat 协议官方优先 responses三方兼容优先 chat超时时间单次请求等待时长低配置网络下加到 120 秒再测一个稳定做法是先给三个 provider 都配上但默认只启用一个。跑通一个再切下一个避免三个配置同时出问题时不知道从哪里排查。6. 常见报错和排查顺序6.1 401 / 403 认证失败先确认 Key 属于哪个平台是不是复制进了错误的配置里。Anthropic 的 Key 开头通常带 sk-antOpenAI 和 DeepSeek 的 Key 格式接近但服务端不通用。再看 Key 末尾有没有换行或空格这个最容易忽略。还要区分“账号未开通”和“Key 无效”。如果你遇到类似 “Claude is not available to new users right now” 的提示那是账号准入层面的问题不是配置文件写错。先去控制台确认账号能正常登录、能创建 Key再回来排查 CLI。6.2 model not found / 404模型 ID 写错是最常见原因。有些模型 ID 带日期后缀有些带版本号漏一段就会 404。服务商控制台通常会显示当前账号可用的模型列表以那个列表为准。不要在多个教程之间复制 model id尤其不要混用不同服务商的模型名。6.3 切换之后不生效按顺序检查配置文件路径是否正确是不是用户级和项目级配置冲突。CLI 有没有完全退出重开。切换器写入的是否是当前 shell 用户对应的目录。系统环境变量里有没有残留的ANTHROPIC_BASE_URL或OPENAI_API_KEY这类全局变量优先级往往高于配置文件。6.4 网络超时和连接失败先确认本机到 API 域名的连通性curl -I https://api.anthropic.com curl -I https://api.openai.com如果 curl 能通但 CLI 超时检查终端里有没有设置HTTP_PROXY、HTTPS_PROXY、ALL_PROXY这类环境变量。很多网络领域的“奇怪问题”其实是这些代理变量在干扰请求。公司网络和本机防火墙也属于这一类要先确认基础连通性不要急着怀疑模型参数。6.5 单条对话正常但 agent 工具调用失败这种情况常见于第三方兼容模型。模型能正常对话但需要以特定 JSON 结构返回工具调用时它可能没有按格式返回。解决方式是换用官方模型或者把任务拆细减少一次调用里要求模型同时完成的动作。如果切换器本身报了本地代理相关错误先看它的日志确认是哪个 endpoint 失败再回到 provider 的协议配置里去查。很多切换器报错不是坏在“切换”这一步而是切换后目标端点不兼容。我个人更建议先把 Claude 官方和 OpenAI 官方这两条链路跑稳再配 DeepSeek 和千问。多模型配置最怕的不是模型不够用而是配置文件里堆了太多失效地址和旧 Key。真正落地时值得花时间维护一张简单的清单记录每个供应商的名称、Base URL、模型 ID、Key 前缀和接入的 CLI。这样无论切到哪一家都能快速定位问题。配置切换不是魔法它只是帮你把正确的参数放到了正确的位置。