Claude Code 原生使用 Anthropic API 语义。OpenAI Compatible 不等于 Anthropic Compatible。在配置前，必须确认当前服务明确提供 Claude Code 或 Anthropic 协议兼容入口；不能仅因为模型名称里有 Claude，就把 OpenAI Base URL 直接填入 Claude Code。
快速结论
Claude Code 接入第三方网关前，先确认服务明确支持 Anthropic Messages、持续流式事件和工具调用。配置 ANTHROPIC_BASE_URL 与认证变量后，用只读任务核对最终域名和 Messages 路径，再测试写文件、执行命令和长任务；普通对话成功不能证明完整 Agent 链路兼容。
Claude Code 可以直接使用 OpenAI Compatible Base URL 吗？
通常不能直接替换。Claude Code 原生需要 Anthropic Messages 语义、连续流式事件和工具调用。OpenAI 风格聊天端点是 /v1/chat/completions，仅支持该端点不足以证明 Claude Code 兼容。只有服务明确提供 Claude Code 或 Anthropic Compatible 入口时，才把对应地址填写到变量 ANTHROPIC_BASE_URL。认证变量和模型映射也必须按照该服务的说明配置。
如果网关同时提供 OpenAI 与 Anthropic 两套协议，应分别验收，不能用 OpenAI SDK 的成功响应代替 Claude Code 测试：
开始前检查
- 在 AI快站 API 文档或客服处确认 Claude Code 当前使用的协议和专用地址。
- 确认服务提供的是 Anthropic 兼容接口，而不只是 OpenAI 兼容接口。
- 为 Claude Code 创建独立 Key，不与生产服务共用。
配置步骤
Claude Code 常见配置通过环境变量完成。具体变量和认证方式应以当前 Claude Code 官方文档与 AI快站接入说明为准。典型检查项包括：
ANTHROPIC_BASE_URL
ANTHROPIC_AUTH_TOKEN 或对应认证变量
默认模型与小模型设置配置完成后，新开一个终端，先确认变量是否存在，不要直接打印完整 Key：
test -n "$ANTHROPIC_BASE_URL" && echo "Base URL 已设置"
test -n "$ANTHROPIC_AUTH_TOKEN" && echo "认证变量已设置"然后进入一个不含敏感代码的测试目录，执行短任务：
阅读当前目录中的 README，并用三条要点总结，不要修改文件。先验证只读任务，再验证写文件和执行命令。
常见问题
返回 404 或接口格式错误
最常见原因是把 OpenAI 的 /v1/chat/completions 地址交给了需要 Anthropic Messages 格式的客户端。核对专用 Base URL 和协议，不要反复更换 Key。
能聊天但工具调用异常
中间兼容层可能只转换文本请求，没有完整转换工具调用、流式事件或用量字段。生产使用前必须测试读文件、改文件、执行命令和长任务。
环境变量修改后没有生效
关闭并重新打开终端，确认配置写入了当前 Shell 使用的启动文件。不要在多个配置文件中同时设置相互冲突的地址。
下一步
完成基础配置后，继续按Claude Code 中转 API 验收与排错清单分别验证 Messages 路径、持续流式输出、真实工具调用、长上下文、缓存和错误转发。不要用一次普通对话成功代替 Agent 能力验收。
确认协议兼容后，再为 Claude Code 设置独立用量限制和项目级安全规则。私有仓库、密钥文件和客户数据应加入明确的排除范围。