跳转到主要内容
使用本指南将 Claude Code 连接到 CometAPI。 官方参考资料：
模型可用性会随时间变化。当前的 Claude 模型 ID，请查看 CometAPI 模型页面。

​
前置条件

  • 来自你的 控制台 的 CometAPI key（以 sk- 开头）
  • 已安装 Git
  • 支持的操作系统：macOS、Linux 或 Windows

​
安装 Claude Code

1

运行官方安装程序

curl -fsSL https://claude.ai/install.sh | bash
2

验证安装

claude --version

​
配置 CometAPI 端点

创建或编辑设置文件：
  • macOS / Linux：~/.claude/settings.json
  • Windows：%USERPROFILE%\.claude\settings.json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-cometapi-key",
    "ANTHROPIC_BASE_URL": "https://api.cometapi.com"
  }
}
将 sk-your-cometapi-key 替换为你的实际 CometAPI key，然后启动 Claude Code： 
cd your-project
claude

​
故障排查

settings.json 没有生效？
  1. 完全重启终端（关闭所有窗口后重新打开）
  2. 如果仍然无效，创建 ~/.claude.json 并添加： 
    {
  "hasCompletedOnboarding": true
}
  3. 作为兜底方案，直接导出环境变量： 
    # Add to ~/.zshrc (macOS) or ~/.bashrc (Linux)
export ANTHROPIC_AUTH_TOKEN="sk-your-cometapi-key"
export ANTHROPIC_BASE_URL="https://api.cometapi.com"
出现 Invalid API Key 或 Please run /login？ 检查 ~/.claude/settings.json 是否存在，以及 JSON 格式是否有效（没有尾随逗号、引号正确）。可在 jsonlint.com 验证。 之前登录过 Anthropic 官方账户？ Claude Code 会优先使用缓存的官方凭据。在 Claude Code 内运行 /logout，关闭程序后再重新启动。如果仍然失败： 
rm -rf ~/.config/claude-code/auth.json
状态显示为 offline？ Claude Code 会通过 Google 检查连通性。offline 只表示无法访问 Google——这不会影响 CometAPI 的使用。 Fetch / 网页浏览失败？ Claude Code 的 Fetch 功能会先调用 Anthropic 的原生服务，这需要能够直接访问互联网。你可能需要配置系统级代理。