尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
Claude Code 切换为 OpenAI 格式 API 接入说明
Claude Code 切换为 OpenAI 格式 API 接入说明一、适用场景与前提已安装Claude Codeclaude命令可正常运行无论当前走官方登录还是 Anthropic 直连。手里有第三方中转站提供的 OpenAI 格式 API一个 base URL形如https://xxx/v1/chat/completions、一个模型名、一个 API Key。目标让 Claude Code 不再走 Anthropic 格式端点/v1/messages改为走OpenAI 格式端点/v1/chat/completions。本文以 cloudrouter 中转 GLM5.2 为示例但流程对任意 OpenAI 格式中转通用——把 URL / 模型名 / Key 换成你自己的即可。二、原理为什么不能直连Claude Code 只会发Anthropic 格式请求OpenAI 格式端点听不懂。解决办法是在本地加一层翻译代理claude-code-routerCCRClaude Code ──(Anthropic格式)──► CCR(本地 127.0.0.1:3456) ──(OpenAI格式)──► 中转站 ──► 模型CCR 负责两种格式互译。配好后Claude Code 以为自己在跟 Anthropic 端点对话实际请求被翻译成 OpenAI 格式转发给你指定的中转站。三、涉及的两个配置文件目标状态预览Key 位用占位符表示——真实 Key 由 Claude 在执行时写入不写进本文档。1.~/.claude-code-router/config.json翻译路由{LOG:true,Providers:[{name:relay,api_base_url:https://你的中转站/v1/chat/completions,api_key:你的API Key,models:[模型名],transformer:{use:[openai]}}],Router:{default:relay,模型名,background:relay,模型名,think:relay,模型名,longContext:relay,模型名,webSearch:relay,模型名}}2.~/.claude/settings.json让 Claude Code 指向本地 CCR{env:{ANTHROPIC_BASE_URL:http://127.0.0.1:3456,ANTHROPIC_AUTH_TOKEN:test,ANTHROPIC_DEFAULT_HAIKU_MODEL:模型名,ANTHROPIC_DEFAULT_SONNET_MODEL:模型名,ANTHROPIC_DEFAULT_OPUS_MODEL:模型名},model:opus,theme:dark}说明ANTHROPIC_AUTH_TOKEN: test是给本地 CCR 的占位鉴权不是真实 Key真实 Key 只在config.json里。model: opus配合ANTHROPIC_DEFAULT_OPUS_MODEL让 Claude Code 的 opus 档实际落到你的目标模型。四、一键部署把下面整段提示词粘进 Claude Code复制下方代码块全部内容粘进 Claude Code 对话框回车。Claude 会向你索取 Key 并完成全部配置Key 不会被打印回显。帮我把 Claude Code 的 API 从 Anthropic 格式切换为 OpenAI 格式经本地 claude-code-router 翻译。请按下面步骤执行全程不要在对话里回显、打印或记录我的 API Key 明文 1. 安装 claude-code-routerCCR先检查 ccr 是否存在没有就执行 npm install -g musistudio/claude-code-router装完跑 ccr -v 确认版本。若全局安装报权限错误提示我配置 npm prefix 到用户目录或改用 sudo不要擅自用 sudo。 2. 一次性向我索取三项信息中转站 OpenAI 格式端点形如 https://xxx/v1/chat/completions、模型名、API Key。拿到 Key 后只能写入配置文件禁止在后续任何输出、日志、记忆文件里出现 Key 明文。 3. 写 ~/.claude-code-router/config.jsonProvider 名用 relayapi_base_url 填我给的端点api_key 填我给的 Keymodels 含我给的模型名transformer 用 {use:[openai]}Router 的 default / background / think / longContext / webSearch 全部设为 relay,模型名。若文件已存在先备份为 config.json.bak 再覆盖。写完对文件 chmod 600。 4. 修改 ~/.claude/settings.json保留已有键仅设置/更新 env 下的 ANTHROPIC_BASE_URLhttp://127.0.0.1:3456、ANTHROPIC_AUTH_TOKENtest、ANTHROPIC_DEFAULT_SONNET_MODEL模型名、ANTHROPIC_DEFAULT_OPUS_MODEL模型名、ANTHROPIC_DEFAULT_HAIKU_MODEL模型名顶层 model 设为 opus。改前备份为 settings.json.bak。不要写入任何真实 Key。 5. 执行 ccr start等待就绪再 ccr status 确认监听在 127.0.0.1:3456 且状态 Running。 6. 端到端测试用 curl 向 http://127.0.0.1:3456/v1/messages 发一个 POSTmodel 字段填 claude-sonnet-4-5-20250929、max_tokens 给小值、messages 问你是什么模型确认返回 HTTP 200 且响应里 model 字段是我的目标模型名。 7. 汇报测试结果并告诉我日常启动方式ccr start 后用 ccr code和切回 Anthropic 直连的方法。全程不要回显 Key。五、验证可选粘进 Claude Code部署后想复查链路是否正常粘这段帮我核查 Claude Code 当前是否正确走 OpenAI 格式链路1) ccr status 看服务状态与端口2) curl 本地 127.0.0.1:3456 的 /v1/messagesmodel 字段填 claude-sonnet-4-5-20250929 发一个小请求确认返回的 model 是我的目标模型、HTTP 2003) 读 ~/.claude/settings.json 确认 ANTHROPIC_BASE_URL 指向 127.0.0.1:3456。给出通过/未通过结论与原因。不要回显 Key。六、日常使用部署完成后每次开机后用 Claude Code 的标准动作ccr start—— 启动本地翻译代理开机一次常驻后台。ccr code—— 经代理启动 Claude Code日常用这条。因为~/.claude/settings.json已把 base_url 指向本地 3456所以ccr start之后直接敲claude也会走 CCR但务必先ccr start否则本地代理没起来claude会连不上。七、回退到 Anthropic 格式直连粘进 Claude Code想切回不走 CCR、直接用中转站的 Anthropic 端点时粘这段帮我把 Claude Code 从 CCR/OpenAI 格式切回 Anthropic 格式直连1) 把 ~/.claude/settings.json 里 env 的 ANTHROPIC_BASE_URL 改回我的中转站 Anthropic 端点我会告诉你形如 https://xxx、ANTHROPIC_AUTH_TOKEN 改回我的 Anthropic Key2) 视需要删除 ANTHROPIC_DEFAULT_*_MODEL 三个映射键或保留3) ccr stop 停掉本地代理。改前备份 settings.json。全程不要回显 Key。八、注意事项Key 安全CCR 不支持从环境变量读取上游 KeyKey 必须落在~/.claude-code-router/config.json里。本流程由 Claude 写入不会出现在本文档、对话或日志中配置文件已设chmod 600仅属主可读。effort / 思考档位经 CCR→第三方模型这条链路Claude Code 的/effort命令与--effort参数会失效环境检测为非官方后端即锁定多数第三方模型如 GLM5.2默认即深度思考无需也无法配置 effort不必折腾。模型名用中转站/v1/models列出的准确 id带方括号后缀的变体如glm-5.2[1m]通常不被识别[1m]只是1M 上下文的标注、并非合法模型名。npm 权限若npm install -g报EACCES把 npm 全局目录指到用户目录npm config set prefix ~/.npm-global并加入 PATH或按提示用sudo不要反复重试。直连与 CCR 并存settings.json指向本地 3456 时claude与ccr code都走 CCR若想临时直连中转站临时改ANTHROPIC_BASE_URL即可互不破坏。配置变更生效改了config.json后用ccr restart让新配置生效。
RELATED

