🚀 AiderをCodingPlanXカスタムモデルに接続する
> はじめに：このドキュメントでは、人気のオープンソースAIプログラミングアシスタントであるAiderを使用して、CodingPlanX.ai APIにシームレスに接続し、ターミナルで究極のAI支援プログラミング体験を得る方法を案内します。
Aider は、非常に人気の高いオープンソースのコマンドラインAIプログラミングアシスタントです（GitHub 39K+ Stars）。ターミナルで直接実行され、100以上のプログラミング言語をサポートしています。簡単な環境変数の設定だけで、AiderをCodingPlanX.aiの強力なモデルに接続できます。
✨ なぜAiderを選ぶのか？
- 🆓 完全オープンソースで無料：ソフトウェア自体は無料です。CodingPlanX.aiのAPI側の料金のみお支払いいただきます。
- 🧠 Architect モード：独自のデュアルモデル協調メカニズム（1つのモデルがアーキテクチャの計画を担当し、もう1つがコード作成を担当）により、複雑なタスクのコード品質を大幅に向上させます。
- 🌳 Repository Map：
tree-sitter技術に基づき、コードベース全体の構造マップをインテリジェントに生成・理解します。 - 🔗 Git への深い統合：AIによるコード変更のたびに、標準化されたGitコミット履歴が自動的に生成され、いつでも簡単にロールバックできます。
- ⚡ 極めてシンプルな設定：2行の環境変数だけで、CodingPlanX.aiに素早く接続できます。
🛠️ 準備とインストール
1. 前提条件
- Python 3.8 以降がインストールされていること。
- CodingPlanX.ai の API キー（
cr_で始まる）を取得していること。
2. Aider のインストール
他のPythonパッケージとの依存関係の競合を避けるため、pipx を使用した分離インストールを推奨します：
# 推奨：pipx を使用（グローバルに分離してインストール）
pipx install aider-chat
# 代替：従来の pip を使用
pip install aider-chat
⚙️ CodingPlanX.ai の設定
CodingPlanX.aiはOpenAI形式と互換性のあるインターフェースを提供しているため、OpenAIの設定項目をそのまま使用してClaudeモデルに接続できます。
方法1：環境変数による設定（🌟 推奨）
これは最も便利な方法です。設定後は、Aiderを起動するたびにキーを入力する必要がなくなります。
一時的に有効にする（現在のターミナルウィンドウのみ）：
export OPENAI_API_BASE="https://api.codingplanx.ai/v1"
export OPENAI_API_KEY="cr_your_api_key"
永続的に有効にする（設定ファイルに書き込む）：
macOS または Linux を使用している場合は、以下の内容を ~/.zshrc または ~/.bashrc に追加してください：
echo 'export OPENAI_API_BASE="https://api.codingplanx.ai/v1"' >> ~/.zshrc
echo 'export OPENAI_API_KEY="cr_your_api_key"' >> ~/.zshrc
source ~/.zshrc
方法2：コマンドライン引数による設定
環境変数を設定したくない場合は、起動時に引数として渡すこともできます：
aider --openai-api-base "https://api.codingplanx.ai/v1" \
--openai-api-key "cr_your_api_key" \
--model openai/claude-sonnet-4-6
💻 使用を開始する
基本的な対話モード
プロジェクトディレクトリに入り、直接Aiderを起動します：
cd /path/to/your/project
# Aider を起動（デフォルトでは Claude Sonnet の使用を推奨）
aider --model openai/claude-sonnet-4-6
# 複雑な問題に遭遇した場合は、より強力な Claude Opus に切り替えることができます
aider --model openai/claude-opus-4-6
Architect（アーキテクト）モード（🌟 強く推奨）
Architect モードは Aider のキラー機能です。賢いモデル（例：Opus）にまず思考と計画を行わせ、その後、具体的なコード変更作業を実行力の高いモデル（例：Sonnet や Haiku）に任せます。これにより、コードの品質を確保しつつ、APIのコストを節約できます。
# プランA：Opusが計画を担当 + Sonnetが実行を担当（究極の品質を追求）
aider --architect --model openai/claude-opus-4-6 --editor-model openai/claude-sonnet-4-6
# プランB：Sonnetが計画を担当 + Haikuが実行を担当（品質と低コストの両立）
aider --architect --model openai/claude-sonnet-4-6 --editor-model openai/claude-haiku-4-5-20251001
⌨️ Aider よく使うショートカットコマンド
Aider 起動後のインタラクティブセッションでは、以下のスラッシュコマンドを入力できます：
| コマンド | 詳細説明 |
|---|---|
/add file.py | 指定したファイルをAIのコンテキストに追加します（AIはaddされたファイルのみ変更可能） |
/drop file.py | 指定したファイルをコンテキストから削除し、トークンを節約します |
/run pytest | ターミナルコマンド（テストなど）を実行し、エラー出力を自動的にAIに渡して修正させます |
/diff | 現在AIがどのコードを変更したかを確認します（git diffに似ています） |
/undo | 直前のAIによるコード変更を元に戻します |
/commit | 現在の変更をGitに手動でコミットします |
/help | 利用可能なすべてのコマンドのヘルプを表示します |
サポートされているモデルリスト
| モデルのポジショニング | Aiderで入力するモデル名 | 説明 |
|---|---|---|
| 主力推奨 | openai/claude-sonnet-4-6 | スピードと知能の完璧なバランス、コストパフォーマンスが極めて高い |
| 最強の推論 | openai/claude-opus-4-6 | 極めて複雑なロジックやアーキテクチャ設計の処理に適している |
| 超高速・低価格 | openai/claude-haiku-4-5-20251001 | レスポンスが非常に速く、実行モデルや単純なタスクの処理に適している |
⚖️ 選択ガイド：Aider vs Claude Code CLI
Aiderを使用するか、公式のClaude Code CLIを使用するか迷っている場合は、以下の表を参考にしてください：
| 比較項目 | 🤖 Aider | 💻 Claude Code CLI |
|---|---|---|
| オープンソース状態 | 完全オープンソースで無料 | クローズドソースの商用ソフトウェア |
| Git 統合 | 自動コミット（変更ごとに履歴を残す） | 手動で /commit を入力する必要がある |
| ワークフロー | マルチモデル協調(Architectモード)をサポート | 単一モデルの対話 |
| ツールの機能 | ファイル編集 + Shell実行に特化 | より豊富（LSP、グローバル検索、ブラウザなどをサポート） |
| コンテキスト管理 | Repo Map (AST 構文ツリーのインテリジェントなインデックス) | 20万〜100万の超大トークンウィンドウに依存して強引に処理 |
💡 当社の推奨事項：
- Aider を使用する：頻繁な日常的なコード変更、リファクタリング、およびArchitectモードを利用した精密な開発を行う場合。
- Claude Code CLI を使用する：AIに巨大な未知のプロジェクトを自律的に分析させたり、複雑な自動化Terminalタスクを実行させたりする必要がある場合。
❓ よくある質問 (FAQ)
Q: 起動時に "Model not found" というエラーが出る場合は？
A: モデル名に openai/ プレフィックスが欠けていないか確認してください。
- ❌ 誤り：
aider --model claude-sonnet-4-6 - ✅ 正解：
aider --model openai/claude-sonnet-4-6
Q: AIの思考時間が長すぎ、API呼び出しのタイムアウトが表示される場合は？ A: ネットワークの変動や複雑なタスクが原因である可能性があります。以下をお試しください：
- 上記で言及した「代替APIノード」に切り替える。
- 起動時にタイムアウト時間のパラメータを増やす：
aider --model openai/claude-sonnet-4-6 --timeout 120