Claude Code 接入网关：认证头、Messages 路径与最小验证

先确定网关说哪种协议

Claude Code 的普通网关路线使用 Anthropic Messages，并非把任意聊天接口改个地址就能接入。官方兼容指南列出 /v1/messages、可选的计数接口，以及必须透传的版本和能力请求头；只实现 Chat Completions 的服务不能据此宣称兼容。 本文核对的是客户端配置规范，没有运行客户端，也没有验证本站接口。

适合这条路线的场景，是团队已经有明确的 Claude 模型入口，希望统一认证与请求观察。Anthropic 不支持借网关把 Claude Code 路由到非 Claude 模型；不要把“可以设置地址”理解成“任意模型都受支持”。

地址和凭证要同时确认

ANTHROPIC_BASE_URL 决定去哪里；ANTHROPIC_AUTH_TOKEN 使用 Bearer 认证，ANTHROPIC_API_KEY 对应另一种密钥认证方式，应按网关要求选择，而非同时填入猜测值。 以下仅为占位示例，不存在可供此教程调用的真实接口。这里用根地址，是因为客户端还会追加 /v1/messages，不能重复拼接版本路径。

export ANTHROPIC_BASE_URL="https://80321.cn"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"

先在单独终端保留短期配置。官方说明，终端导出的变量只影响该终端启动的程序；后台 Agent 或从桌面打开的编辑器，宜按需要使用设置文件的 env 配置。 不要为一次诊断覆盖整个用户设置。

用无工具短请求分开验收

官方 CLI 提供打印模式、模型选择和工具集合限制。 取得真实模型标识后，可以在不含业务文件的目录按下列形式验证；这仍是未执行的示例，密钥和模型均须由实际服务方提供。

claude -p "只返回 OK，不读取文件"   --model YOUR_MODEL_ID --tools "" \
  --disallowedTools "mcp__*" --max-turns 1

--tools 只限制内置工具，MCP 另用 deny 规则排除；启动前也要检查可信设置中的 hooks。 交互模式再打开 /status，分别核对网关地址与当前认证来源。 能启动、能鉴权、能完成文本回答是不同检查点，记录实际错误，而不是先写“接入成功”。

失败时沿请求链定位

如果仍显示原账户登录，先查凭证是否进入当前进程。官方特别提醒，只设置地址而不提供网关凭证，原有登录仍可能参与请求。 认证错误应核对请求头类型；模型错误应核对完整模型标识；路径错误应核对最终 URL，避免出现重复的 /v1。

文本开始输出后中断，则检查 SSE 是否完整转发，尤其是内容块和最终结束事件。缓冲、丢事件和改写事件顺序都可能破坏客户端读取，增加重试次数不能修复协议错误。

代理权限不等于接口权限

首次诊断关闭工具，不传仓库，不开无人确认模式。后续确需读写文件时，再逐项授权。日志只保留脱敏后的认证类型、模型、请求路径和错误信息；不要把 Key、完整提示词或业务文件提交到公开问题区。网关兼容性还需要随客户端版本复核，文档核验不能代替实际服务验收。