拓冰网站定制 
CC Switch 本地路由Codex 接入 Claude 网关【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch适用场景与解决路径面向持有 Claude 网关密钥仅开放/v1/messages端点、希望用 Codex 运行 Claude 模型的开发者。阻塞点新版 Codex 只讲 OpenAI Responses API直连 Anthropic Messages 端点只能得到 404。解决路径CC Switch 本地路由接管 Codex完成两种协议的请求与响应互转让 Codex 接入 Claude 网关。请求在 Codex、本地路由与上游之间如何流转Codex CLI │ Responses 请求wire_api responses ▼ 本地路由 127.0.0.1:15721/v1CC Switch │ 端点重写为 /v1/messages请求体转为 Anthropic Messages ▼ 上游网关 /v1/messages ▲ Anthropic JSON / SSE │ 转回 Responses JSON / SSE含推理、工具调用、图片 ▲ Codex CLI转换实现位于 transform_codex_anthropic.rs方向与transform_responses.rs互为镜像调用入口在 forwarder.rs 的codex_responses_to_anthropic分支。环境与版本要求项目要求说明CC Switch3.17.0 或更高Anthropic Messages 上游支持自 3.17.0 引入Codex CLI已安装并至少运行过一次保证~/.codex/目录结构存在API 密钥可访问/v1/messages端点来自 Claude 家族中转网关或企业 Claude 网关标注仅限 Claude Code的密钥经由 Codex 调用可能报错模型 id网关文档中可识别的 Claude 模型名如claude-sonnet-5模型映射行同样以网关文档为准供应商表单、路由开关与生效验证表单字段怎么填Codex 页签没有内置 Anthropic 预设新增供应商时保持Custom Configuration填写以下字段Provider Name任意名称。API Key网关密钥。密钥只保存在 CC Switch转发时由本地路由注入Codex 的 live 配置auth.json中只有占位符。API Request URL只填服务根地址如https://claude-gateway.example.com带不带尾部/v1均可不要自行拼/v1/messages网关文档给的是完整 messages URL 时打开Full URL开关原样粘贴。Default Model网关可识别的模型 id。上游格式在哪里切换展开Advanced Options把Upstream Format从Responses (native)改为Anthropic Messages (routing required)随后出现三个配套字段Auth field决定密钥以哪种请求头注入上游两者只发其一。默认ANTHROPIC_AUTH_TOKEN (Authorization)发送Authorization: Bearer key部分遵循 Anthropic 原生头约定的网关要求ANTHROPIC_API_KEY (x-api-key)。选错通常表现为 401 / 403。Emulate Claude Code client默认关闭。开启后仿造 User-Agent、anthropic-beta、x-app请求头并在系统提示第一行注入 Claude Code 身份标识——对应 forwarder.rs 中codex_impersonate_claude_code为真时调用prepend_claude_code_system_prompt改写请求体。Max output tokensAnthropic 协议要求max_tokens必填。路由在请求体缺省该值时注入常量DEFAULT_CODEX_ANTHROPIC_MAX_TOKENS8192可在供应商表单的Max output tokens中覆盖供应商 meta 中max_output_tokens 0时优先级最高会先注入请求体覆盖请求自带值与默认值thinking 预算的钳制也据此计算余量。同区域Model Mapping可选每行一个模型 idCC Switch 据此生成模型目录供 Codex 的/model菜单列出留空时 Codex 只用默认模型。保存后供应商卡片出现Needs Routing标记——此类供应商仅在本地路由运行时可用。路由开关与端口怎么改设置页Routing→Local Routing完成两个开关打开Routing Master Switch启动本地服务默认地址127.0.0.1:15721端口可在代理面板修改见用户手册 4.1。在Routing Enabled下打开CodexClaude、Gemini 路由互不影响见用户手册 4.2。接管后codex_config.rs 中的update_codex_toml_field以toml_edit语法保持地改写config.tomlbase_url与wire_api写入当前model_provider对应的[model_providers.current]段并强制保留wire_api responses测试用例base_url_writes_into_correct_model_provider_section覆盖该行为——接管后 Codex 仍以 Responses 协议对话。如何验证已生效回到供应商列表点击Enable。若路由未启动CC Switch 提示 This provider uses Anthropic Messages API format, requires the routing service to work properly. Start routing first.重启当前 Codex 终端会话config.toml与模型目录在进程启动时读取运行中的进程不热加载。验证顺序/model查看映射模型是否列出发送请求后Routing 页 Current Provider 从 Waiting for first request... 变为该供应商、Total Requests 增长用量面板中模型名如实显示为claude-*。高级选项与能力边界选项 / 行为何时调整 / 是否支持Auth field默认Authorization头可切x-api-key上游 401 / 403 时按网关文档切换Emulate Claude Code client默认关闭网关限定 Claude Code 客户端时开启普通网关保持关闭Max output tokens覆盖缺省时的 8192 上限回答被截断stop_reasonmax_tokens时调大勿超模型真实上限否则上游 400Model Mapping生成/model模型目录需要多模型切换时逐行添加Prompt 缓存✅ 转换完成后自动注入标准 5 分钟缓存标记system、工具定义、对话历史无需调整推理与工具✅ extended thinking 原样往返多轮工具调用、图片、PDF 输入均完整转换无需调整[1m]长上下文✅ 剥离模型名后缀并加context-1m-2025-08-07beta 头上游模型名回写后会在最终请求体上再剥离一次网关支持 1M 上下文时Web search⚠️ Anthropic 上游下被禁用避免向模型展示必然失败的工具需要联网搜索时切回 Responses / Chat 格式供应商补充机制Codex 的reasoning.effort经effort_to_thinking_budget映射为 thinking token 预算minimal/low → 2048、medium → 8192、high → 16384、xhigh/max/ultra → 24576未识别值返回None不启用 extended thinking避免误吞 temperature/top_p。Anthropic 带签名的 thinking / redacted-thinking 块经 Base64 编码后存入 Responses 的reasoning.encrypted_content前缀ccswitch-anthropic-thinking-v1:Codex 在下一轮工具请求中原样回放。上游在输出上限处停止或流中断时Codex 收到的是 incomplete 而非成功便于定位并调大输出上限。故障排查、合规与致谢现象原因动作上游 401 / 403Auth field 与网关鉴权头不匹配或密钥失效、无余额在Authorization与x-api-key之间切换重试核对密钥Codex 报 404 或找不到/responses本地路由接管未开启或网关地址被直接写入 Codex 配置检查~/.codex/config.toml当前供应商base_url是否为http://127.0.0.1:15721/v1路由已开启仍 404API Request URL 带了其他协议路径如/chat/completions只填服务根地址或用Full URL开关粘贴完整 messages 端点回答被截断默认 8192 输出上限生效表单Max output tokens调大后重试/model不显示 Claude 模型模型目录随进程启动加载未重启或未配置映射保存供应商后重启 Codex默认模型不在映射中时菜单不列出但直接请求仍可用在组织禁用客户端但保留网关的场景启用本方案前确认被禁用的是特定客户端还是某类使用方式以所在组织政策为准使用第三方中转网关时阅读其计费、合规与数据留存条款。该功能源自社区贡献PR #5071yeeyzy。相关文档与源码用户手册Proxy Service用户手册App Routingv3.17.0 发布说明核心转换实现transform_codex_anthropic.rs、forwarder.rs、codex_config.rs【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 CC Switch 本地路由：Codex 接入 Claude 网关
CC Switch 本地路由Codex 接入 Claude 网关【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch适用场景与解决路径面向持有 Claude 网关密钥仅开放/v1/messages端点、希望用 Codex 运行 Claude 模型的开发者。阻塞点新版 Codex 只讲 OpenAI Responses API直连 Anthropic Messages 端点只能得到 404。解决路径CC Switch 本地路由接管 Codex完成两种协议的请求与响应互转让 Codex 接入 Claude 网关。请求在 Codex、本地路由与上游之间如何流转Codex CLI │ Responses 请求wire_api responses ▼ 本地路由 127.0.0.1:15721/v1CC Switch │ 端点重写为 /v1/messages请求体转为 Anthropic Messages ▼ 上游网关 /v1/messages ▲ Anthropic JSON / SSE │ 转回 Responses JSON / SSE含推理、工具调用、图片 ▲ Codex CLI转换实现位于 transform_codex_anthropic.rs方向与transform_responses.rs互为镜像调用入口在 forwarder.rs 的codex_responses_to_anthropic分支。环境与版本要求项目要求说明CC Switch3.17.0 或更高Anthropic Messages 上游支持自 3.17.0 引入Codex CLI已安装并至少运行过一次保证~/.codex/目录结构存在API 密钥可访问/v1/messages端点来自 Claude 家族中转网关或企业 Claude 网关标注仅限 Claude Code的密钥经由 Codex 调用可能报错模型 id网关文档中可识别的 Claude 模型名如claude-sonnet-5模型映射行同样以网关文档为准供应商表单、路由开关与生效验证表单字段怎么填Codex 页签没有内置 Anthropic 预设新增供应商时保持Custom Configuration填写以下字段Provider Name任意名称。API Key网关密钥。密钥只保存在 CC Switch转发时由本地路由注入Codex 的 live 配置auth.json中只有占位符。API Request URL只填服务根地址如https://claude-gateway.example.com带不带尾部/v1均可不要自行拼/v1/messages网关文档给的是完整 messages URL 时打开Full URL开关原样粘贴。Default Model网关可识别的模型 id。上游格式在哪里切换展开Advanced Options把Upstream Format从Responses (native)改为Anthropic Messages (routing required)随后出现三个配套字段Auth field决定密钥以哪种请求头注入上游两者只发其一。默认ANTHROPIC_AUTH_TOKEN (Authorization)发送Authorization: Bearer key部分遵循 Anthropic 原生头约定的网关要求ANTHROPIC_API_KEY (x-api-key)。选错通常表现为 401 / 403。Emulate Claude Code client默认关闭。开启后仿造 User-Agent、anthropic-beta、x-app请求头并在系统提示第一行注入 Claude Code 身份标识——对应 forwarder.rs 中codex_impersonate_claude_code为真时调用prepend_claude_code_system_prompt改写请求体。Max output tokensAnthropic 协议要求max_tokens必填。路由在请求体缺省该值时注入常量DEFAULT_CODEX_ANTHROPIC_MAX_TOKENS8192可在供应商表单的Max output tokens中覆盖供应商 meta 中max_output_tokens 0时优先级最高会先注入请求体覆盖请求自带值与默认值thinking 预算的钳制也据此计算余量。同区域Model Mapping可选每行一个模型 idCC Switch 据此生成模型目录供 Codex 的/model菜单列出留空时 Codex 只用默认模型。保存后供应商卡片出现Needs Routing标记——此类供应商仅在本地路由运行时可用。路由开关与端口怎么改设置页Routing→Local Routing完成两个开关打开Routing Master Switch启动本地服务默认地址127.0.0.1:15721端口可在代理面板修改见用户手册 4.1。在Routing Enabled下打开CodexClaude、Gemini 路由互不影响见用户手册 4.2。接管后codex_config.rs 中的update_codex_toml_field以toml_edit语法保持地改写config.tomlbase_url与wire_api写入当前model_provider对应的[model_providers.current]段并强制保留wire_api responses测试用例base_url_writes_into_correct_model_provider_section覆盖该行为——接管后 Codex 仍以 Responses 协议对话。如何验证已生效回到供应商列表点击Enable。若路由未启动CC Switch 提示 This provider uses Anthropic Messages API format, requires the routing service to work properly. Start routing first.重启当前 Codex 终端会话config.toml与模型目录在进程启动时读取运行中的进程不热加载。验证顺序/model查看映射模型是否列出发送请求后Routing 页 Current Provider 从 Waiting for first request... 变为该供应商、Total Requests 增长用量面板中模型名如实显示为claude-*。高级选项与能力边界选项 / 行为何时调整 / 是否支持Auth field默认Authorization头可切x-api-key上游 401 / 403 时按网关文档切换Emulate Claude Code client默认关闭网关限定 Claude Code 客户端时开启普通网关保持关闭Max output tokens覆盖缺省时的 8192 上限回答被截断stop_reasonmax_tokens时调大勿超模型真实上限否则上游 400Model Mapping生成/model模型目录需要多模型切换时逐行添加Prompt 缓存✅ 转换完成后自动注入标准 5 分钟缓存标记system、工具定义、对话历史无需调整推理与工具✅ extended thinking 原样往返多轮工具调用、图片、PDF 输入均完整转换无需调整[1m]长上下文✅ 剥离模型名后缀并加context-1m-2025-08-07beta 头上游模型名回写后会在最终请求体上再剥离一次网关支持 1M 上下文时Web search⚠️ Anthropic 上游下被禁用避免向模型展示必然失败的工具需要联网搜索时切回 Responses / Chat 格式供应商补充机制Codex 的reasoning.effort经effort_to_thinking_budget映射为 thinking token 预算minimal/low → 2048、medium → 8192、high → 16384、xhigh/max/ultra → 24576未识别值返回None不启用 extended thinking避免误吞 temperature/top_p。Anthropic 带签名的 thinking / redacted-thinking 块经 Base64 编码后存入 Responses 的reasoning.encrypted_content前缀ccswitch-anthropic-thinking-v1:Codex 在下一轮工具请求中原样回放。上游在输出上限处停止或流中断时Codex 收到的是 incomplete 而非成功便于定位并调大输出上限。故障排查、合规与致谢现象原因动作上游 401 / 403Auth field 与网关鉴权头不匹配或密钥失效、无余额在Authorization与x-api-key之间切换重试核对密钥Codex 报 404 或找不到/responses本地路由接管未开启或网关地址被直接写入 Codex 配置检查~/.codex/config.toml当前供应商base_url是否为http://127.0.0.1:15721/v1路由已开启仍 404API Request URL 带了其他协议路径如/chat/completions只填服务根地址或用Full URL开关粘贴完整 messages 端点回答被截断默认 8192 输出上限生效表单Max output tokens调大后重试/model不显示 Claude 模型模型目录随进程启动加载未重启或未配置映射保存供应商后重启 Codex默认模型不在映射中时菜单不列出但直接请求仍可用在组织禁用客户端但保留网关的场景启用本方案前确认被禁用的是特定客户端还是某类使用方式以所在组织政策为准使用第三方中转网关时阅读其计费、合规与数据留存条款。该功能源自社区贡献PR #5071yeeyzy。相关文档与源码用户手册Proxy Service用户手册App Routingv3.17.0 发布说明核心转换实现transform_codex_anthropic.rs、forwarder.rs、codex_config.rs【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考