# Claude Code API Keyのセットアップ

Claude Codeは、リクエストを任意の場所にルーティングするために2つの環境変数を読み取ります: ANTHROPIC_BASE_URLとANTHROPIC_API_KEYです。それらをRunAPIに向けると、すべてのClaudeモデルを公式料金の半額で実行できます。このガイドでは、Mac、Linux、Windows向けの正確なコマンドを示します。

*Updated June 18, 2026 · RunAPI Editorial*

## Claude Codeでカスタム API keyを設定するにはどうすればよいですか？

Claude Codeは、リクエストの送信先と認証方法を決めるために2つの環境変数を使用します。ANTHROPIC_BASE_URLとANTHROPIC_API_KEYをRunAPIの値に設定すると、すべてのリクエストが50%オフでRunAPI経由にルーティングされます。まったく別のプロバイダーを使いたいですか？RunAPIはドロップインゲートウェイとしても機能するため、直接のAnthropicアカウントなしでClaudeモデルを実行できます。

- **2つの変数**: ANTHROPIC_BASE_URLはエンドポイントを設定します。ANTHROPIC_API_KEYはキーを設定します。これが設定のすべてです。2つの変数だけで、他の変更は不要です。
- **エンドポイントの値**: ANTHROPIC_BASE_URLをhttps://runapi.aiに設定して、Claude CodeがRunAPI経由でルーティングされるようにします。
- **永続化する**: 両方のエクスポートをシェルプロファイル（.zshrcまたは.bashrc）に追加して、毎セッションで再設定しなくて済むようにします。WindowsユーザーはPowerShellで設定し、新しいウィンドウを開いてください。
- **50%オフ**: すべてのClaudeモデルがAnthropicの公式レートの半額で課金されます。サブスクリプション不要、上限なし。

## Claude Codeを設定する前に何が必要ですか？

セットアップには数分かかります。Claude Codeのインストール、RunAPIアカウント、ターミナルが必要です。APIキー設定に触れる前に、まずclaude --versionを実行してClaude Codeが動作していることを確認してください。

### Claude Codeのインストール

公式ソースからClaude Codeをインストールし、ターミナルでclaude --versionを実行して動作を確認します。そのコマンドでエラーが出る場合は、APIキーを設定する前にインストールを修正してください。

### RunAPIアカウント

runapi.aiでサインアップしてください。無料ティアには、残高をチャージする前にどのClaudeモデルもテストできるクレジットが含まれています。

### API key

Dashboard → API Keysからキーを作成します。一度だけコピーしてください。完全な形で表示されるのは作成時のみです。公開リポジトリに貼り付けたり、スクリーンショットで共有したりしないでください。

### ターミナルアクセス

環境変数を設定するにはシェルが必要です。macOSとLinuxでは.zshrcまたは.bashrcを使用します。WindowsユーザーはPowerShellを使用できます。変数を設定してから、新しいターミナルウィンドウを開くと有効になります。


## RunAPIでClaude Code API keyを設定する方法

これらのコマンドを順番に実行します。エンドポイントとキーを設定し、それらをシェルプロファイルに保持し、Claude Codeがそれらを認識していることを確認します。プレースホルダーを実際のRunAPIキーに置き換えてください。ANTHROPIC_API_KEY（CLAUDE_API_KEYではありません）を使用してください。これはClaude Codeが実際に読み取る変数です。

## Claude Codeが読み取る環境変数はどれですか？

Claude Codeは、エンドポイント、認証、モデル、出力長を制御する少数の変数を読み取ります。この表では、カスタムエンドポイント設定に重要なものと、それぞれの役割を示しています。注: ANTHROPIC_API_KEY（CLAUDE_API_KEYではありません）を使用してください。これはClaude Codeが実際に読み取る変数です。

| 変数 | 用途 | 値の例 |
|---|---|---|
| ANTHROPIC_BASE_URL | Claude Codeがリクエストを送信するカスタムエンドポイント | https://runapi.ai |
| ANTHROPIC_API_KEY | リクエストの認証に使用するキー | sk-your-runapi-key |
| ANTHROPIC_MODEL | 新しいセッションのデフォルトモデル | claude-sonnet-4-6 |
| CLAUDE_CODE_MAX_OUTPUT_TOKENS | 1レスポンスあたりの返却トークン数の上限 | 8192 |

## Claude Codeで実行すべきClaudeモデルはどれですか？

Claude CodeはRunAPI経由で任意のClaudeモデルIDを受け付けます。タスクに応じて選んでください。通常の編集には高速で安価なモデル、日常的なコーディングにはバランスの取れたモデル、難しい問題には最強のモデルです。デフォルトを変更するにはANTHROPIC_MODELを設定するか、Claude Code内でモデルを切り替えてください。請求は実際に呼び出したモデルに従います。

### claude-haiku-4-5

RunAPI経由で入力$1/M、出力$5/Mで最速かつ最安価。日常的な編集やクイックルックアップに最適です。

### claude-sonnet-4-6

RunAPI経由で入力$3/M、出力$15/Mで日常的なコーディングのバランスが取れたデフォルト。ほとんどの開発者はこれを使用します。

### claude-opus-4-7

RunAPI経由で入力$5/M、出力$25/Mで難しい問題に最強。複雑なリファクタリングやレビューに使用します。

### いつでも切り替え可能

ANTHROPIC_MODELを設定するか、Claude Code内でいつでもモデルを変更できます。請求は実際に呼び出したモデルに従い、すべて50%オフです。


