Claude Code API Base URL 配置教程：国内使用、长请求和 524 解决方案
api2.link-ai.cc。api1 适合网页端、充值和普通请求；api2 是长请求直连通道，避免 Cloudflare 120 秒超时。遇到 524 先看这里。
Claude 原生 API 格式（推荐）
export ANTHROPIC_BASE_URL="https://api2.link-ai.cc"
export ANTHROPIC_AUTH_TOKEN="sk-你的key"
OpenAI-compatible 客户端格式
Base URL: https://api2.link-ai.cc/v1
API Key: sk-你的key
API Key 格式：sk-xxxxxxxx，从 api1.link-ai.cc 控制台获取
和 Link-AI 有什么关系？
Link-AI 是什么？
Link-AI 是 OpenAI-compatible API gateway，面向开发者提供 Claude、GPT 等模型的接入服务。
- api1：普通 API 请求、网页端、登录、注册、充值、支付回调
- api2：Claude Opus、Claude Code、Codex、长上下文、长输出、Agent 长任务直连通道
在 api1.link-ai.cc 控制台创建 API Key 后，即可在 Claude Code 中使用。
如果担心扣费问题，使用 API 扣费检测工具验证 raw quota 变化。
前置准备
- 已安装 Claude Code CLI
- 拥有 Link-AI 账户，可在 api1.link-ai.cc 注册或登录
- 已获取 API Key（控制台 → API Keys → 创建密钥）
ANTHROPIC_BASE_URL 配置示例
在终端中运行以下命令，或将其加入 ~/.bashrc / ~/.zshrc：
# Claude 原生 API 格式（推荐） export ANTHROPIC_BASE_URL="https://api2.link-ai.cc" export ANTHROPIC_AUTH_TOKEN="sk-你的key" # 应用更改 source ~/.zshrc
此配置让 Claude Code 通过 Link-AI api2 通道发送请求，直连源站避免 Cloudflare 120 秒超时。
ANTHROPIC_AUTH_TOKEN 配置示例
ANTHROPIC_AUTH_TOKEN 即你的 Link-AI API Key，格式为 sk-xxxxxxxx。与 ANTHROPIC_BASE_URL 配合使用：
export ANTHROPIC_AUTH_TOKEN="sk-你的key"
Key 从 api1.link-ai.cc 控制台的「API Keys」页面获取。
OpenAI-compatible 客户端怎么填？
如果 Claude Code 客户端要求 OpenAI-compatible 端点，使用以下配置：
Base URL: https://api2.link-ai.cc/v1 API Key: sk-你的key
注意：OpenAI-compatible 格式需要带 /v1 后缀。
api1 和 api2 应该怎么选？
Claude Code 长任务、Claude Opus、长上下文和长输出请求建议使用 api2.link-ai.cc。
- api1：普通请求、网页端、充值、支付回调。经过 Cloudflare，有 120 秒超时。
- api2：Claude Opus、Codex、Claude Code、长上下文、长输出任务。直连源站，1800 秒超时。
两者共享同一套账户余额，按实际消耗扣费。
Claude Code 遇到 524 / timeout 怎么办？
Claude Opus、长上下文和长输出任务生成时间超过 Cloudflare 的 120 秒超时窗口，就会报 524 或 timeout。
解决方法：将 ANTHROPIC_BASE_URL 从 https://api1.link-ai.cc 切换为 https://api2.link-ai.cc。
了解更多：API Error 524 解决方案
Claude Code 遇到空回复怎么办？
空回复通常由上游渠道异常或模型不支持导致。如果出现空回复（无文本、无 tool_call）但扣费了，可用扣费检测工具验证。
Link-AI 按实际消耗计费，失败请求扣费会在审计后自动返还。如有异常可联系客服。
了解更多：API 扣费检测工具
为什么模型可能自称 Kiro 或 Claude Code？
这是正常的渠道映射行为。Claude Opus/Claude Sonnet 等模型通过中转渠道调用时，渠道方可能对模型名称做了别名处理，不影响实际模型能力和输出质量。
常见错误排查表
| 错误现象 | 可能原因 | 解决方式 |
|---|---|---|
| 524 Origin Timeout | Cloudflare 120 秒超时，长任务未完成 | 切换 ANTHROPIC_BASE_URL 为 https://api2.link-ai.cc |
| timeout | 请求等待时间过长，超过客户端超时设置 | 使用 api2 通道，或增加客户端超时设置 |
| 401 / 403 Unauthorized | API Key 无效、过期或令牌无该模型权限 | 在控制台重新生成 API Key，检查令牌权限 |
| 空回复（无文本输出） | 上游渠道异常、模型不支持或请求被截断 | 重试，或用 扣费检测工具 验证 |
| 503 Service Unavailable | 上游渠道暂时不可用 | 稍后重试，或切换渠道 |
| 模型自称 Kiro / Claude Code | 渠道方对模型名称做了别名映射 | 正常现象，不影响实际能力，无需处理 |
常见问题
不需要。如果 Claude Code 客户端支持 ANTHROPIC_BASE_URL 格式，则填 https://api2.link-ai.cc（不带 /v1）；如果客户端要求 OpenAI-compatible 格式，则填 https://api2.link-ai.cc/v1。
Claude Opus、长上下文和长输出任务生成时间超过 Cloudflare 的 120 秒超时窗口，就会报 524。建议切换 api2.link-ai.cc 直连通道，没有这个限制。
空回复通常由上游渠道异常或模型不支持导致。如果出现空回复但扣费了，可用扣费检测工具（/tools/api-billing-checker）验证。Link-AI 按实际消耗计费，失败请求扣费会在审计后自动返还。
503 表示上游渠道不可用。请求返回 503 时，理论上不应产生最终扣费，但如果站点使用了预扣费机制，可能出现预扣未返还的情况。可以用扣费检测工具验证 raw quota 变化。
这是正常的渠道映射行为。Claude Opus/Claude Sonnet 等模型通过中转渠道调用时，渠道方可能对模型名称做了别名处理，不影响实际模型能力和输出质量。
检查令牌关联的渠道是否包含目标模型。某些渠道（如 Claude Opus）可能需要单独开通或额度充足。请在控制台确认令牌权限和余额充足。
api1 适合普通请求、网页端和充值；api2 适合 Claude Opus、长上下文和长输出任务。两者共享同一套账户余额，按实际消耗扣费。
运行 curl -s https://api2.link-ai.cc/v1/models -H "Authorization: Bearer sk-你的key" | head -50，正常应返回模型列表。也可查看 Claude Code 输出中请求的 URL 是否为 api2.link-ai.cc。