ホーム / 学習 / ゲートウェイ経由でAiderでClaudeを使う：ANTHROPIC_API_BASE、設定ファイル、アーキテクトモード、修正方法
Aiderで使うClaude。控えめなプラス記号が付いたソースコードのページと、マイナス記号が付いたページが重なり、その間を小さな鉛筆がつないでいます。

ゲートウェイ経由でAiderとClaudeを使う：ANTHROPIC_API_BASE、設定ファイル、アーキテクトモード、問題の解決方法

Aiderはすべてのモデル呼び出しをLiteLLM経由で送信するため、ゲートウェイへの接続先指定はAiderではなくLiteLLMの設定になります。Claudeの場合は、 ANTHROPIC_API_BASE をゲートウェイのホストのルートに設定し、モデル名には anthropic/ プレフィックスを付けます。さらに、見落としがちな設定も同じくらい重要です。新しいClaude IDにはモデル設定のエントリが必要です。これがないと、Aiderはリポジトリマップなしでファイル全体を編集する方式にフォールバックします。

Aiderをインストール

macOS / Linux
python -m pip install aider-install
aider-install

# or the one-line installer (installs Python 3.12 if needed)
curl -LsSf https://aider.chat/install.sh | sh
Windows
powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"

その後、 aider コマンドが見つからない場合（Windowsではよくあります）、 python -m aider で同じプログラムを実行できます。

ゲートウェイ経由でClaudeに接続

ターミナル
export ANTHROPIC_API_KEY=your_gateway_key
export ANTHROPIC_API_BASE=https://aiprimetech.io

aider --model anthropic/claude-sonnet-5
Windows
setx ANTHROPIC_API_KEY your_gateway_key
setx ANTHROPIC_API_BASE https://aiprimetech.io
# open a new terminal, then:
aider --model anthropic/claude-sonnet-5
ホストのルートを使用してください。 /v1 は付けず、末尾のスラッシュも付けません。LiteLLMは次を追加します： /v1/messages この追加はSDK自身が行うため、 https://aiprimetech.io/v1 は次のようになります： /v1/v1/messages 。その結果、404が返されます。また、末尾にスラッシュがあると、パス内のスラッシュが重複します。

Aiderの公式ドキュメントでは、カスタムAnthropicベースURLについて説明されていません。この変数はLiteLLMによって読み取られ、まず ANTHROPIC_API_BASE を確認し、次に ANTHROPIC_BASE_URL（Claude Codeが使用する変数）を確認します。どちらでも機能しますが、両方が設定されている場合は、 ANTHROPIC_API_BASE が優先されます。

モデル名には anthropic/ プレフィックスを残してください。プロバイダープレフィックスがないと、LiteLLMは未知の名前の送信先を判断できず、次のエラーで失敗します： LLM Provider NOT provided.

設定を設定ファイルに記述

Aiderが読み取るのは .aider.conf.yml と .env で、ホームディレクトリ、Gitリポジトリのルート、現在のディレクトリの順に読み込み、後から読み込まれるファイルが優先されます。ホームディレクトリ内のファイルは、すべてのプロジェクトに適用されます。

~/.aider.conf.yml
model: anthropic/claude-sonnet-5
weak-model: anthropic/claude-haiku-4-5
set-env:
  - ANTHROPIC_API_BASE=https://aiprimetech.io
model-settings-file: ~/.aider.model.settings.yml
model-metadata-file: ~/.aider.model.metadata.json
~/.env
ANTHROPIC_API_KEY=your_gateway_key

weak-model はコミットメッセージとチャット履歴の要約を処理するため、ここに安価なモデルを指定すると、すべてのセッションで費用を節約できます。 set-env はモデルを呼び出す前に変数を環境にコピーするため、シェルプロファイルにベースURLを記述する必要がなくなります。

新しいモデルでも差分編集とリポジトリマップを維持

Aiderはモデル名に基づいて編集形式を選びます。認識される名前には、次を含む名前もあり、 sonnet-4-, opus-4- または haiku-4-それらには次が適用されます： diff 編集とリポジトリマップ。次のような認識されない名前は、 claude-sonnet-5ファイル全体を書き換える方式にフォールバックし、リポジトリマップも使用されなくなります。その結果、編集が遅くなり、費用も増えます。設定エントリを追加すると、適切な動作を復元できます：

