Claude Code 常见问题

Q：Claude Code 的 Base URL 需要加 /v1 吗？

不需要。 Claude Code 使用 Anthropic SDK，Base URL 直接填：

https://apiaifirst.com

不要填 https://apiaifirst.com/v1，否则会报错。

Q：设置了环境变量但 Claude Code 没生效？

1. 确认你设置的是 ANTHROPIC_BASE_URL 而不是 OPENAI_BASE_URL
2. 确认环境变量已经生效（重新打开终端，或运行 source ~/.zshrc）
3. 验证环境变量：

echo $ANTHROPIC_BASE_URL
# 应该输出：https://apiaifirst.com
 
echo $ANTHROPIC_API_KEY
# 应该输出：sk-xxx

Q：报错 "Could not connect to API"

1. 检查网络连接
2. 确认 ANTHROPIC_BASE_URL 设置正确
3. 运行连通性测试：

curl https://apiaifirst.com/health

Q：报错 "Invalid API Key"

1. 检查 ANTHROPIC_API_KEY 是否正确
2. 确认 Key 前后没有多余的空格或换行
3. 在 控制台 (opens in a new tab) 确认密钥状态为「启用」

Q：Claude Code 响应很慢？

• 首次连接可能需要几秒建立 TLS 握手，后续请求会快很多
• AiFirst 已接入 Cloudflare CDN 全球加速
• 如果持续很慢，可以尝试切换网络环境

Q：如何在 VS Code 中使用 Claude Code？

安装 VS Code 的 Claude Code 扩展后，在扩展设置中配置：

• API Base URL：https://apiaifirst.com
• API Key：你的 AiFirst API Key

或者在 VS Code 的 settings.json 中添加：

{
  "claude-code.env": {
    "ANTHROPIC_BASE_URL": "https://apiaifirst.com",
    "ANTHROPIC_API_KEY": "sk-xxx"
  }
}

Q：如何切换不同的模型？

Claude Code 默认使用 Claude Sonnet 模型。如需切换，可以在启动时指定：

claude --model claude-sonnet-4-6