Claude Code

使用 CometAPI 设置 Claude Code：通过官方安装程序安装，在 settings.json 中配置 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL，并排查常见问题。

使用本指南将 Claude Code 连接到 CometAPI。

官方参考资料：

• Claude Code 概览
• Claude Code 快速开始

模型可用性会随时间变化。当前的 Claude 模型 ID，请查看 CometAPI 模型页面。

​

前置条件

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

​

安装 Claude Code

1. 运行官方安装程序

   macOS / Linux

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

   Homebrew

   brew install --cask claude-code
   

   Windows

   PowerShell:

   irm https://claude.ai/install.ps1 | iex
   

   CMD:

   curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
   

   Windows 需要先安装 Git for Windows。
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 的原生服务，这需要能够直接访问互联网。你可能需要配置系统级代理。