相关推荐

第98期 黄大年茶思屋榜文98期 第3题 物理综合阶段 buffer tree 优化技术

第98期 黄大年茶思屋榜文98期 第3题 物理综合阶段 buffer tree 优化技术

黄大年茶思屋榜文98期 第3题 物理综合阶段 buffer tree 优化技术摘要针对物理设计中Buffer Tree构建面临的“时序、拥塞、面积”三难困境,本文提出一种“Congestion-Aware Steiner 动态Cell选型”的工程化落地方案。该方案摒弃了对全局最优斯坦纳树的穷举&#xff…

📅 2026/9/27 9:56:26
MCP协议实战从零写个Agent工具

MCP协议实战从零写个Agent工具

MCP协议实战:从零写个Agent工具 摘要:MCP 就是 AI 世界的 REST API——你写好服务,Claude 来调。前一篇聊了 AI Agent 的学习路线,这篇落到具体动作:用 Python 写一个 MCP Server,把自己的 API 包装成 Age…

📅 2026/10/2 2:37:43
C++ 多线程开发者常犯的错误,Rust 却能轻松规避,差别在哪?

C++ 多线程开发者常犯的错误,Rust 却能轻松规避,差别在哪?

引言作为一名深耕C多年的技术专家,我时常被一个问题困扰:在多线程编程中,如何在保证性能的同时,确保线程安全?C凭借其强大的并发工具和灵活性,一直是高性能并发应用的首选。然而,数据竞争、死锁…

