Claude Code API 为什么会超时、空回复或 503？稳定通道怎么选

Claude Code 为什么比普通聊天更容易超时

Claude Code 是一个 Agent 工具，它的工作方式与普通聊天有本质区别：

• 多轮 API 调用：一个任务可能触发数十次 API 请求
• 长上下文处理：需要读取、分析大量文件内容并发送给模型
• 长输出生成：生成代码、重构系统等输出量很大
• 任务执行时间长：一个完整任务可能持续数分钟到数十分钟

这些特点叠加起来，很容易超过 Cloudflare 默认的 120 秒超时限制。

长上下文、长输出、Agent 任务的耗时特点

api1 为什么适合普通请求

https://api1.link-ai.cc/v1 适合：

• 普通聊天和快速问答
• 单轮或少量多轮对话
• 短文本生成和翻译
• 测试和调试

api1 走 Cloudflare 标准通道，响应速度快，但超时限制严格。

api2 为什么适合长请求

https://api2.link-ai.cc/v1 提供：

• 直连通道，绕过部分 Cloudflare 超时限制
• 长任务优先队列
• 更宽松的连接保持策略
• 更适合 Claude Code、Codex CLI 等工具

503 和 524 的区别

推荐配置

Claude Code 配置

# 在 Claude Code 的 .env 或环境变量中设置
ANTHROPIC_BASE_URL="https://api2.link-ai.cc"
ANTHROPIC_AUTH_TOKEN="sk-你的APIKey"

验证配置是否生效

# 测试 API 是否可达
curl https://api2.link-ai.cc/v1/models \
  -H "Authorization: Bearer sk-你的APIKey"

# 应该返回模型列表，包含 claude-3-opus、claude-3-sonnet 等

如果仍然 524，尝试

• 减少单次任务的上下文量（减少发送给模型的文件数量）
• 降低 max_tokens 限制
• 分多次小任务而不是一次大任务
• 参考 524 完整排查指南

空回复是否应该扣费

如果请求返回空回复（completion_tokens: 0），需要判断原因：

• prompt 本身有问题：模型无法从 prompt 生成有效回复，用户承担预扣费是合理的
• 503/524 导致请求失败：服务端错误导致无输出，理论上中转站不应让用户承担预扣费
• 渠道质量问题：上游返回异常，中转站应该处理并返还预扣费

判断方法：用 API 扣费检测工具 检查 raw quota 数据，对比页面余额和实际消耗。

FAQ