~/.aider.model.settings.yml
- name: anthropic/claude-sonnet-5
  edit_format: diff
  use_repo_map: true
  weak_model_name: anthropic/claude-haiku-4-5

- name: anthropic/claude-opus-5-5
  edit_format: diff
  use_repo_map: true
  weak_model_name: anthropic/claude-haiku-4-5
  editor_model_name: anthropic/claude-sonnet-5
  editor_edit_format: editor-diff

未知のモデルでは、次の警告も表示されます： Unknown context window size and costs, using sane defaults。この警告自体は問題ありませんが、その場合Aiderはコンテキストウィンドウを無制限、料金をゼロとみなします。メタデータファイルで実際の数値を指定できます：

~/.aider.model.metadata.json
{
  "anthropic/claude-sonnet-5": {
    "max_tokens": 64000,
    "max_input_tokens": 200000,
    "max_output_tokens": 64000,
    "input_cost_per_token": 0.000002,
    "output_cost_per_token": 0.00001,
    "litellm_provider": "anthropic",
    "mode": "chat"
  },
  "anthropic/claude-opus-5-5": {
    "max_tokens": 64000,
    "max_input_tokens": 200000,
    "max_output_tokens": 64000,
    "input_cost_per_token": 0.000004,
    "output_cost_per_token": 0.00002,
    "litellm_provider": "anthropic",
    "mode": "chat"
  }
}

価格はAnthropicが公表するトークン単価なので、Aiderのコスト表示には定価での費用が表示されます。ゲートウェイの請求額はそれより低くなります。モデルがより多くの入力に対応している場合でも、入力上限を200Kに設定すると、余裕を持って運用できます。

アーキテクトモード：あるモデルで計画し、別のモデルで編集

ターミナル
aider --architect --model anthropic/claude-opus-5-5 --editor-model anthropic/claude-sonnet-5

アーキテクトモードでは、メインモデルが変更を提案し、編集モデルがそれをファイルの編集に変換します。通常、計画には高性能なモデルを、編集には安価なモデルを使うほうが、両方に高性能なモデルを使うより費用を抑えられます。セッション内では、 /architect でそのモデルに切り替えると、そのメッセージにのみ適用され、 /chat-mode architect で切り替えると、セッションの残り全体に適用されます。

OpenAI互換の接続方法

ゲートウェイはOpenAIのChat Completions形式にも対応しており、同じアカウントでGPTモデルを使う際はこちらの接続方法を使用します。この場合、ベースURLには /v1を含め、モデル名には openai/ というプレフィックスを付けます：

ターミナル
export OPENAI_API_KEY=your_gateway_key
export OPENAI_API_BASE=https://aiprimetech.io/v1

aider --model openai/claude-sonnet-5

Claudeには、上記のネイティブな接続方法を推奨します。モデルのメタデータとプロンプトキャッシュがAnthropicの形式に適合するためです。環境に意図せず OPENAI_BASE_URL が設定されていると、LiteLLMはそれを優先し、 OPENAI_API_BASE.

モデル

モデルID 用途
claude-sonnet-5コーディングとエージェント作業の標準モデル：高速、高性能、中程度の価格。
claude-opus-5-5より難しい推論、大規模なリファクタリング、長時間のエージェント実行。
claude-fable-5-1最も高性能で最も高価。最も難しいタスクに絞って使いましょう。
claude-haiku-4-5低価格で高速：タイトル、要約、分類、小さな処理。

Aiderの短いエイリアス（sonnet, opus, haiku）は古いモデルIDを参照するため、モデル名を明示してください。次のような古い日付付きIDは、 claude-3-5-sonnet-20241022 提供されていません。

トラブルシューティング

