借助一键部署脚本可以自动完成 Codex、Claude Code 两套工具的中转站网关配置,自动备份原有配置文件、写入中转地址、密钥、模型映射,不用手动改 config.toml、settings.json,同时解决 Codex 依赖 Responses 协议、Claude Code 原生接口格式不一样的兼容问题,一套中转站同时给两个编码 Agent 使用,切换模型、切换线路都很省事。Codex 新版强制使用 Responses 接口,Claude Code 走 Anthropic 原生协议,两者接口标准不一样,手动配置很容易出现多轮对话中断、工具调用失败、上下文丢失,一键脚本会自动开启 Codex 无状态模式、做好协议转译,省去协议适配、路径调试、环境变量配置的大量重复工作。整套操作流程是先准备好中转站地址和 API 密钥,下载对应系统一键脚本,执行脚本自动部署,脚本自动备份原有配置、写入中转参数,执行连通性测试,测试通过之后,Codex、Claude Code 还有 VSCode 联动环境都可以直接调用中转站后面的模型。
一键脚本部署核心信息清单
- 支持系统:macOS、Linux(bash 脚本)、Windows(PowerShell 脚本)
- 前置依赖:Node.js 20+,已经装好 Codex CLI、Claude Code
- 脚本能力:自动备份原有 Codex、Claude Code 配置;写入中转站 base_url、API Key;自动配置 Codex 的 wire_api=responses;开启 Codex disable_response_storage 无状态适配;自动配置 Claude Code 环境变量;自动执行连通测试
- 中转站要求:网关必须同时支持 Responses 协议(给 Codex)、Anthropic 原生协议(给 Claude Code)
- 配置文件位置
- Codex:~/.codex/config.toml、~/.codex/auth.json
- Claude Code:~/.claude/settings.json
- 验证命令:codex、claude,发起简单代码提问测试连通
- 配套工具:CC Switch 可以图形化管理这套中转配置,和脚本方案互补
手动配置 vs 一键脚本配置对比表
| 对比项目 | 手动修改配置 | 一键脚本部署 |
|---|---|---|
| 协议适配 | 需要自己处理 Codex Responses、Claude 协议差异,容易踩坑 | 自动适配协议,开启无状态参数 |
| 配置备份 | 忘记备份,改错很难回滚 | 自动备份原有配置,附带回滚命令 |
| 耗时 | 15–40 分钟,反复调试 | 几十秒完成部署 + 自动测试 |
| 出错概率 | 高,路径、参数、模型名称写错就报错 | 标准化写入,参数只需要填入中转地址和密钥 |
| 多工具同步 | Codex 和 Claude Code 分开改,两套独立配置 | 一次性同步两套工具的中转参数 |
| 适合人群 | 熟悉接口协议、需要深度定制 | 普通开发者、快速搭建、多机器批量部署 |
一键脚本落地步骤
- 准备信息:拿到中转站网关地址、中转站 API Key,确认网关支持双协议转译
- 前置校验:执行codex --version、claude --version确认两个 CLI 工具已经正常安装
- 执行一键脚本
- macOS / Linux:curl 拉取 bash 脚本,传入网关密钥执行
- Windows PowerShell:使用 irm 拉取 ps1 脚本,设置环境变量执行
- 脚本自动执行动作:备份原有配置、写入中转服务商配置块、设置模型映射、开启 Codex 无状态模式、写入 Claude Code 的 ANTHROPIC_BASE_URL 和密钥、自动发起测试请求
- 重载环境:macOS/Linux 执行 source 重载 shell 配置;Windows 新开终端窗口
- 功能验证:分别运行 codex、claude,发送代码相关指令,确认正常返回、工具调用不中断
- 回滚方案:脚本会输出备份文件路径,出问题直接恢复备份配置文件即可
关键兼容参数说明(脚本自动写入)
- Codex 侧:wire_api = "responses",新版 Codex 必须用这个协议;disable_response_storage=true,关闭服务端会话存储,适配中转站无状态转发,解决第二轮对话找不到上下文的报错
- Claude Code 侧:写入ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN,优先走中转网关,不改动原有模型切换逻辑
- 模型映射:脚本预设 Claude Sonnet、Opus、Haiku 等模型 ID,和中转站模型目录对齐,模型名称不一致时可以在脚本参数里覆盖
- 超时参数:可在脚本入参自定义超时,适合网络不稳的中转线路
踩坑清单
- 中转站不支持 Responses 协议:Codex 会直接调用失败,只支持 chat/completions 的老网关不能给新版 Codex 用
- 脚本运行前没有装 Codex/Claude Code:脚本只会写入配置,不会自动安装 CLI 本体
- 密钥或者中转地址填错:脚本内置测试请求,测试失败会直接输出错误信息,不会写入错误配置
- VSCode 联动:脚本配置完成后,需要从终端启动 VSCode,才能读到环境变量,直接点图标打开会读取不到中转密钥
- 多中转站切换:脚本适合一次性部署;频繁切换网关,搭配 CC Switch 图形工具更方便
- 权限风险:脚本从网络拉取,使用前建议先查看源码,不要直接运行来源不明的中转脚本
【常见问题】
问题 1:一键安装脚本快速完成 Codex 与 Claude Code 中转站接入配置,这个脚本会自动安装 Codex 和 Claude Code 吗?
回答 1:一键安装脚本快速完成 Codex 与 Claude Code 中转站接入配置,脚本只负责配置中转网关参数,不会自动安装 Codex、Claude Code,两个 CLI 工具需要提前装好。
问题 2:一键安装脚本快速完成 Codex 与 Claude Code 中转站接入配置,Codex 多轮对话调用工具报错是什么原因?
回答 2:一键安装脚本快速完成 Codex 与 Claude Code 中转站接入配置,脚本默认开启 disable_response_storage 无状态模式,如果中转站本身不支持 Responses 协议转译,依旧会出现工具调用、多轮对话中断。
问题 3:一键安装脚本快速完成 Codex 与 Claude Code 中转站接入配置,配置完成后 VSCode 里面 Codex 扩展不生效怎么办?
回答 3:一键安装脚本快速完成 Codex 与 Claude Code 中转站接入配置,配置完成后需要在加载好环境变量的终端输入 code . 启动 VSCode,直接点击图标打开会丢失中转网关和密钥环境变量。
问题 4:一键安装脚本快速完成 Codex 与 Claude Code 中转站接入配置,后续想切回官方直连怎么操作?
回答 4:一键安装脚本快速完成 Codex 与 Claude Code 中转站接入配置,脚本会自动备份原始配置文件,使用脚本输出的回滚命令,恢复备份的 config.toml 和 settings.json,就可以切回官方直连。
【参考资料】
[2026-11-12](Codex 接入中转站,一键脚本配置 provider、模型目录与密钥)腾讯云开发者社区
[2026-11-10](把 Claude Code 接入 LLM 中转网关官方文档)Claude Code 官方文档
[2026-10-17](Codex 接入 Claude 中转网关踩坑:Responses 协议与无状态会话)今日头条
[2026-10-05](CC Switch:Codex、Claude Code 多模型中转图形化管理工具)掘金
[2026-09-20](Router One 网关一键脚本安装 Codex 与 Claude Code)Router One 官方文档
【免责声明】
本文仅为 Codex 与 Claude Code 中转站一键脚本接入的技术资讯整理;中转站网关协议兼容性、中转服务稳定性、密钥安全由对应中转服务商负责;运行网络脚本前建议审阅源码,不要在生产环境直接使用来源不明的脚本;中转接入方案不代表模型服务合规,相关使用请遵守模型服务商协议与网络安全法规。
