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 测试：
开始前检查
- 在 Link API 文档或客服处确认 Claude Code 当前使用的协议和网关地址。
- 确认服务提供的是 Anthropic 兼容接口，而不只是 OpenAI 兼容接口。
- 为 Claude Code 创建独立 Key，不与生产服务共用。
配置步骤
以下为当前终端的配置模板，不会改写全局配置。先确认 Link 当前账号和目标模型提供 Anthropic Messages；模板本身不代表该模型已通过工具调用验收。模型 ID 从 Link 模型广场复制，不要用产品展示名称代替。
export ANTHROPIC_BASE_URL="https://www.aifast.link"
export ANTHROPIC_AUTH_TOKEN="YOUR_LINK_API_KEY"
export ANTHROPIC_MODEL="YOUR_CLAUDE_MODEL_ID"
claude --version
claude --model "$ANTHROPIC_MODEL"将两个占位值替换为本站 Key 与当前可用模型 ID。示例采用 Bearer 认证；如果当前账号接入说明要求其他认证方式，应按该说明调整，不要同时保留相互冲突的认证变量。
| 客户端 | Base URL 示例 | 预期请求路径 |
|---|---|---|
| Claude Code / Anthropic Messages | https://www.aifast.link |
/v1/messages |
| OpenAI Compatible SDK | https://www.aifast.link/v1 |
按所用协议追加 /chat/completions 或 /responses |
Claude Code 的示例不在域名后加 /v1，也不填写完整 /v1/messages。若日志出现 /v1/v1/messages，先修复路径拼接；不要通过反复更换 Key 解决路径问题。
配置完成后，在同一个终端确认变量存在，不要直接打印完整 Key。上述 export 不会自动传递到另一个新终端：
test -n "$ANTHROPIC_BASE_URL" && echo "Base URL 已设置"
test -n "$ANTHROPIC_AUTH_TOKEN" && echo "认证变量已设置"为什么设置了 ANTHROPIC_BASE_URL 仍然走旧地址？
终端里的变量存在，只能证明这个 Shell 已设置。Claude Code 启动后运行 /status ，核对实际 Base URL 和认证来源；设置文件的 env 可能覆盖 Shell 变量，从桌面启动的编辑器也不一定继承当前终端。先记录并处理冲突来源，再重启客户端，不要直接覆盖整个配置文件。
| 检查位置 | 应核对的内容 | 失败时先处理 |
|---|---|---|
Claude Code /status |
Link Base URL 与当前认证来源 | 设置文件、启动终端或受管配置 |
| 最终请求路径 | /v1/messages |
重复的 /v1 或误填的 OpenAI 聊天路径 |
| 认证字段 | Bearer 使用 ANTHROPIC_AUTH_TOKEN；x-api-key 使用 ANTHROPIC_API_KEY |
按网关要求选择，避免相互冲突 |
| 当前账号 | 模型 ID、API Key 分组、月卡覆盖范围 | 账号权限与计费选择，不用充值修复路径错误 |
Link 独立 GitHub 的 Messages 请求模板与检查步骤 提供可下载 JSON 和失败分类。模板没有密钥，也不是已完成的调用记录；发送真实请求可能产生费用。
先按 按量与月卡说明 核对分组，再用 成本计算器 比较实际使用天数和超额用量。Claude Code 客户端订阅与 Link API 月卡是不同产品。
然后进入一个不含敏感代码的测试目录，执行短任务：
Read the README in the current directory and summarize it in three points.
Do not modify any files.先验证只读任务，再验证写文件和执行命令。
常见问题
| 症状 | 先检查什么 | 下一步 |
|---|---|---|
| 401 或认证失败 | 当前终端的 Key 是否属于 Link，认证变量是否冲突 | 核对账户接入说明，不要公开完整 Key |
| 404 或 /v1/v1/messages | Base URL 是否重复包含 /v1 | 按上面的路径表修正，再发短请求 |
| 普通文本正常，工具失败 | 流式事件、工具参数和工具结果是否完整 | 保留脱敏错误与客户端版本，按验收清单逐项复测 |
| 月卡仍有额度但请求被拒绝 | 模型是否属于套餐分组、当日额度和扣费偏好 | 核对套餐范围，不要反复重试消耗额度 |
返回 404 或接口格式错误
先检查是否误用了 OpenAI 聊天端点。Claude Code 需要 Anthropic Messages 格式；核对 Base URL 和最终请求路径，不要用更换 Key 解决协议或路径错误。
能聊天但工具调用异常
中间兼容层可能只转换文本请求，没有完整转换工具调用、流式事件或用量字段。生产使用前必须测试读文件、改文件、执行命令和长任务。
环境变量修改后没有生效
如果按本文使用临时 export，请在同一个终端重新运行配置命令并启动 Claude Code；新开终端不会继承这些临时变量。如果已写入 Shell 启动文件，重新加载对应文件后再启动客户端。不要在多个配置文件中设置相互冲突的地址。
下一步
如果使用 Claude 月卡，先确认套餐对应的 Claude 分组和当日剩余额度，再运行长任务。30 天有效期不等于无限调用，具体方案见 Link 月卡与按量计费说明。本文核对了配置字段与地址拼接；完整流式、工具调用及长任务结果仍需按模型实测。
完成基础配置后，继续按Claude Code 中转 API 验收与排错清单分别验证 Messages 路径、持续流式输出、真实工具调用、长上下文、缓存和错误转发。不要用一次普通对话成功代替 Agent 能力验收。
确认协议兼容后，再为 Claude Code 设置独立用量限制和项目级安全规则。私有仓库、密钥文件和客户数据应加入明确的排除范围。