📅 2026/10/2 19:30:54
MORE NEWS

更多资讯

📰

模拟CMOS设计必备:MOS器件物理核心概念与工程应用解析

做模拟IC设计,大部分人开局都是抱着拉扎维那本《模拟CMOS集成电路设计》在啃,第一章还能靠兴趣撑住,到了第二章MOS器件物理基础,很多人直接开始怀疑人生。我当年也是这样,捧着书看了三遍,感觉每个字都认识&…

📰

Agent生产环境落地指南:记忆、编排、安全与并发实践

1. 这份调研报告到底在聊什么 Agent 这个词在 2025 年到 2026 年之间,从技术圈的黑话变成了产品经理、运维、甚至业务侧都在追问的东西。我拿到《2026 Agent 开发者调研报告丨Alibaba Cloud AI Agent Handbook》这份材料的时候,第一反应不是去看它列了多…

📰

AI Agent 生产实战:编排、记忆、安全与多 Agent 协作的工程化指南

1. 从一份调研报告说起:Agent 开发者到底在关心什么2026 年的 Agent 开发领域,和两年前已经完全不是一个面貌了。2024 年大家还在争论"Agent 到底是不是套壳的 Prompt 工程",到了 2026 年,这个问题已经没人再提——因为…

📰

大华客流统计方案深度解析:系统架构、安装参数与避坑指南

简介:浙江大华技术股份有限公司编写的《大华客流统计分析解决方案》,面向商场、连锁店等商业场所的运营管理与智能化项目人员,针对人工客流统计效率低、数据滞后等问题,给出了基于视频智能分析的完整应对思路。包内为单个doc文档&…

📰

电商订单数据清洗实战——Pandas 处理缺失值、重复单与异常金额

AI Agent Function Calling Python 个人主页&#xff1a;> for_ever_love__ < &#xff08;欢迎各位大佬莅临&#x1f60a;&#xff09; 其他栏目: > 我想学python了 < 其他栏目: > iOS项目总结大全 < 其他栏目: > iOS UI < 文章目录电商订单数据清…

📰

乳腺癌病理图像自动分类:从patch到WSI的深度学习落地指南

简介&#xff1a;PDF资料《基于深度学习的乳腺癌病理图像自动分类》定位清晰&#xff0c;面向医学影像处理、计算机辅助诊断与深度学习应用方向的科研人员、临床工程师和学生。乳腺癌是威胁女性健康的常见恶性肿瘤&#xff0c;病理图像是临床确诊和制定治疗方案的重要依据&…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