很多人装好 Claude Code CLI，想把它指到国产模型的接口上，结果改完地址还是连不上，或者能出字但一用工具就报错。这篇不讲哪家模型好，只给一套可执行的动作顺序：先确认协议兼容，再落配置，然后按顺序验证流式、工具调用和长上下文，最后给一份排查清单。
装好 Claude Code CLI 之后想把它指到国产模型的接口上，常见的两种翻车：改完地址还是连不上，或者能正常出字但一让它读写文件、跑命令就报错。原因通常不在网络，而在于协议、路径前缀和工具调用这几处没对齐。
这篇不讲哪家模型强，只给一套动作顺序：先确认对方接口是哪种协议，再把配置落下去，然后按固定顺序验证流式、工具调用和长上下文，最后给一份排查清单。每一步都写清怎么验证、什么情况下这套路子不适用。判断哪家平台靠谱、当时的价格和延迟数字，去站内对应页面核对，别拿旧印象套。
先分清对方给的是哪种接口，这决定你怎么配
Claude Code CLI 走的是 Anthropic 的 Messages 协议，不是 OpenAI 那套 chat/completions。两者不光端点名不同，请求字段结构和流式事件的切分方式也不一样。所以「支持 Claude」这种宣传语没有参考价值，你要看的是它是否明确写了兼容 Anthropic Messages 格式。
| 对方接口类型 | 能不能直接填地址 | 你要做的事 |
|---|---|---|
| 原生 Anthropic 兼容 | 可以 | 把地址、密钥、模型名填对即可 |
| OpenAI 兼容 | 不行 | 中间加一层协议转换再指向 CLI |
| 只给自家 SDK | 不行 | 自己写适配层，或换平台 |
| 只支持本地推理 | 不适用本篇 | 走本地推理框架那条线 |
拿不准属于哪一类时，先在本地起一个转换层试一次最省事：把 OpenAI 风格的响应转成 Anthropic 的事件格式，能出字说明协议这关过了，再考虑要不要固化下来。如果只是想在自己机器上跑、完全不碰任何云端接口，那这篇的路子不对，别往下看。
配置怎么落：环境变量优先，别急着改文件
核心就三个量：接口地址（base url）、鉴权密钥、模型名。优先用环境变量注入，写进 shell 配置文件，这样新开终端自动生效，也避免把密钥提交进仓库。
- 填地址从平台文档抄一份完整示例，再换域名。有的要带 /v1 前缀，有的不带，自己拼十有八九拼错。
- 填密钥用环境变量而不是写死在配置里，验证方式是新开一个终端回显该变量，确认值没被引号或换行污染。
- 填模型名必须是平台文档里给的真实标识，不要填你熟悉的官方模型名；填错通常报「模型不存在」而不是鉴权错误。
- 首次验证在一个空的临时目录里跑它，不要直接进真实项目，配置错了也不会搅乱已有上下文。
验证按这个顺序走，能出字不代表配好了
很多人看到有字往外吐就以为成了，其实这只过了第一关。后三关才是真正决定能不能日常用的地方，尤其是工具调用。按下面顺序一层层过，任何一关不过都先别急着上生产。
- 普通问答能不能稳定出字，连续问几次看是否偶发失败
- 流式输出是否连贯，中途断流多半是转换层没透传事件
- 工具调用能否成功一次，让它读一个文件或跑一条命令
- 长上下文是否被截断，拿一个较大的文件试，看是否报超长
工具调用是失败率最高的一环，因为国产接口对 function calling 的字段定义和 Anthropic 的不完全一致，转换层漏字段就会在这里炸。长上下文同理，对接层声明的窗口和实际能吃的量经常对不上，这类问题只在处理大文件时才暴露。四条都过才算可用。
连不上时的排查顺序，从最便宜的动作开始
排查要按成本从低到高走，别一上来就重装。先绕开 CLI 单测接口，能快速分清是配置问题还是平台问题，省掉大量来回试。
- 单测密钥和地址用 curl 直接打一次对话接口，绕开 CLI。curl 通、CLI 不通，问题在 CLI 配置；curl 也不通，问题在密钥或地址。
- 看状态码401 是密钥或鉴权头格式，404 是路径前缀，429 是限流，5xx 是平台侧，按码定位比猜快。
- 隔离工具调用工具调用报错时，先关掉工具能力只做纯对话，能通说明是协议字段缺失，不是网络问题。
- 量一次延迟基线到 /tools/speed-test 记下当时的首字延迟和中断情况，之后判断是平台变慢了还是本来就这样。
还有一种情况是间歇性失败：平时好用，一到高峰期就超时或断流。这种多半是限流或平台侧负载，不是你的配置问题。把失败发生的时间点和状态码记下来，去站内价格追踪和可用性页面核对同期有没有别人也报，能少走很多弯路。
下一步各家平台的协议兼容情况、当前价格和延迟表现都在变，配好之后去站内核对一遍当时的数字，再看一眼中转站的检测记录，比自己反复试快得多。→常见问题
Claude Code CLI 能直接连国产模型的 OpenAI 兼容接口吗？
默认不行，它讲的是 Anthropic 的 Messages 协议，字段和流式事件都对不上。想接就得在中间放一层协议转换，把 Anthropic 格式翻译成 OpenAI 格式再发出去。有些网关工具能直接干这事，配之前先确认它是否透传工具调用事件，否则会出现能聊天但一调用工具就报错的情况。
配置改完能聊但一用工具就出错，问题一般出在哪？
大概率在协议字段上，不在网络。工具调用要求接口完整支持工具定义、工具调用和结果回传三段结构，很多兼容层只翻译了文本部分。排查顺序是先关掉工具只做纯对话，确认基础通道没问题，再逐步打开工具能力；同时核对请求里工具定义字段有没有被转换层丢掉。
多个国产模型想换着用，配置怎么管理？
用不同的环境变量组或不同的启动脚本，每个模型一套地址、密钥、模型名，别在同一份配置里反复改。切换前先确认目标平台协议类型和你当前转换方式匹配，不匹配就得换网关。可以用标签区分命名，避免把测试配置带到真实项目里。
怎么判断是模型能力不够还是配置有问题？
一个简单的分法：让它做一段纯文本改写，如果结果稳定合理，说明通道是通的，问题多半出现在工具调用或长上下文这类协议环节；如果连纯文本都异常，比如答非所问、断流、乱码，那就是配置或转换层的问题，先排查链路再谈模型。
