> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.beatapi.io/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server. # Claude Code で BeatAPI を使う > Claude Code の接続先を BeatAPI に設定し、1 つのキーでアカウントのすべての Claude モデルを利用します。 # Claude Code で BeatAPI を使う Claude Code は、ファイルの読み書き、コマンド実行、ターミナルでの一連の作業を行うコーディングエージェントです。BeatAPI が `POST /v1/messages` で直接提供する Anthropic Messages 形式を使うため、変換層は不要で、ベース URL を変更するだけで接続できます。 ## 前提条件 1. **Claude Code がインストールされていること。** 未導入ならステップ 1 を参照してください。 2. **BeatAPI API キー。** [ダッシュボード → API キー](https://beatapi.io/dashboard/apikeys)で作成します。 ## ステップ 1：Claude Code をインストールする #### macOS / Linux 公式スクリプトでインストールします。 ```bash curl -fsSL https://claude.ai/install.sh | bash ``` Homebrew も利用できます。 ```bash brew install --cask claude-code ``` #### Windows PowerShell の場合。 ```powershell irm https://claude.ai/install.ps1 | iex ``` CMD の場合。 ```cmd curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd ``` #### npm Node.js 18 以降があれば、どの OS でも利用できます。 ```bash npm install -g @anthropic-ai/claude-code ``` インストールを確認します。 ```bash claude --version ``` ## ステップ 2：接続先を BeatAPI にする 設定の持続性が高い順に 3 つの方法を紹介します。いずれかを選んでください。 ### 方法 1：settings.json 最も安定した方法です。一度設定すると、ターミナルを変えても維持されます。 設定ディレクトリを確認します。 * macOS / Linux は `~/.claude`。 * Windows は `%userprofile%\.claude`。 存在しない場合は `claude` を一度実行し、`Ctrl + C` で終了すると作成されます。 `settings.json` を作成、または編集します。 ```json { "env": { "ANTHROPIC_BASE_URL": "https://api.beatapi.io", "ANTHROPIC_AUTH_TOKEN": "", "ANTHROPIC_MODEL": "claude-fable-5-1", "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1" } } ``` | 変数 | 値 | | ------------------------------------------ | ----------------------------------------------------------------- | | `ANTHROPIC_BASE_URL` | `https://api.beatapi.io`。クライアントが `/v1/messages` を付加するため `/v1` は不要 | | `ANTHROPIC_AUTH_TOKEN` | BeatAPI API キー | | `ANTHROPIC_MODEL` | 下の表のモデル ID | | `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | `1` でバックグラウンドのリクエストを減らす | 保存し、Claude Code を再起動します。 ### 方法 2：永続的な環境変数 #### macOS (zsh) ```bash echo 'export ANTHROPIC_BASE_URL="https://api.beatapi.io"' >> ~/.zshrc echo 'export ANTHROPIC_AUTH_TOKEN=""' >> ~/.zshrc echo 'export ANTHROPIC_MODEL="claude-fable-5-1"' >> ~/.zshrc source ~/.zshrc ``` #### Linux (bash) ```bash echo 'export ANTHROPIC_BASE_URL="https://api.beatapi.io"' >> ~/.bashrc echo 'export ANTHROPIC_AUTH_TOKEN=""' >> ~/.bashrc echo 'export ANTHROPIC_MODEL="claude-fable-5-1"' >> ~/.bashrc source ~/.bashrc ``` #### Windows (PowerShell) ```powershell [System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://api.beatapi.io', 'User') [System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', '', 'User') [System.Environment]::SetEnvironmentVariable('ANTHROPIC_MODEL', 'claude-fable-5-1', 'User') ``` 設定後にターミナルを再起動します。 ### 方法 3：現在のターミナルだけに設定する 簡単なテストに適しています。ターミナルを閉じると設定は失われます。 ```bash export ANTHROPIC_BASE_URL="https://api.beatapi.io" export ANTHROPIC_AUTH_TOKEN="" export ANTHROPIC_MODEL="claude-fable-5-1" claude ``` ## ステップ 3：確認して作業を始める ```bash claude "Hello" ``` 応答が返れば設定が反映されています。ログイン画面、`401`、`403` が出る場合は、下の FAQ を確認してください。 Claude Code には 2 つの利用モードがあります。 * **対話モード**は `claude` で継続するセッションを開始し、複数段階の作業に使います。 * **単発モード**は `claude "your question"` で 1 回の回答を取得します。 ## モデル アカウントのすべての Claude モデルを同じキーで利用できます。対話セッションでは `/model`、または `ANTHROPIC_MODEL` を変更して再起動すると切り替わります。 | モデル ID | 用途 | | --------------------------- | ---------------------------------------- | | `claude-fable-5-1` | 最新世代。エージェントによるコーディングの標準選択 | | `claude-opus-5` | 最も高度な推論。難しい設計やデバッグ | | `claude-sonnet-5-5` | コーディングとエージェントワークフロー。1M コンテキスト、最大 128K 出力 | | `claude-sonnet-5` | 日常作業での性能と速度のバランス | | `claude-haiku-4-5-20251001` | 最速、最安。簡単な編集や大量の処理 | 各料金は[料金ページ](https://beatapi.io/pricing)、リクエスト形式は [Claude API](/text-api/claude) を参照してください。 ### Sonnet 5.5 を設定する 次の値を `~/.claude/settings.json` の既存の設定に追加し、キーのプレースホルダーを置き換えてから Claude Code を再起動します。 ```json { "env": { "ANTHROPIC_BASE_URL": "https://api.beatapi.io", "ANTHROPIC_AUTH_TOKEN": "", "ANTHROPIC_MODEL": "claude-sonnet-5-5" } } ``` Sonnet 5.5 は標準で adaptive thinking を使います。思考とツールの設定は Claude Code に任せてください。上限と現在のトークン料金は [Sonnet 5.5 モデルガイド](/text-api/claude-sonnet-5-5)を参照してください。 ## よく使うコマンド | コマンド | 内容 | | ------------------- | --------------- | | `claude` | 対話モードを開始 | | `claude "question"` | 1 回の問い合わせ | | `claude --version` | バージョンを表示 | | `/model` | セッション内でモデルを切り替え | | `/help` | ヘルプを表示 | | `Ctrl + C` | 対話モードを終了 | ## よくある質問 ### 設定後もログイン画面が表示されます 設定が反映されていません。 1. `settings.json` の場合は、`~/.claude/settings.json`（Windows は `%userprofile%\.claude\settings.json`）にあるか確認します。 2. 環境変数の場合は、設定したターミナルから Claude Code を起動したか確認します。 3. JSON の括弧が対応しているか、末尾カンマがないか、装飾付きでない通常の引用符かを確認します。 ### 401 または 403 | ステータス | 意味 | 対処 | | ----- | ----------------------------------------------------------------- | -------------------------------------------------------------- | | `401` | `missing_api_key` または `invalid_api_key`。キーが未指定、不正、期限切れ、無効、または上限到達 | [ダッシュボード → API キー](https://beatapi.io/dashboard/apikeys)で有効か確認 | | `403` | `forbidden`。無料クレジットだけの場合など、キーまたはアカウントがモデルを利用できない | アカウントの状態と指定モデルを確認 | `ANTHROPIC_BASE_URL` がモデル提供元の URL ではなく、`https://api.beatapi.io` になっているかも確認してください。 ### 起動時に「Auth conflict」が表示されます ``` Auth conflict: Both a token (claude.ai) and an API key (ANTHROPIC_API_KEY) are set. ``` 公式アカウントのログインと API キーが同時に設定されています。Claude Code 内で `/logout` を実行し、セッションを終了してキーを残してください。 ### 402 insufficient\_credits 残高が 0、またはリクエストの料金に不足しています。ダッシュボードからチャージしてください。実行中のリクエストは待機列に入らず、失敗します。 ### 429 rate\_limit\_exceeded キーのリクエスト数が上限を超えました。BeatAPI が返す `Retry-After` の時間を待って再試行してください。毎分の上限はチャージ累計額に応じて増え、ダッシュボードに表示されます。 ### 接続に失敗します 1. ネットワーク接続を確認します。 2. `ANTHROPIC_BASE_URL` に誤字や余分な `/v1` がないか確認します。 3. 社内プロキシでは `api.beatapi.io` への通信を許可します。 ### 利用量と料金の確認 ダッシュボードでキー別の呼び出し数、トークン消費量、料金を確認できます。[`GET /v1/usage`](/quick-guide) でも同じ数値を取得できます。 ## サポート [ダッシュボード](https://beatapi.io/dashboard)からチケットを作成し、失敗したレスポンスの `request_id` を添えてください。ログ内の対象呼び出しを正確に特定できます。