Skip to main content
使用本指南将 Claude Code 连接到 CometAPI。 官方参考：
model 可用性会随时间变化。当前的 Claude model ID，请查看 CometAPI Models page。

​
前提条件

  • 从你的 dashboard 获取一个 CometAPI key（以 sk- 开头）
  • 已安装 Git
  • 支持的操作系统：macOS、Linux 或 Windows

​
安装 Claude Code

1

运行官方安装程序

2

验证安装

​
配置 CometAPI 端点

创建或编辑 settings 文件：
  • macOS / Linux：~/.claude/settings.json
  • Windows：%USERPROFILE%\.claude\settings.json
将 sk-your-cometapi-key 替换为你实际的 CometAPI key，然后启动 Claude Code：

​
故障排查

  1. 彻底重启你的终端：关闭所有窗口后重新打开。
  2. 如果仍然无效，创建 ~/.claude.json 并添加：
  1. 作为兜底方案，直接导出环境变量：
检查 ~/.claude/settings.json 是否存在，并确认 JSON 格式有效：没有尾随逗号、引号正确。可在 jsonlint.com 验证。
Claude Code 会优先使用缓存的官方凭证。在 Claude Code 中运行 /logout，关闭它，然后重新启动。如果仍然失败，请删除缓存的认证文件：
Claude Code 会通过 Google 检查连通性。offline 表示无法访问 Google。这不会影响 CometAPI 的使用。
Claude Code 的 Fetch 功能会先调用 Anthropic 的原生服务，这需要可直接访问互联网。你可能需要配置系统级代理。