表示される内容 原因 対処方法
404 / NotFoundError/v1 の提供先： ANTHROPIC_API_BASEがあるため、パスは次のようになります： /v1/v1/messagesホストのルートを設定してください： https://aiprimetech.io。末尾にスラッシュは付けません
LLM Provider NOT providedプロバイダーのプレフィックスがないモデル名使用するモデルは、 anthropic/claude-sonnet-5
AuthenticationError：認証できませんAiderを実行しているシェルにキーが設定されていないか、別のエンドポイント用のキーが設定されていますecho $ANTHROPIC_API_KEY。Windowsでは、次の操作の後に新しいターミナルを開いてください： setx
ファイル全体の書き換え、リポジトリマップなしAiderがモデル名を認識していません上記の .aider.model.settings.yml エントリを追加してください
Unknown context window size and costsモデルのメタデータがありませんメタデータファイルを追加するか、警告を無視してください
トークン上限エラーチャット内のファイル数が多すぎるか、ファイルが大きすぎます/tokens で使用量を確認し、 /drop でファイルを、 /clear で履歴を処理します
RateLimitError同時実行数またはレート制限の上限に達しましたAiderはバックオフを行いながら再試行します。同じキーで複数のセッションを実行することは避けてください
モデルがサポートされていないモデルIDが古いか、スペルが間違っています上の表にあるIDを使用してください

Aiderではなくモデル側に起因するエラーについては、次を参照してください： Claude APIエラーガイド.

よくある質問

カスタムのAnthropicベースURLでAiderを使うにはどうすればよいですか？
ANTHROPIC_API_BASEにゲートウェイのホストのルート（例：https://aiprimetech.io）を設定します。/v1や末尾のスラッシュは付けません。ANTHROPIC_API_KEYを設定し、aider --model anthropic/claude-sonnet-5.を実行してください。LiteLLMが/v1/messagesを付加します。
AiderはANTHROPIC_BASE_URLを読み取りますか？
はい。LiteLLMを通じて、フォールバックとして読み取ります。LiteLLMはまずANTHROPIC_API_BASEを確認し、次にANTHROPIC_BASE_URLを確認します。
新しいClaudeモデルを使うと、Aiderがファイル全体を書き換えるのはなぜですか？
Aiderがモデル名を認識せず、リポジトリマップを使わないwhole編集形式にフォールバックするためです。.aider.model.settings.ymlに、edit_format: diffとuse_repo_map: trueを指定したエントリを追加してください。
AiderでOpenAI互換のエンドポイントを使えますか？
はい。OPENAI_API_BASEに/v1を含むエンドポイントを設定し、OPENAI_API_KEYも設定したうえで、openai/プレフィックスを使ってください。例：aider --model openai/claude-sonnet-5.
数分でClaudeの利用を開始

APIキーを取得 — Anthropicアカウントもウェイトリストへの登録も不要です。

APIキーを取得

AI Prime Techは独立したAPIゲートウェイです。Anthropicとの提携関係はなく、同社の承認を受けておらず、同社の再販業者でもありません。Claudeおよび関連するモデル名は、それぞれの所有者の商標です。

Claude APIのその他のガイド

Claude APIキーの取得方法Claude API の料金を解説Claude APIを最も安く利用する方法Claude APIでCursorを無制限に利用Claude Codeへの無制限アクセスClaude APIゲートウェイとAnthropicへの直接接続の比較OpenAI SDK で Claude を使う：OpenAI 互換エンドポイント、ストリーミング、ツール、制限Claude モデルを解説：Claude Opus、Sonnet、Haiku、Fable のモデル比較 — すべての Claude API モデル、Anthropic のモデル名と料金（2026）暗号資産でClaude APIの料金を支払うウェイティングリストなしでClaude APIを利用Claudeのトークン使用量を削減する方法Claude APIでClineを無制限に利用Claude APIでRoo Codeを無制限に利用JetBrains IDEでClaudeを無制限に利用VS CodeでClaudeを無制限に利用Claude向けのOpenCode設定：opencode.jsonの設定、モデル、よくあるエラーゲートウェイ経由でHermes AgentとClaudeを使う：カスタムプロバイダーの設定、コスト管理、問題の解決方法ClaudeでOpenClawを無制限に実行Anthropic互換APIとはClaude CodeのAPIキー — ANTHROPIC_API_KEY：取得方法、設定方法、代わりにclaude setup-tokenを使うべき場合Claude Code APIのコスト — 料金と削減方法Claude APIエラーを解説：サーバーエラー500、過負荷529、レート制限429、不正なリクエスト400 — それぞれの解決方法Claude APIクレジットの購入方法 — Claudeクレジットがどの「Claudeアカウント購入」のオファーよりも優れている理由Claudeの無料API：無料のClaude APIキーはあるのか、2026に実際に無料で使えるものは？Claude APIとClaude Pro/Maxサブスクリプション — どちらを選ぶべきかカスタムプロバイダーでCodex CLIを使う：config.toml、GPTとClaudeのモデル、IDE拡張機能、問題の解決方法Claudeをn8nに接続するLiteLLMからClaudeへのルーティングKilo CodeでClaudeを使うゲートウェイ経由でGitHub Copilot ChatとClaudeを使う：Custom Endpointの設定、エージェントモード、問題の解決方法ゲートウェイ経由でZedをClaudeに接続するCherry StudioをClaudeに接続LangChainのChatAnthropic：インポート、base_url、ストリーミング、ツール、エラーAnthropic Python SDK：インストール、base_urlの設定、ストリーミング、エラー処理Vercel AI SDKでClaudeを使用：createAnthropicのbaseURL、ストリーミング、問題の修正ClaudeでFactory Droidを実行Claude Code APIの仕組みを解説アプリケーションへのClaude APIの統合Claudeを無制限に利用する方法 — 「Claude Codeのクラック版」が存在しない理由

