> ## 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連携ガイド

## Node.jsをインストール（インストール済みの場合はスキップ）

Node.jsのバージョンが18.0以上であることを確認してください

<Tabs>
  <Tab title="Windows">
    ダウンロード：[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>

### 他の中継クライアントのアンインストール（任意）

インストール先を確認：

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

アンインストールするには：

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

## Claude Codeのインストール

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

インストールを確認します。

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

## 認証情報の取得

<Tabs>
  <Tab title="スマートルーティングノード">
    <Tip>
      スマートルーティングは、タスクの複雑さに基づいて、最適なモデルにリクエストを自動的に割り当てるインテリジェントなモデルルーティング機能です。

      [制約とガイドラインを確認](/ja/api-reference/smart-routing)
    </Tip>

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

    <Warning>
      **注**

      Claude Codeは、`/v1/messages`プロトコルを使用しないモデルには接続できません。スマートルーティングを使用する場合は、すべてのルーティングティアでClaudeファミリーのモデルを使用する必要があります。

      たとえば、シンプル、複雑、超複雑の各ルーティング階層に、それぞれclaude-haiku-4.5、claude-sonnet-5、claude-opus-5を使用します。
    </Warning>
  </Tab>

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

## 環境変数の設定

### 基本的な設定例

<Tip>
  スマートルーティングには`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>

### デュアルモデル設定

Claude Codeは、デフォルトでデュアルスレッドのモデルアーキテクチャを使用します。

* **メインモデル**：環境変数`ANTHROPIC_MODEL`で設定
  * 主要なコード生成、会話、複雑なタスクに使用します
* **サブモデル**：`ANTHROPIC_DEFAULT_HAIKU_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="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>

### 単一モデルの設定（任意）

1つのモデルだけが必要な場合、設定方法は2つあります。

**方法1：両方の環境変数を同じモデルに設定する**

`ANTHROPIC_MODEL`と`ANTHROPIC_DEFAULT_HAIKU_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>

**方法2: 起動後にコマンドでメインモデルを切り替える**

環境変数は上記の「デュアルモデル設定」のままにしてください。Claude Codeの起動後、対話型インターフェースに次を入力します。

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

メインスレッドは、`ANTHROPIC_DEFAULT_HAIKU_MODEL`に設定されたモデル（つまり`claude-haiku-4-5`）を使用するように切り替わります。

## トラブルシューティング

### ベータフィールドに関連する400エラーへの対処

```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)
```

設定に`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS : 1`を追加し、リクエストヘッダーに実験的機能が含まれないようにします。


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