Claude Code

Set up Claude Code with CometAPI: install via official installer, configure ANTHROPIC_AUTH_TOKEN and ANTHROPIC_BASE_URL in settings.json, and troubleshoot common issues.

Use this guide to connect Claude Code to CometAPI.

Official references:

• Claude Code Overview
• Claude Code Getting Started

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

   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 requires Git for Windows installed first.
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.