Claude Code APIキー：取得して1分で設定

APIキーとサブスクリプションでのログインの違い

Claude Code には2つの認証方法があります。/login を使うと Claude Pro または Max プランが使われ、利用量はそのプランの5時間枠と週次の利用枠に対してカウントされます。APIキーを使うと、設定したAPIエンドポイントにリクエストが送信され、トークン単位で支払います。

APIキーを設定すると、Claude Code はそのキーに対して課金し、Claudeプランの利用枠は消費しません。環境変数を削除して /login を実行すると元に戻ります。

Claude Code の利用上限の仕組み

キーの取得方法とチャージ方法

1. 1. 登録

   aicodewith.ai で、メール、Google、GitHub のいずれかを使ってアカウントを作成します。

2. 2. 残高をチャージ

   支払いはプリペイド方式です。海外のアカウントは Stripe 経由のカードでUSD、中国本土のアカウントは Alipay 経由でCNYで支払います。請求リージョンは最初のチャージ時に選択し、最低金額はチェックアウト時に表示されます。

3. 3. キーを作成

   ダッシュボードの API Keys を開き、キーを作成します。任意で日次・月次・合計の支出上限を設定できます。キーをコピーしてください。次の手順で Claude Code に貼り付けます。

残高は、利用するモデルとチャネルの料金に基づいてトークン単位で消費されます。クレジットの有効期間は1年間で、未使用の残高はチャージ日から90日以内であれば返金できます。その際10%の手数料がかかります。

チャージ方法支払いと返金に関するFAQ返金ポリシー

"From" prices are based on the Economy channel, the lowest-priced Claude channel currently listed (about 19% of Anthropic list price). Other channels cost more; the rate depends on the channel you choose, and the models page is always the source of truth.

キーを設定する場所

どちらか一方に設定してください。settings.json が最も確実です。Claude Code の CLI と IDE 拡張機能の両方がこれを読み込むためです。シェル変数は、簡単なテストやCIジョブに便利です。

1. 1. 方法A: ~/.claude/settings.json（推奨）

   macOS と Linux: ~/.claude/settings.json。Windows: %USERPROFILE%\.claude\settings.json。ファイルが存在しない場合は作成し、存在する場合は env ブロックをマージします。

   ~/.claude/settings.json

   {
     "env": {
       "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
       "ANTHROPIC_API_KEY": "",
       "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai"
     }
   }

2. 2. 初回起動時のサインイン画面をスキップする

   新規インストール時は、~/.claude.json にこのフィールドを追加すると、Claude Code が Anthropic アカウントへのサインインを求めなくなります。ファイルが既に存在する場合は、上書きせずにこのフィールドを追加してください。

   ~/.claude.json

   {
     "hasCompletedOnboarding": true
   }

3. 3. 方法B: シェルの環境変数

   これらの行を ~/.zshrc または ~/.bashrc に追加し（CIステップで export しても可）、新しいターミナルを開きます。

   bash / zsh

   export ANTHROPIC_BASE_URL="https://api.aicodewith.ai"
   export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
   export ANTHROPIC_API_KEY=""

4. 4. Windows での方法B（PowerShell）

   ユーザーレベルの変数を設定します。設定後に新しいターミナルを開いてください。

   PowerShell

   [Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.aicodewith.ai", "User")
   [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_API_KEY", "User")

ANTHROPIC_BASE_URL にはドメインのみ（https://api.aicodewith.ai）を指定します。/v1 は付けないでください。Claude Code がパスを自身で付加するため、/v1 を付けると404エラーになります。

ANTHROPIC_AUTH_TOKEN と ANTHROPIC_API_KEY のどちらを使うか

ANTHROPIC_API_KEY を空文字列に設定することは重要です。シェルに古い Anthropic のキーがまだ export されていると、aicodewith のキーの代わりにそれが送信され、リクエストが401で失敗することがあります。

Claude Code セットアップ完全ガイド

動作確認とエラーの意味

1. すべての Claude Code セッションを閉じて、claude を再実行します。
2. /status を実行し、APIエンドポイントが api.aicodewith.ai と表示されることを確認します。
3. 短いメッセージを送信します。リクエストとその課金がダッシュボードの利用記録に表示されます。
4. /cost を実行すると、そのセッションのトークン単位のコストが確認できます。

1つのキーを複数のプロジェクトとマシンで使う

キーはデバイスやプロジェクトに紐づきません。ノートPC、開発サーバー、CIで同じキーを使えますし、プロジェクト、チームメンバー、パイプラインごとに1つのキーを作成することもできます。キーを分けると利用記録と支出上限もそれぞれ別になり、他のキーに影響を与えずに1つを削除できます。

• •キーごとの日次・月次・合計の支出上限は、暴走したエージェントのループが残高を使い切るのを防ぎます。
• •利用記録には、各リクエストのモデル、トークン数、コストが表示されます。
• •キーはパスワードと同様に扱ってください。git に含めず、漏えいした場合はキーをローテーションします。

次のステップ

サブスクリプションなしで Claude Code を使うClaude Max の代替: トークン単位で支払うClaude Code の利用上限を解説Claude Code 連携ガイドドキュメント

FAQ