Claude Code

Overview

Type: Coding ToolPrimary Path: Anthropic-nativeSupport Confidence: Strong native path

Claude Code is Anthropic’s official CLI tool for AI-assisted coding. You can configure it to use AI Sonar as the API provider.

Installation

Anthropic now recommends the native installer. npm installation still exists for compatibility, but Anthropic has deprecated it.

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

If you specifically need the npm package, use:

npm install -g @anthropic-ai/claude-code

Do not use sudo npm install -g for Claude Code.

Configuration

Environment Variables

Set the following environment variables:

export ANTHROPIC_API_KEY="sk-your-api-key"
export ANTHROPIC_BASE_URL="https://api.aisonar.dev"

Add these to your shell profile (~/.bashrc, ~/.zshrc, etc.) for persistence.

For AI Sonar, keep ANTHROPIC_BASE_URL at https://api.aisonar.dev without a /v1 suffix. This matches the Anthropic-style endpoint shape and the unified gateway pattern documented by Claude Code.

Configuration File

Alternatively, create or edit ~/.claude/settings.json:

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-api-key",
    "ANTHROPIC_BASE_URL": "https://api.aisonar.dev"
  }
}

Usage

After configuration, use Claude Code normally:

# Start an interactive session
claude

# Run a single command
claude "Explain this code" < main.py

# Chat mode
claude chat

Verify the installation if needed:

claude --version
claude doctor

Available Models

AI Sonar supports all Claude models:

Model	Description
`claude-opus-4-6`	Most capable, complex reasoning
`claude-sonnet-4-6`	Balanced performance, excellent for coding
`claude-haiku-4-5`	Fastest, cost-effective

Model Selection

Specify a model with the --model flag:

claude --model claude-sonnet-4-6 "Review this PR"

Or set a default in your configuration:

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-api-key",
    "ANTHROPIC_BASE_URL": "https://api.aisonar.dev"
  },
  "model": "claude-sonnet-4-6"
}

Extended Thinking

For complex reasoning tasks, use models with extended thinking:

claude --model claude-opus-4-6 "Design a microservices architecture for..."

Troubleshooting

Connection errors

Verify the base URL is exactly https://api.aisonar.dev (no /v1 suffix for Anthropic-style requests).

Invalid API key

Ensure your AI Sonar API key starts with sk- and has sufficient balance.

Gateway requires Authorization bearer token

Claude Code’s gateway mode also supports ANTHROPIC_AUTH_TOKEN. Keep using ANTHROPIC_API_KEY for the standard AI Sonar setup unless you intentionally switched your gateway auth behavior.

Model not found

Check the model name is correct. Use claude-sonnet-4-6 format.

Compatibility Matrix

Coding Tools

Native SDKs

Frameworks & Platforms

Chat Apps

Overview

Installation

Configuration

Environment Variables

Configuration File

Usage

Available Models

Model Selection

Extended Thinking

Troubleshooting

​Overview

​Installation

​Configuration

​Environment Variables

​Configuration File

​Usage

​Available Models

​Model Selection

​Extended Thinking

​Troubleshooting

Overview

Installation

Configuration

Environment Variables

Configuration File

Usage

Available Models

Model Selection

Extended Thinking

Troubleshooting