> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mixroute.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code

> Claude Code CLI Integration Guide

## Install Node.js (Skip if installed)

Ensure Node.js version ≥ 18.0

<Tabs>
  <Tab title="Windows">
    Download: [https://nodejs.org/dist/v22.18.0/node-v22.18.0-x64.msi](https://nodejs.org/dist/v22.18.0/node-v22.18.0-x64.msi)
  </Tab>

  <Tab title="macOS">
    ```bash theme={null}
    sudo xcode-select --install
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    brew install node
    node --version
    ```
  </Tab>

  <Tab title="Ubuntu / Debian">
    ```bash theme={null}
    curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -
    sudo apt-get install -y nodejs
    node --version
    ```
  </Tab>
</Tabs>

### Uninstall Other Relay Clients (Optional)

Check installation location:

```bash theme={null}
npm ls @anthropic-ai/claude-code
npm ls -g @anthropic-ai/claude-code
```

To uninstall:

```bash theme={null}
npm uninstall @anthropic-ai/claude-code
npm uninstall -g @anthropic-ai/claude-code
```

## Install Claude Code

```bash theme={null}
npm install -g @anthropic-ai/claude-code
```

Verify the installation:

```bash theme={null}
claude --version
```

## Get Credentials

<Tabs>
  <Tab title="Smart Routing Node">
    <Tip>
      Smart Routing is an intelligent model routing capability that automatically assigns requests to the most suitable model based on task complexity.

      [See constraints and guidelines](/api-reference/smart-routing)
    </Tip>

    ```text theme={null}
    base_url = "https://api.mixroute.ai"
    api_key = "smart_routing-sk-xxxxx"
    model = "auto"
    ```

    <Warning>
      **Note**

      Claude Code cannot connect to models that do not use the `\v1\messages` protocol. When using Smart Routing, all routing tiers must use Claude-family models.

      For example, use claude-haiku-4.5, claude-sonnet-5, and claude-opus-5 for the simple, complex, and ultra-complex routing tiers respectively.
    </Warning>
  </Tab>

  <Tab title="Traditional Node">
    ```text theme={null}
    base_url = "https://api.mixroute.ai"
    api_key = "sk-xxxxx"
    ```
  </Tab>
</Tabs>

## Configure Environment Variables

### Basic Configuration Example

<Tip>
  For Smart Routing, set `ANTHROPIC_MODEL="auto"`
</Tip>

<Tabs>
  <Tab title="Mac / Linux">
    ```bash theme={null}
    export ANTHROPIC_BASE_URL="https://api.mixroute.ai"
    export ANTHROPIC_AUTH_TOKEN="sk-xxxxx"
    export ANTHROPIC_MODEL="kimi-k2.6"
    cd your-project-folder
    claude
    ```
  </Tab>

  <Tab title="Windows CMD">
    ```cmd theme={null}
    set ANTHROPIC_BASE_URL=https://api.mixroute.ai
    set ANTHROPIC_AUTH_TOKEN=sk-xxxxx
    set ANTHROPIC_MODEL=kimi-k2.6
    cd your-project-folder
    claude
    ```
  </Tab>

  <Tab title="Windows PowerShell">
    ```powershell theme={null}
    $env:ANTHROPIC_BASE_URL="https://api.mixroute.ai"
    $env:ANTHROPIC_AUTH_TOKEN="sk-xxxxx"
    $env:ANTHROPIC_MODEL="kimi-k2.6"
    cd your-project-folder
    claude
    ```
  </Tab>
</Tabs>

### Dual Model Configuration

Claude Code uses a dual-thread model architecture by default:

* **Main Model**: Configured via the `ANTHROPIC_MODEL` environment variable
  * Used for primary code generation, conversation, and complex tasks
* **Sub Model**: Configured via the `ANTHROPIC_DEFAULT_HAIKU_MODEL` environment variable
  * Purpose: lightweight / fast task model
  * Use cases:
    * Background tasks (file watching, linter checks, etc.)
    * Quick responses (simple questions, completion suggestions)
    * Low-priority auxiliary tasks

### Dual Model Configuration (Recommended)

<Tabs>
  <Tab title="Mac / Linux">
    ```bash theme={null}
    export ANTHROPIC_BASE_URL="https://api.mixroute.ai"
    export ANTHROPIC_AUTH_TOKEN="sk-xxxxx"
    export ANTHROPIC_MODEL="kimi-k2.6"
    export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
    cd your-project-folder
    claude
    ```
  </Tab>

  <Tab title="Windows CMD">
    ```cmd theme={null}
    set ANTHROPIC_BASE_URL=https://api.mixroute.ai
    set ANTHROPIC_AUTH_TOKEN=sk-xxxxx
    set ANTHROPIC_MODEL=kimi-k2.6
    set ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5
    cd your-project-folder
    claude
    ```
  </Tab>

  <Tab title="Windows PowerShell">
    ```powershell theme={null}
    $env:ANTHROPIC_BASE_URL="https://api.mixroute.ai"
    $env:ANTHROPIC_AUTH_TOKEN="sk-xxxxx"
    $env:ANTHROPIC_MODEL="kimi-k2.6"
    $env:ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
    cd your-project-folder
    claude
    ```
  </Tab>
</Tabs>

### Single Model Configuration (Optional)

If you only need one model, there are two configuration methods:

**Method 1: Set both environment variables to the same model**

Set both `ANTHROPIC_MODEL` and `ANTHROPIC_DEFAULT_HAIKU_MODEL` to the same model:

<Tabs>
  <Tab title="Mac / Linux">
    ```bash theme={null}
    export ANTHROPIC_BASE_URL="https://api.mixroute.ai"
    export ANTHROPIC_AUTH_TOKEN="sk-xxxxx"
    export ANTHROPIC_MODEL="kimi-k2.6"
    export ANTHROPIC_DEFAULT_HAIKU_MODEL="kimi-k2.6"
    cd your-project-folder
    claude
    ```
  </Tab>

  <Tab title="Windows CMD">
    ```cmd theme={null}
    set ANTHROPIC_BASE_URL=https://api.mixroute.ai
    set ANTHROPIC_AUTH_TOKEN=sk-xxxxx
    set ANTHROPIC_MODEL=kimi-k2.6
    set ANTHROPIC_DEFAULT_HAIKU_MODEL=kimi-k2.6
    cd your-project-folder
    claude
    ```
  </Tab>

  <Tab title="Windows PowerShell">
    ```powershell theme={null}
    $env:ANTHROPIC_BASE_URL="https://api.mixroute.ai"
    $env:ANTHROPIC_AUTH_TOKEN="sk-xxxxx"
    $env:ANTHROPIC_MODEL="kimi-k2.6"
    $env:ANTHROPIC_DEFAULT_HAIKU_MODEL="kimi-k2.6"
    cd your-project-folder
    claude
    ```
  </Tab>
</Tabs>

**Method 2: Switch the main model using commands after startup**

Keep the environment variables set as the "Dual Model Configuration" above. After starting Claude Code, enter the following in the interactive interface:

```text theme={null}
/model haiku
```

The main thread will switch to use the model configured in `ANTHROPIC_DEFAULT_HAIKU_MODEL` (i.e., `claude-haiku-4-5`).

## Troubleshooting

### Response to 400 Errors Related to Beta Fields

```text theme={null}
# Error message a 
API Error: 400 Unexpected Value(s) `advisor-tool-2026-03-01` for the `anthropic-beta` header.
# Error message b
API Error: 400 InvokeModelWithResponseStream: \
operation error bedrock Runtime: InvokeModelWithResponseStream, \
http response error StatusCode: 400 , RequestID: xxx-xxx-xxx-xxx, \
ValidationException: invalid beta flag (request id xxxxxxxx)
```

Add `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS : 1` to the settings to disable the inclusion of experimental features in the request header.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.