Skip to main content
Use this guide to connect Claude Code to CometAPI. Official references:
Model availability changes over time. For current Claude model IDs, check the CometAPI Models page.

​
Prerequisites

  • A CometAPI key from your dashboard (starts with sk-)
  • Git installed
  • Supported OS: macOS, Linux, or Windows

​
Install Claude Code

1

Run the official installer

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

Verify installation

claude --version

​
Configure CometAPI endpoint

Create or edit the settings file:
  • 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"
  }
}
Replace sk-your-cometapi-key with your actual CometAPI key, then start Claude Code: 
cd your-project
claude

​
Troubleshooting

settings.json not taking effect?
  1. Restart your terminal completely (close all windows and reopen)
  2. If still not working, create ~/.claude.json and add: 
    {
  "hasCompletedOnboarding": true
}
  3. As a fallback, export environment variables directly: 
    # 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 or Please run /login? Check that ~/.claude/settings.json exists and the JSON format is valid (no trailing commas, correct quotes). Validate at jsonlint.com. Previously logged into Anthropic official? Claude Code prioritizes cached official credentials. Run /logout inside Claude Code, close it, then restart. If still failing: 
rm -rf ~/.config/claude-code/auth.json
Status shows offline? Claude Code checks connectivity via Google. offline just means Google is unreachable — this does not affect CometAPI usage. Fetch / web browsing fails? Claude Code’s Fetch feature calls Anthropic’s native service first, which requires direct internet access. A system-wide proxy may be needed.