Claude Code 常见问题
Claude Code 仍然要求登录 Anthropic
确认启动 Claude Code 的同一个终端里已经设置：
bash
echo "$ANTHROPIC_BASE_URL"
echo "$ANTHROPIC_AUTH_TOKEN"如果使用 settings.json，重启 Claude Code 后再执行 /status 检查当前配置。
返回 401 或 403
常见原因：
- API Key 错误、过期或额度不足。
- 使用了
ANTHROPIC_API_KEY而不是ANTHROPIC_AUTH_TOKEN。前者会让客户端发送x-api-key，本网关只接Authorization: Bearer。 - 请求发到了错误域名，或在
ANTHROPIC_BASE_URL末尾多写了/v1。正确的ANTHROPIC_BASE_URL是https://api.aiqizhilian.tech，不带/v1。
/model 看不到网关模型
可能原因：
- Claude Code 版本较低，自动发现能力不完整。
- 网关
/v1/models返回结构或模型名不满足 Claude Code 的发现规则。 - 模型 ID 不以
claude或anthropic开头。
处理方式：
- 先升级 Claude Code：
claude update。 - 在
settings.json顶层显式设置"model": "claude-sonnet-4-6"。 - 启动时指定：
claude --model claude-sonnet-4-6。
Token 统计或上下文预估异常
Claude Code 官方要求网关完整支持 /v1/messages/count_tokens。
如果该接口在网关上不可用，普通对话可能仍能工作，但：
- token 预估
- 上下文窗口提示
- 部分高级能力（如智能截断）
可能不完整。如对这些功能有强需求，请通过下方邮箱确认接口支持情况。
工具调用、thinking 或 beta 功能异常
这些能力依赖：
- Claude Code 版本
- 上游模型能力
- 请求头透传（
anthropic-beta、anthropic-version） - 网关兼容性
生产使用前需要按实际场景单独验收。如遇到问题，可在 claude --debug 模式下抓取请求/响应日志后反馈给运营方。
后台任务静默失败
症状：Claude Code 在执行 commit message 生成、长会话压缩、agent 任务摘要时报错或行为异常。
原因：Claude Code 后台任务默认使用 haiku 档位模型，如果 ANTHROPIC_DEFAULT_HAIKU_MODEL 未设置或指向了网关不存在的模型，相关任务会失败。
处理：在 settings.json 的 env 中显式设置：
json
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001"也可以暂时把 haiku 档位指到 sonnet：
json
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-4-6"流式响应中断
可能原因：
- Cloudflare 边缘或源站 HTTP/2 空闲超时。
- 客户端读取慢于服务端推送。
- 上游 Anthropic 端异常。
建议：升级到最新 Claude Code；持续重现请把 claude --debug 日志发邮件反馈。
报告问题
发到 info@aiqizhilian.tech，附：
- Claude Code 版本（
claude --version） ~/.claude/settings.json中env段（脱敏掉 Token）- 复现命令与时间
claude --debug输出片段（脱敏掉 Token）