その他の Claude API ガイド

Anthropic互換APIとはAnthropic Python SDK：インストール、base_urlの設定、ストリーミング、エラー処理Claude APIクレジットの購入方法Claude APIを最も安く利用する方法Claude APIエラーを解説：サーバーエラー500、過負荷529、レート制限429、不正なリクエスト400 — それぞれの解決方法Claudeの無料API：無料のClaude APIキーはあるのか、2026に実際に無料で使えるものは？アプリケーションへのClaude APIの統合Claude モデルを解説：Claude Opus、Sonnet、Haiku、Fable のモデル比較 — すべての Claude API モデル、Anthropic のモデル名と料金（2026）Claude API の料金を解説Claude APIゲートウェイとAnthropicへの直接接続の比較Claude APIとClaude Pro/Maxサブスクリプション — どちらを選ぶべきか暗号資産でClaude APIの料金を支払うウェイティングリストなしでClaude APIを利用Claude Code APIの仕組みを解説Claude Code APIのコスト — 料金と削減方法Claude CodeのAPIキー — ANTHROPIC_API_KEY：取得方法、設定方法、代わりにclaude setup-tokenを使うべき場合Claudeを無制限に利用する方法Claude API キーの取得方法Claudeのトークン使用量を削減する方法OpenAI SDK で Claude を使う：OpenAI 互換エンドポイント、ストリーミング、ツール、制限ゲートウェイ経由でHermes AgentとClaudeを使う：カスタムプロバイダーの設定、コスト管理、問題の解決方法ClaudeでOpenClawを無制限に実行Claude APIへの無制限アクセスとは無制限のClaude APIキーを取得する方法Claude Codeを無制限に利用 — トークン制限なしClaude Opus 4.8への無制限アクセスClaudeを無制限に利用 — プランと料金Cherry StudioをClaudeに接続Claude Codeへの無制限アクセスClaude APIでClineを無制限に利用カスタムプロバイダーでCodex CLIを使う：config.toml、GPTとClaudeのモデル、IDE拡張機能、問題の解決方法Claudeの無制限アクセスでCursorを使うClaudeでFactory Droidを実行ゲートウェイ経由でGitHub Copilot ChatとClaudeを使う：Custom Endpointの設定、エージェントモード、問題の解決方法JetBrains IDEでClaudeを無制限に利用Kilo CodeでClaudeを使うLangChainのChatAnthropic：インポート、base_url、ストリーミング、ツール、エラーLiteLLMからClaudeへのルーティングClaudeをn8nに接続するClaude向けのOpenCode設定：opencode.jsonの設定、モデル、よくあるエラーClaude APIでRoo Codeを無制限に利用Vercel AI SDKでClaudeを使用：createAnthropicのbaseURL、ストリーミング、問題の修正VS CodeでClaudeを無制限に利用ゲートウェイ経由でZedをClaudeに接続する