## Claude Code API keyが機能しないのはなぜですか？

ほとんどのセットアップ問題は、次の3つのいずれかが原因です: 間違ったenv var名（CLAUDE_API_KEYではなくANTHROPIC_API_KEYを使用）、プロファイル変更をまだ取り込んでいない古いシェルセッション、またはキーのタイプミスです。この表では、一般的なエラーとそれぞれの修正方法を示しています。

| エラーまたは症状 | 考えられる原因 | 修正方法 |
|---|---|---|
| 401 Unauthorized | 誤ったまたは期限切れのAPI key | ANTHROPIC_API_KEYを再確認し、必要に応じてRunAPIダッシュボードで新しいキーを作成してください |
| リクエストが引き続きAnthropicに送信される | このシェルでANTHROPIC_BASE_URLが設定されていない | echo $ANTHROPIC_BASE_URLを実行してください。空の場合は、プロファイルをリロードするか新しいターミナルを開いてください |
| 404 Not Found | ベースURLにトレイリングスラッシュまたは誤ったパスがある | ベースURLをトレイリングパスなしのhttps://runapi.aiに正確に設定してください |
| モデルが見つからない | 無効またはスペルミスのモデルID | claude-sonnet-4-6またはclaude-opus-4-7のような有効なIDを使用してください |
| 再起動時に変数が失われる | エクスポートがシェルプロファイルに書き込まれていない | 両方のエクスポートを~/.zshrcまたは~/.bashrcに追記してリロードしてください |

## RunAPIでClaude Code API keyを設定する方法

1. **ベースURLを設定する** — ANTHROPIC_BASE_URL=https://runapi.aiをエクスポートして、リクエストをRunAPI経由でルーティングします。
2. **API keyを設定する** — Dashboard → API KeysのRunAPIキーでANTHROPIC_API_KEYをエクスポートします。
3. **両方の変数を永続化する** — 両方のエクスポートを~/.zshrcまたは~/.bashrcに追加し、source ~/.zshrcで再読み込みして、新しいセッションでも保持されるようにします。Windowsでは、PowerShellで設定し、新しいターミナルウィンドウを開いてください。
4. **Claude Codeを実行する** — claude --versionを実行してインストールを確認し、その後プロジェクトでclaudeを起動します。リクエストは公式料金の50%オフでRunAPI経由にルーティングされます。

## Claude Code API Key FAQ

### Claude CodeにAPI keyを追加するにはどうすればよいですか？

2つの環境変数を設定します。ANTHROPIC_BASE_URLをhttps://runapi.aiに、ANTHROPIC_API_KEYをあなたのRunAPIキーにエクスポートします。両方をシェルプロファイル（.zshrcまたは.bashrc）に追加して、セッション間で保持されるようにします。Claude Codeは起動時にそれらを読み取り、すべてのリクエストをRunAPI経由でルーティングします。

### Claude Code API keyはどこで入手できますか？

runapi.aiで作成します。サインアップし、Dashboard → API Keysを開いてキーを生成します。すぐにコピーしてください。完全なキーは作成時にのみ表示されます。無料ティアには、残高を追加する前に任意のClaudeモデルをテストするためのクレジットが含まれています。

### ANTHROPIC_BASE_URLは何のためにありますか？

Claude Codeがリクエストを送信するエンドポイントを指定します。デフォルトでは、Claude CodeはAnthropicに直接リクエストを送ります。https://runapi.aiに設定すると、すべてのリクエストがRunAPI経由でルーティングされ、同じモデルが公式レートの50%で利用できます。

### Claude CodeをOpenAIのような他のAPIプロバイダーで使えますか？

Claude CodeをOpenAIのような他のAPIプロバイダーで使う方法はありますか？はい。Claude CodeはANTHROPIC_BASE_URL経由で任意のOpenAI互換エンドポイントをサポートしています。RunAPIは互換ゲートウェイを提供しているため、コードを変更せずにプロバイダーを切り替え、Claude、GPT、その他のモデルで1つのキーを使用できます。

### Claude Codeがまだフル料金で請求されるのはなぜですか？

ターミナルでecho $ANTHROPIC_BASE_URLを実行します。何も表示されない場合、エクスポートが保持されていません。両方のエクスポートを~/.zshrcまたは~/.bashrcに追加し、source ~/.zshrcを実行してから、新しいターミナルを開いて再度確認してください。Windowsユーザーは、env varsを設定した後に新しいPowerShellウィンドウを開く必要があります。

### 代わりにキーをコンフィグファイルに保存できますか？

はい。毎セッションでエクスポートする代わりに、ホームまたはプロジェクトディレクトリの.claude.jsonファイルに値を配置します。どちらの方法も機能します。ファイルはプロジェクトごとのキーに便利で、エクスポートは単一のグローバル設定によりシンプルです。

### セットアップ後にコストを監視するにはどうすればよいですか？

RunAPIダッシュボードを開きます。キーごと、リクエストごとの支出がリアルタイムで表示されます。出力コストを制限するには、CLAUDE_CODE_MAX_OUTPUT_TOKENSを設定して各レスポンスを制限し、通常の編集にはclaude-haiku-4-5を使用してください。

### これによりClaude Codeの動作は変わりますか？

いいえ。RunAPIはリクエストを基盤となるClaudeモデルへ直接プロキシします。出力、ツール使用、動作はAnthropicを直接呼び出す場合と同一です。変更されるのはリクエストの送信先と請求方法だけで、コーディング体験は同じままです。