Source: https://aiprimetech.io/ja/learn/use-claude-api-with-claude-code/ [ホーム](/ja/) / [学習](/ja/learn/) / Claude Codeへの無制限アクセス # Claude Codeへの無制限アクセス Claude Codeは、ソフトウェア開発向けのAnthropic公式コマンドラインエージェントです。200kのコンテキストウィンドウで動作し、それぞれ独立したコンテキストを持つサブエージェントを起動し、ファイル全体を会話履歴に読み込み、ターンごとにコンテキスト全体を再送信します。そのため、長いセッションではトークン使用量が二次関数的に増加します。これにより、Claude Codeは開発者向けツールの中でも特にトークン消費量が多いツールとなっています。Claude Codeを定額制の無制限ゲートウェイに接続すると、使用量を慎重に管理するツールから、いつでも使える真の開発パートナーへと変わります。 ## Claude Codeのトークン消費量が二次関数的に増える理由 APIの観点では、Claude Codeはターン間で状態を保持しません。送信する各メッセージには、会話履歴全体、つまりそれまでのすべてのメッセージ、読み込まれたすべてのファイルの内容、すべてのツールの結果、アシスタントのすべての応答が含まれます。最初のメッセージは5,000トークン程度かもしれません。やり取りが十回目になる頃には、50,000トークンの履歴に、新たに追加された内容を加えて送信することになります。二十回目になる頃には、リクエストごとのコンテキストが150,000トークンを超えることもあります。 サブエージェントによって、この状況はさらに悪化します。Claude Codeがサブエージェントに作業を委任すると、そのエージェントには独自のコンテキストウィンドウが与えられ、独立して履歴の蓄積を開始します。親エージェントのコンテキストにはサブエージェントの要約が加わって増大し、その一方でサブエージェント自体もトークン料金を積み上げます。複数のサブエージェントが連携するエージェントチームでは、これがさらに増幅されます。複雑なタスクでは、親エージェントと3つのサブエージェントがそれぞれ100k以上のトークンのコンテキストを持ち、すべて同じAPIキーで動作することもあります。 /compactコマンドは、履歴を要約して古いコンテキストを切り詰めることで役立ちますが、詳細を削って空きを確保する手動操作です。トークン従量課金では、ユーザーはコストを抑えるために頻繁に圧縮せずにはいられなくなります。無制限プランでは、会話を自然に長く続け、コンテキストの品質が低下したときだけ圧縮し、コストを頭の中で計算することなくサブエージェントを自由に使えます。 ## 環境変数の設定 Claude Codeは環境変数からAPI設定を読み取ります。必須の変数はANTHROPIC_BASE_URLと、ANTHROPIC_API_KEYまたはANTHROPIC_AUTH_TOKENのいずれかです。ANTHROPIC_BASE_URLにはhttps://unlimited.aiprimetech.ioを設定してください。Anthropic SDKがAPIパスを自動的に追加するため、/v1を付けないルートホストを指定します。キーについては、ゲートウェイがx-api-keyヘッダー認証（標準のAnthropic形式）を要求する場合、ANTHROPIC_API_KEYを使用してください。 設定を永続化するには、これらをシェルのプロファイル（.bashrc、.zshrc、またはPowerShellの$PROFILE）に設定してください。Windowsでは、「システムの詳細設定」ダイアログからシステム環境変数として設定することもできます。Claude Codeは起動時にこれらを読み取るため、変更した場合はClaude Codeのセッションを再起動して新しい値を反映してください。 プロジェクトごとに設定を上書きするには、プロジェクトのルートに.envファイルを作成します。Claude Codeは作業ディレクトリから.envファイルを読み込みます。これにより、プロジェクトごとに異なるAPI設定を使用できます。一部のプロジェクトでは無制限プランを使用し、ほかのプロジェクトではAnthropicの直接課金を使用する場合に便利です。.envファイルはシステム環境変数より優先されます。 ## Sonnet、Opus、Haiku、Fableのモデルマッピング Claude Codeは内部モデルエイリアスを使用しており、環境変数で上書きできます。ANTHROPIC_DEFAULT_SONNET_MODELは、デフォルトの「sonnet」を選択したときに使用するモデルを制御します。ANTHROPIC_DEFAULT_OPUS_MODELは「opus」の選択を上書きします。ANTHROPIC_DEFAULT_HAIKU_MODELとANTHROPIC_DEFAULT_FABLE_MODELは残りのモデル階層を制御します。これらには、ゲートウェイがサポートする正確なモデルIDを設定してください。 例えば、ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-5とANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-6.を設定します。Claude Codeで/modelまたは起動フラグを使ってモデル階層を選択すると、マッピングしたモデルが使用されます。これは、ゲートウェイが独自のモデル識別子を公開している場合や、特定のモデルバージョンに固定したい場合に特に便利です。 無制限プランでは、モデルの選択は純粋に品質と速度のバランスで決まります。モデル階層間でコストの差はありません。最高の品質を得るにはOpusをデフォルトとして使用し、短いサイクルで試行錯誤する際に、より速い応答が必要な場合だけSonnetやHaikuに切り替えてください。/effortコマンドでは、Claude Codeが各タスクにどれだけ綿密に取り組むかをさらに調整できます。高いeffort設定とOpusを組み合わせることで、最も高い能力を発揮する構成になります。 ## サブエージェント、エージェントチーム、バックグラウンドエージェント Claude Codeは、独自のコンテキストウィンドウを持ち、委任されたサブタスクを処理する独立したClaudeインスタンスであるサブエージェントを起動できます。メインエージェントが複雑なタスクに直面すると、調査、実装、検証をサブエージェントに委任できます。サブエージェントは独立して作業し、結果を報告します。各サブエージェントは新しいコンテキストで開始し、独自の会話履歴を蓄積します。 エージェントチームはこの概念を拡張し、複数のサブエージェントが関連する作業に同時に連携して取り組めるようにします。メインエージェントは調整役として、作業を割り振り、結果を統合します。これは大規模な変更で非常に強力です。例えば、あるサブエージェントがモジュールAをリファクタリングし、別のサブエージェントがモジュールBを担当できます。ただし、API使用量は稼働中のエージェント数に比例して増加します。 バックグラウンドエージェントは、メインセッションで作業を続けている間、非同期で実行されます。個別のタスクに取り組み、完了時に結果を報告します。トークン従量課金では、複数のバックグラウンドエージェントを同時に実行すると、コストが急速に膨らみます。無制限プランでは、複数のバックグラウンドエージェントを起動し、プロジェクトのさまざまな側面に取り組ませ、準備ができた時点で出力を確認できます。すべて定額料金に含まれます。 Claude Codeがテレメトリや必須ではないリクエストを送信しないようにするには、CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1を設定してください。これは、どのカスタムゲートウェイでも不要な通信を減らすための推奨事項です。また、CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1を設定すると、Claude Codeはハードコードされたリストを使う代わりに、利用可能なモデルをゲートウェイに問い合わせます。 ## ヘッドレスモードとCI/CD連携 Claude Codeのヘッドレスモード（--headlessフラグ）は対話型プロンプトなしで実行されるため、CI/CDパイプライン、自動コードレビュー、バッチ処理に適しています。ヘッドレスモードでは、Claude Codeはstdinまたはコマンドライン引数から入力を読み取り、結果をstdoutに出力します。タスクが完了すると、追加の入力を待たずに終了します。 CI連携では、パイプライン設定（GitHub Actionsのシークレット、GitLab CIの変数、Jenkinsの認証情報）に環境変数を設定し、タスクの説明を引数としてClaude Codeを呼び出します。一般的なCIの用途には、PRの自動レビュー、ドキュメント生成、テスト作成、移行スクリプトなどがあります。 無制限プランでは、ヘッドレスモードによって大量の処理を行うワークフローが可能になります。リポジトリ内のすべてのPRでClaude Codeを実行したり、未テストのモジュール向けのテストスイートを一括生成したり、リリースごとのドキュメント更新を自動化したりできます。呼び出しごとのコストを心配する必要はありません。フェアユースのレート制限内に収まる限り、すべての使用量が定額料金に含まれます。 ## CLAUDE.mdによるプロジェクトメモリとフック CLAUDE.mdファイルは、Claude Codeが自動的に読み込む永続的なプロジェクトコンテキストを提供します。コーディング規約、アーキテクチャ上の決定、一般的なパターン、プロジェクト固有の指示を記載したCLAUDE.mdをプロジェクトのルートに配置してください。この内容はすべてのリクエストのシステムプロンプトに含まれるため、呼び出しごとのトークン数は増えますが、応答の品質と一貫性が大幅に向上します。 トークン従量課金では、ユーザーはコストを抑えるためにCLAUDE.mdを最小限に保ちます。すべての語が、セッション全体を通じて毎回のリクエストにトークンを追加するためです。無制限プランでは、実際に役立つコンテキストを必要なだけ記述してください。詳細なアーキテクチャドキュメント、完全なスタイルガイド、依存関係の説明、チームの規約などです。リクエストごとにトークンが増えても追加料金は発生せず、やり取りを重ねるたびに品質向上の効果が積み重なります。 フックを使うと、ツール呼び出しの前後、セッション開始時、圧縮時など、Claude Codeの実行中の特定のタイミングでカスタムスクリプトを実行できます。フックを使用して、動的なコンテキストの追加、CIによる変更の検証、コードの自動整形、通知の起動を行えます。フックはAPIレベルではなくCLIレベルで動作するため、無制限ゲートウェイとシームレスに連携します。 ## Claude Codeのゲートウェイに関する問題のトラブルシューティング Claude Codeが接続できない場合は、ANTHROPIC_BASE_URLに/v1を付けないルートホストが設定されていることを確認してください。echo $ANTHROPIC_BASE_URL（PowerShellでは$env:ANTHROPIC_BASE_URL）を実行して値を確認します。SDKは/v1/messagesを自動的に追加するため、ベースURLに/v1を含めると、リクエストは/v1/v1/messagesに送られ、404が返されます。 モデルが見つからないというエラーは、マッピング変数のモデルIDがゲートウェイで提供されているものと一致していないことを意味します。AI Prime Techのダッシュボードで、サポートされている正確な識別子を確認し、それに合わせてANTHROPIC_DEFAULT_SONNET_MODELを更新してください。モデルIDは大文字と小文字を区別し、バージョンのサフィックスを含むことに注意してください。 セッションは動作するのにサブエージェントが失敗する場合、起動方法によってサブエージェントへの環境変数の継承方法が異なることが原因かもしれません。環境変数は現在のシェルセッション内だけでなく、システムレベルで設定してください。特にWindowsでは、子プロセスがシェル内でのみ設定された変数を継承しない場合があります。 コピー ``` # Shell environment (add to .bashrc / .zshrc / $PROFILE) export ANTHROPIC_BASE_URL="https://aiprimetech.io" export ANTHROPIC_API_KEY="" export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-5" export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-6" export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 # Or per-project .env file: # ANTHROPIC_BASE_URL=https://aiprimetech.io # ANTHROPIC_API_KEY=sk-... # ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-5 # Run Claude Code: # claude (interactive) # claude --headless (CI/CD mode) ``` ## よくある質問 Claude Codeがチャットよりもはるかに多くのトークンを使用するのはなぜですか？ Claude Codeはターンごとに会話履歴全体を再送信します。API側では状態を保持しません。セッションが長くなるにつれて、各リクエストに過去のすべてのメッセージ、ファイル内容、ツールの結果が含まれるようになります。その結果、トークン数は二次関数的に増加し、セッション内の二十番目のメッセージは最初のメッセージより10-20x大きくなることがあります。 サブエージェントの使用量は個別にカウントされますか？ 各サブエージェントは、独自のコンテキストウィンドウを持つ独立した会話を実行します。無制限プランでは、親エージェント、サブエージェント、バックグラウンドエージェントを含むすべてのエージェントの会話が定額料金に含まれます。エージェント単位や会話単位の追加料金はありません。 ANTHROPIC_BASE_URLに/v1を含める必要がありますか？ いいえ。ルートホストのhttps://unlimited.aiprimetech.ioに設定してください。Anthropic SDKが/v1/messagesを自動的に追加します。変数に/v1を含めるとパスが重複し、404エラーが返されます。 無制限プランでClaude CodeのヘッドレスモードをCI/CDに使用できますか？ はい。パイプラインのシークレットにANTHROPIC_BASE_URLとANTHROPIC_API_KEYを設定し、タスクの引数を指定してclaude --headlessを実行してください。無制限プランでは、フェアユースのレート制限の範囲内で、CIでの利用も同じ定額料金に含まれます。 Claude Codeでモデルを切り替えるにはどうすればよいですか？ セッション中に/modelコマンドを使用するか、環境変数ANTHROPIC_DEFAULT_SONNET_MODELとANTHROPIC_DEFAULT_OPUS_MODELを設定して、各ティアで使用するモデルを指定してください。無制限プランではモデルによる料金の違いはありません。 数分でClaudeの利用を開始 APIキーを取得 — Anthropicアカウントもウェイトリストへの登録も不要です。[APIキーを取得](/register) AI Prime Techは独立したAPIゲートウェイです。Anthropicとの提携関係はなく、同社の承認を受けておらず、同社の再販業者でもありません。Claudeおよび関連するモデル名は、それぞれの所有者の商標です。 ## Claude APIのその他のガイド [Claude APIキーの取得方法](/ja/learn/how-to-get-a-claude-api-key/)[Claude API の料金を解説](/ja/learn/claude-api-pricing-explained/)[Claude APIを最も安く利用する方法](/ja/learn/cheapest-way-to-use-claude-api/)[Claude APIでCursorを無制限に利用](/ja/learn/use-claude-api-with-cursor/)[Claude APIゲートウェイとAnthropicへの直接接続の比較](/ja/learn/claude-api-vs-anthropic-direct/)[OpenAI互換API経由でClaudeを使う](/ja/learn/openai-compatible-claude-api/)[Claudeモデルの比較](/ja/learn/claude-api-models-compared/)[暗号資産でClaude APIの料金を支払う](/ja/learn/claude-api-with-crypto-payment/)[ウェイティングリストなしでClaude APIを利用](/ja/learn/claude-api-without-waitlist/)[Claudeのトークン使用量を削減する方法](/ja/learn/how-to-reduce-claude-token-usage/)[Claude APIでClineを無制限に利用](/ja/learn/use-claude-api-with-cline/)[Claude APIでRoo Codeを無制限に利用](/ja/learn/use-claude-api-with-roo-code/)[JetBrains IDEでClaudeを無制限に利用](/ja/learn/use-claude-api-with-jetbrains/)[Claude APIでAiderを無制限に使う](/ja/learn/use-claude-api-with-aider/)[VS CodeでClaudeを無制限に利用](/ja/learn/use-claude-api-with-vscode/)[Claude APIでOpenCodeを無制限に使う](/ja/learn/use-claude-api-with-opencode/)[ClaudeでHermesエージェントを無制限に実行する](/ja/learn/run-hermes-agent-with-claude-api/)[ClaudeでOpenClawを無制限に実行](/ja/learn/run-openclaw-with-claude-api/)[Anthropic互換APIとは](/ja/learn/anthropic-compatible-api/)[Claude Code APIキー — 取得と設定の方法](/ja/learn/claude-code-api-key-setup/)[Claude Code APIのコスト — 料金と削減方法](/ja/learn/claude-code-api-costs/)[Claude APIのエラー — レート制限、400、500、529の対処法](/ja/learn/claude-api-errors-troubleshooting/)[Claude APIクレジットの購入方法](/ja/learn/buy-claude-api-credits/)[Claude APIの無料トライアル：実際に無料のものと、無料ではないもの](/ja/learn/claude-api-free-trial/)[Claude APIとClaude Pro/Maxサブスクリプション — どちらを選ぶべきか](/ja/learn/claude-api-vs-subscription/)[ClaudeでCodex CLIを実行する](/ja/learn/use-claude-api-with-codex/)[Claudeをn8nに接続する](/ja/learn/use-claude-api-with-n8n/)[LiteLLMからClaudeへのルーティング](/ja/learn/use-claude-api-with-litellm/)[Kilo CodeでClaudeを使う](/ja/learn/use-claude-api-with-kilo-code/)[GitHub CopilotにClaudeを導入する](/ja/learn/use-claude-api-with-github-copilot/)[ゲートウェイ経由でZedをClaudeに接続する](/ja/learn/use-claude-api-with-zed/)[Cherry StudioをClaudeに接続](/ja/learn/use-claude-api-with-cherry-studio/)[LangChainの接続先をゲートウェイ上のClaudeに設定する](/ja/learn/use-claude-api-with-langchain/)[ClaudeでFactory Droidを実行](/ja/learn/use-claude-api-with-factory-droid/)[Claude Code APIの仕組みを解説](/ja/learn/claude-code-api/)[アプリケーションへのClaude APIの統合](/ja/learn/claude-api-integration/)