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，不与生产服务共用。
配置步骤
1. 在当前终端完成一次隔离配置
以下示例面向已安装 Claude Code 的 Bash/Zsh。先在本地安全设置 AIFAST_API_KEY 和 AIFAST_MODEL_ID，分别使用 HK 的临时限额 Key 与当前账号可用的完整模型 ID。不要把其他服务商的密钥发给 HK，也不要把密钥写进仓库。
括号内配置只影响这次 CLI 子进程，退出后不覆盖原 Shell 的认证变量或登录文件。示例采用 Bearer 认证；如果当前接入说明要求 x-api-key，应使用对应变量，不要同时设置两种凭证。
(
set -eu
: "${AIFAST_API_KEY:?请先设置 HK 临时限额 Key}"
: "${AIFAST_MODEL_ID:?请先设置 HK 账号可用的模型 ID}"
export ANTHROPIC_BASE_URL="https://www.aifast.hk"
export ANTHROPIC_AUTH_TOKEN="$AIFAST_API_KEY"
unset ANTHROPIC_API_KEY
claude --model "$AIFAST_MODEL_ID"
)2. 核对路径、认证来源与实际任务
启动后先运行 /status，核对域名和认证来源；再确认实际请求进入 /v1/messages，没有重复 /v1。环境变量正确只说明配置已传入，不代表模型、流式或工具调用已经通过。本文示例经过语法与隔离测试，不是一次真实付费调用的成功报告。
在不含敏感代码的测试目录执行短任务，生成请求可能计费：
阅读当前目录中的 README，并用三条要点总结，不要修改文件。先验证只读任务，再按验收清单测试写文件和执行命令。不要为接入网关关闭工具确认、TLS 校验或项目安全限制。
3. 配置未生效时先检查覆盖关系
先看 /status 的有效值，再核对用户或项目设置文件。当前官方网关说明指出，设置文件中的 env 值可能覆盖 Shell 导出值；已打开的编辑器也不会自动继承新终端变量。本段仅覆盖 CLI，VS Code 扩展与桌面应用需要各自的配置入口。
测试通过后再决定是否持久化。不要把带 Key 的项目配置提交 Git，也不要为了切换网关直接退出或删除原有账号登录。
常见问题
返回 404 或接口格式错误
最常见原因是把 OpenAI 的 /v1/chat/completions 地址交给了需要 Anthropic Messages 格式的客户端。核对专用 Base URL 和协议，不要反复更换 Key。
能聊天但工具调用异常
中间兼容层可能只转换文本请求，没有完整转换工具调用、流式事件或用量字段。生产使用前必须测试读文件、改文件、执行命令和长任务。
环境变量修改后没有生效
临时 export 只对当前终端及其子进程有效，新开终端会丢失。先在同一终端启动 CLI 并核对 /status；使用持久配置时，再检查当前 Shell 启动文件和 Claude Code 设置文件是否冲突。
下一步
完成基础配置后，继续按Claude Code 中转 API 验收与排错清单分别验证 Messages 路径、持续流式输出、真实工具调用、长上下文、缓存和错误转发。不要用一次普通对话成功代替 Agent 能力验收。
确认协议兼容后，再为 Claude Code 设置独立用量限制和项目级安全规则。私有仓库、密钥文件和客户数据应加入明确的排除范围。