How to Integrate CCAPI into Claude Code

This guide helps you connect Claude Code (Anthropic's official AI coding assistant) to CCAPI, allowing you to use Claude models at a lower price.

Claude Code is Anthropic's AI coding CLI tool, supporting code generation, debugging, refactoring, Git operations, and more.

Prerequisites

Claude Code installed — refer to the official docs for installation

CCAPI account — sign up at ccapi.ai (Google login supported)

CCAPI token — create one at Console > Tokens

Step 1: Get Your CCAPI Token

Go to ccapi.ai and sign up / log in

Navigate to Console > Tokens

Click Create Token, copy the key (shown only once)

Step 2: Configure Claude Code

Method A: Config File (Recommended)

Edit ~/.claude/settings.json and add:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.ccapi.ai",
    "ANTHROPIC_API_KEY": "your-ccapi-token"
  }
}

Note: Do not append /v1 to the Base URL. Claude Code automatically appends /v1/messages.

Method B: Environment Variables

Add to ~/.bashrc or ~/.zshrc:

Restart your terminal for changes to take effect.

Step 3: Choose a Model (Optional)

CCAPI supports the following Claude models at as low as 20% of official pricing:

Model	Description
`claude-sonnet-4-6`	Latest Sonnet, balanced choice
`claude-opus-4-6`	Latest Opus, highest quality
`claude-haiku-4-5-20251001`	Haiku, fastest and cheapest
`claude-sonnet-4-5`	Sonnet 4.5
`claude-opus-4-5`	Opus 4.5

You can specify default models in settings.json:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.ccapi.ai",
    "ANTHROPIC_API_KEY": "your-ccapi-token",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001"
  }
}

For the full model list and real-time pricing, visit Model Market.

Step 4: Verify

Launch Claude Code:

Test with a simple prompt:

Hello, please introduce yourself

If it responds normally, the setup is complete. You can check call logs at Console > Logs.

Troubleshooting

Problem	Solution
`model not found` error	Model names must be typed in full (e.g. `claude-sonnet-4-6`). Not appearing in the auto-list is normal
Base URL path error	Ensure it's set to `https://api.ccapi.ai` without `/v1`
Invalid token	Check token status at Console
Insufficient balance	Top up at Console > Top Up

Quick Reference

Base URL: https://api.ccapi.ai (without /v1)

Auth env var: ANTHROPIC_API_KEY

Config file: ~/.claude/settings.json

Model Market: ccapi.ai/pricing

Console: ccapi.ai/console

claude code integration

How to Integrate CCAPI into Claude Code#

Prerequisites#

Step 1: Get Your CCAPI Token#

Step 2: Configure Claude Code#

Method A: Config File (Recommended)#

Method B: Environment Variables#

Step 3: Choose a Model (Optional)#

Step 4: Verify#

Troubleshooting#

Quick Reference#