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

# Claude Code で APIMart を使用する

> Claude Code CLI で APIMart API サービスを設定・使用する方法を詳しく解説します。簡単な設定でターミナルから複数の AI モデルを呼び出してプログラミングを支援します。

<Frame>
  <img src="https://mintcdn.com/apicore/_4UKBib4iqrgK4Ws/images/integrations/claude-code/claude-code-cli.png?fit=max&auto=format&n=_4UKBib4iqrgK4Ws&q=85&s=219739f4029aa915b90253ad02b01437" alt="Claude Code メインインターフェース" width="2574" height="360" data-path="images/integrations/claude-code/claude-code-cli.png" />
</Frame>

## 準備

Claude Code は Anthropic が提供するコマンドライン AI プログラミングアシスタントで、ターミナルから直接 AI との対話、コード生成、デバッグなどが可能です。
APIMart を接続することで、GPT、Claude、Gemini など複数のモデルを Claude Code で利用できます。

始める前に、以下をご確認ください：

1. **APIMart API キーを取得済み**
   [APIMart コンソール](https://apimart.ai/keys) にログインして API キーを取得してください（`sk-` で始まります）

<Note>**ヒント：** APIMart アカウントをお持ちでない場合は、まず [APIMart](https://apimart.ai) で登録して API キーを取得してください。</Note>

## ステップ 1：Claude Code をインストール

以下のいずれかの方法でインストールしてください：

<Tabs>
  <Tab title="macOS / Linux（推奨）">
    公式スクリプトでインストール：

    ```bash theme={null}
    curl -fsSL https://claude.ai/install.sh | bash
    ```

    Homebrew でもインストール可能：

    ```bash theme={null}
    brew install --cask claude-code
    ```

    <Note>権限エラーが発生した場合は、コマンドの前に `sudo` を付けてください。</Note>
  </Tab>

  <Tab title="Windows">
    **PowerShell：**

    ```powershell theme={null}
    irm https://claude.ai/install.ps1 | iex
    ```

    **CMD：**

    ```cmd theme={null}
    curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
    ```
  </Tab>

  <Tab title="NPM インストール">
    Node.js 18 以降がインストール済みの場合、npm でインストールできます：

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

    すべての OS で利用可能です。
  </Tab>
</Tabs>

### インストールの確認

インストール後、以下のコマンドで確認します：

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

バージョン番号（例：`1.x.x`）が表示されればインストール成功です。

## ステップ 2：APIMart API を設定

3 つの設定方法を用意しています。お好みに合わせてお選びください。

### 方法 1：settings.json を編集（推奨）

最も安定した方法で、一度設定すれば永続的に有効です。

**1. 設定ディレクトリを開く：**

* Windows：`Win + R` を押し、`%userprofile%\.claude` と入力
* macOS：`Command + Shift + G` を押し、`~/.claude` と入力
* Linux：`~/.claude` ディレクトリに移動

<Note>ディレクトリが存在しない場合は、ターミナルで `claude` を一度実行し、`Ctrl + C` で終了すると自動的に作成されます。</Note>

**2. `settings.json` ファイルを作成または編集：**

```json theme={null}
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apimart.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxx",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6-apimart",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}
```

| パラメータ                                      | 説明                                           |
| ------------------------------------------ | -------------------------------------------- |
| `ANTHROPIC_BASE_URL`                       | APIMart API アドレス、`https://api.apimart.ai` 固定 |
| `ANTHROPIC_AUTH_TOKEN`                     | APIMart API キー（`sk-` で始まる）                   |
| `ANTHROPIC_MODEL`                          | 使用するデフォルトモデル、下記のモデル一覧から選択                    |
| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | `1` に設定すると不要なネットワークリクエストを削減                  |

ファイルを保存後、Claude Code を再起動すると反映されます。

### 方法 2：永続環境変数

システム環境に設定を書き込み、すべてのターミナルウィンドウで自動的に読み込まれます。

<Tabs>
  <Tab title="macOS (zsh)">
    ```bash theme={null}
    echo 'export ANTHROPIC_BASE_URL="https://api.apimart.ai"' >> ~/.zshrc
    echo 'export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"' >> ~/.zshrc
    echo 'export ANTHROPIC_MODEL="claude-sonnet-4-6-apimart"' >> ~/.zshrc
    source ~/.zshrc
    ```
  </Tab>

  <Tab title="macOS / Linux (bash)">
    ```bash theme={null}
    echo 'export ANTHROPIC_BASE_URL="https://api.apimart.ai"' >> ~/.bashrc
    echo 'export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"' >> ~/.bashrc
    echo 'export ANTHROPIC_MODEL="claude-sonnet-4-6-apimart"' >> ~/.bashrc
    source ~/.bashrc
    ```
  </Tab>

  <Tab title="Windows">
    **方法 A：GUI で設定**

    1.「PC」を右クリック →「プロパティ」→「システムの詳細設定」→「環境変数」
    2\. ユーザー変数に以下を新規作成：

    * `ANTHROPIC_BASE_URL` = `https://api.apimart.ai`
    * `ANTHROPIC_API_KEY` = `sk-xxxxxxxxxxxx`
    * `ANTHROPIC_MODEL` = `claude-sonnet-4-6-apimart`

    3. ターミナルを再起動

    **方法 B：PowerShell コマンドで設定**

    ```powershell theme={null}
    [System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://api.apimart.ai', 'User')
    [System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'sk-xxxxxxxxxxxx', 'User')
    [System.Environment]::SetEnvironmentVariable('ANTHROPIC_MODEL', 'claude-sonnet-4-6-apimart', 'User')
    ```
  </Tab>
</Tabs>

### 方法 3：一時環境変数

テストや短期利用に適しています。ターミナルを閉じると設定は失われます。

<Tabs>
  <Tab title="macOS / Linux">
    ```bash theme={null}
    export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"
    export ANTHROPIC_MODEL="claude-sonnet-4-6-apimart"
    export ANTHROPIC_BASE_URL="https://api.apimart.ai"
    claude
    ```
  </Tab>

  <Tab title="Windows (PowerShell)">
    ```powershell theme={null}
    $env:ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"
    $env:ANTHROPIC_MODEL="claude-sonnet-4-6-apimart"
    $env:ANTHROPIC_BASE_URL="https://api.apimart.ai"
    claude
    ```
  </Tab>

  <Tab title="Windows (CMD)">
    ```cmd theme={null}
    set ANTHROPIC_API_KEY=sk-xxxxxxxxxxxx
    set ANTHROPIC_MODEL=claude-sonnet-4-6-apimart
    set ANTHROPIC_BASE_URL=https://api.apimart.ai
    claude
    ```
  </Tab>
</Tabs>

<Warning>一時環境変数は現在のターミナルウィンドウでのみ有効です。ウィンドウを切り替えたり閉じたりした場合は再設定が必要です。</Warning>

## ステップ 3：使い始める

### 設定の確認

Claude Code を起動し、簡単なメッセージを送って設定が正しいか確認します：

```bash theme={null}
claude "こんにちは"
```

AI から返答があれば設定成功です。`401`、`403` などのエラーが表示された場合は、下記の FAQ を参照してください。

### 使い方

Claude Code には 2 つのモードがあります：

* **対話モード**：`claude` を実行して継続的な対話に入る。複雑なタスクに最適
* **単発コマンド**：`claude "質問"` で一回限りの回答を取得。素早い質問に最適

### 対応モデル

APIMart は Claude モデルシリーズを完全にサポートしています。タスクに応じて柔軟に切り替えられます：

| モデル名                         | 特徴         | 推奨用途               |
| ---------------------------- | ---------- | ------------------ |
| `claude-opus-4-6`            | 最強の総合能力    | 複雑なアーキテクチャ、難解なデバッグ |
| `claude-sonnet-4-6`          | 性能と速度のバランス | 日常的なプログラミング、コード生成  |
| `claude-opus-4-5-20251101`   | 高度な推論能力    | 複雑なコード、深い分析        |
| `claude-sonnet-4-5-20250929` | 優れたコード能力   | アルゴリズム設計、コード最適化    |
| `claude-haiku-4-5-20251001`  | 超高速レスポンス   | クイック Q\&A、コードスニペット |

上記のすべてのモデルは Thinking（拡張思考）バージョンに対応しています。モデル ID の末尾に `-thinking` を付けるだけで有効になります（例：`claude-opus-4-6-thinking`）。複雑なタスクで深い推論が必要な場合に最適です。

#### APIMart 割引モデル

APIMart は専用の割引モデルを提供しており、**価格は公式の 20% のみ**で、能力は公式モデルと同等です。モデル ID の末尾に `-apimart` を付けるだけで利用できます：

| 割引モデル名                               | 特徴         |
| ------------------------------------ | ---------- |
| `claude-opus-4-6-apimart`            | 最強の総合能力    |
| `claude-sonnet-4-6-apimart`          | 性能と速度のバランス |
| `claude-opus-4-5-20251101-apimart`   | 高度な推論能力    |
| `claude-sonnet-4-5-20250929-apimart` | 優れたコード能力   |
| `claude-haiku-4-5-20251001-apimart`  | 超高速レスポンス   |

Thinking バージョンも対応しています（例：`claude-opus-4-6-thinking-apimart`、`claude-sonnet-4-6-thinking-apimart` など）。

<Tip>
  **モデル選択のおすすめ：**

  * 💰 **コスパ最強：** `claude-sonnet-4-6-apimart` — 日常プログラミングに最適、公式価格の 20%
  * 🚀 **高性能：** `claude-opus-4-6-apimart` — 最も複雑なコードやアーキテクチャの課題に
  * ⚡ **高速レスポンス：** `claude-haiku-4-5-20251001-apimart` — 即時フィードバックが必要な時に
  * 🧠 **深い思考：** `claude-opus-4-6-thinking-apimart` — 深い推論が必要な時に
</Tip>

モデルを切り替えるには、対話モードで `/model` コマンドを使用するか、設定の `ANTHROPIC_MODEL` フィールドを変更して再起動してください。

### よく使うコマンド

Claude Code でよく使うコマンドとショートカット：

| コマンド               | 説明             |
| ------------------ | -------------- |
| `claude`           | 対話モードに入る       |
| `claude "質問"`      | 単発の質問          |
| `claude --version` | バージョンを確認       |
| `/model`           | 対話モードでモデルを切り替え |
| `/help`            | ヘルプ情報を表示       |
| `Ctrl + C`         | 対話モードを終了       |

## よくある質問

### Q1: 設定後もログイン選択画面が表示される？

起動後に「Select login method」が表示される場合、設定が反映されていません。

**確認手順：**

1. **settings.json 方式の場合**：ファイルパスが正しいか確認
   * Windows：`C:\Users\<ユーザー名>\.claude\settings.json`
   * macOS / Linux：`~/.claude/settings.json`
2. **環境変数方式の場合**：変数を設定した**同じターミナルウィンドウ**で Claude Code を起動しているか確認
3. **JSON フォーマットの確認**：括弧、カンマ、引用符が正しいか確認

### Q2: 401 / 403 エラーが発生する？

| エラーコード             | 意味              | 解決方法                                       |
| ------------------ | --------------- | ------------------------------------------ |
| `401 Unauthorized` | API キーが無効または未設定 | キーが正しく `sk-` で始まるか確認                       |
| `403 Forbidden`    | 権限不足またはキー期限切れ   | [コンソール](https://apimart.ai/keys) でキーの状態を確認 |

`ANTHROPIC_BASE_URL` が `https://api.apimart.ai` に設定されていることも確認してください（Anthropic 公式アドレスではなく）。

### Q3:「Unable to connect」接続エラーが出る？

Claude Code が API サービスに接続できていません。

1. ネットワーク接続が正常か確認
2. `ANTHROPIC_BASE_URL` の設定が正しいか確認
3. プロキシを使用している場合、`api.apimart.ai` へのアクセスが許可されているか確認

### Q4:「Auth conflict」認証の競合エラーが出る？

以下のようなメッセージが表示された場合：

```
Auth conflict: Both a token (claude.ai) and an API key (ANTHROPIC_API_KEY) are set.
```

claude.ai アカウントへのログインと API Key の設定が同時に存在し、競合しています。

**解決方法：** Claude Code の対話モードで `/logout` を実行し、claude.ai からログアウトしてください。API Key の設定のみを残します。

### Q5: 非 Claude モデル使用時に max\_tokens エラーが出る？

以下のようなエラーが表示された場合：

```
max_tokens is too large: 32000. This model supports at most 16384 completion tokens.
```

Claude Code はデフォルトで Claude モデルのパラメータ（32000 tokens）でリクエストを送信するため、一部の非 Claude モデル（例：`gpt-4o`）ではトークン制限を超えてしまいます。

**解決方法：** Claude モデル（例：`claude-sonnet-4-6-apimart`）に切り替えてください。Claude Code とネイティブに互換性があり、この問題は発生しません。

### Q6: レスポンスが遅い？

1. より高速なモデルに切り替える（例：`claude-haiku-4-5-20251001-apimart` または `claude-sonnet-4-6-apimart`）
2. プロンプトを短くしてコンテキスト長を削減
3. ネットワーク状況を確認

### Q7: モデルを切り替えるには？

2 つの方法：

1. **対話モードで**：`/model` コマンドを入力
2. **設定を変更**：`settings.json` または環境変数の `ANTHROPIC_MODEL` フィールドを変更し、Claude Code を再起動

### Q8: Claude Code はローカルファイルを自動的に読み取る？

いいえ。Claude Code はファイルを明示的に参照する必要があり、機密操作の実行前には確認を求めます。専用のプロジェクトディレクトリで使用することをお勧めします。

### Q9: ローカルファイルを分析するには？

対話モードで、以下の方法でファイルを参照できます：

* ファイルパスを直接入力
* ファイルをターミナルウィンドウにドラッグ&ドロップ
* ファイル内容をコピー＆ペースト

### Q10: 使用状況とコストを確認するには？

[APIMart コンソール](https://apimart.ai/overview) にログインして確認：

* API コール統計
* トークン消費明細
* コスト統計とトレンド

## サポート

ご利用中に問題が発生した場合：

* 📚 [APIMart ドキュメント](https://docs.apimart.ai)
* 💬 [Discord コミュニティ](https://discord.gg/V8zqssyZ5c)
* 🐦 [Twitter @APIMart\_](https://x.com/APIMart_)
* 📧 技術サポート：[zhihong@apimart.ai](mailto:zhihong@apimart.ai)

***

<Card title="APIMart を始めよう" icon="rocket" href="https://apimart.ai">
  今すぐ APIMart に登録して API キーを取得し、Claude Code でマルチモデルプログラミングアシスタントを体験！
</Card>
