Aider 連携
QCode.cc で Aider を設定：Claude は Anthropic エンドポイント（anthropic/ プレフィックス）、GPT と中国系モデルは OpenAI 互換エンドポイント
目次
最終確認：2026-09-18 · 📄 公式ドキュメント準拠（上流リポジトリ、状態は下記の注記参照）
上流の活動状況：Aider-AI/aider の最終コミットは 2026-05-22 で、以降の新規リリースはありません（2026-09-18 に GitHub API で確認）。本ページの接続方法はそのまま利用可能です。活発な保守が必要な場合は Cline や Kilo Code を検討してください。
概要¶
| 項目 | 内容 |
|---|---|
| 利用できるモデル | Claude ✅（anthropic/ プレフィックスで Anthropic エンドポイント）· GPT ✅ · 中国系モデル ✅（OpenAI 互換）· Gemini ❌（本ページは Gemini を扱わない） |
| プロトコルと Base URL | Anthropic：https://api.qcode.cc/api · OpenAI：https://api.qcode.cc/openai/v1 |
| 関連環境変数 | ANTHROPIC_API_BASE と OPENAI_API_BASE がそれぞれ両経路を指す |
| 設定場所 | CLI 引数または ~/.aider.conf.yml |
| 公式ドキュメント | aider.chat |
Aider はターミナルで動く人気のオープンソース AI ペアプログラマ（GitHub 39K+ スター）で、100 以上の言語に対応します。内部で LiteLLM を使ってモデルをルーティングするため、Anthropic と OpenAI の両プロトコルに対応しています。
🔴 最初にこれ：Claude は Anthropic エンドポイントが必須¶
QCode の OpenAI 互換エンドポイントは Claude モデルを受け付けません。OPENAI_API_BASE を QCode に向けて openai/claude-… というモデル名を使うと model_not_available_on_endpoint が返ります。
| 使いたいモデル | Aider のモデル名プレフィックス | 環境変数 | 値 |
|---|---|---|---|
| Claude | anthropic/ |
ANTHROPIC_API_BASE |
https://api.qcode.cc/api |
| GPT 系 / 中国系 4 ファミリー | openai/ |
OPENAI_API_BASE |
https://api.qcode.cc/openai/v1 |
対応表は エンドポイントと API パス を参照。
Aider を選ぶ理由¶
- 完全オープンソース：API 利用料のみ
- Architect モード：一方が計画、もう一方が編集。品質が上がる
- Git 深い統合：AI の編集ごとに git commit
- Repository Map：tree-sitter によるコードベース全体のインデックス
- 両プロトコル対応：Claude は Anthropic、GPT / 中国系は OpenAI
インストール¶
# pipx 推奨（隔離インストール）
pipx install aider-chat
# または pip
pip install aider-chat
Claude の設定（Anthropic エンドポイント）¶
export ANTHROPIC_API_BASE="https://api.qcode.cc/api"
export ANTHROPIC_API_KEY="cr_あなたのQCodeキー"
aider --model anthropic/claude-sonnet-5
LiteLLM がこの base に /v1/messages を自動で連結するため、/api までとし末尾スラッシュは付けません。
変数名はバージョンで異なることがあります：LiteLLM では
ANTHROPIC_API_BASEとANTHROPIC_BASE_URLの両方が使われてきました。片方が効かない場合はもう片方を、あるいはコマンドライン引数--anthropic-api-keyを試してください。詳細は Aider 公式ドキュメント。
永続化（~/.zshrc または ~/.bashrc に追記）：
echo 'export ANTHROPIC_API_BASE="https://api.qcode.cc/api"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="cr_あなたのQCodeキー"' >> ~/.zshrc
source ~/.zshrc
GPT と中国系モデルの設定（OpenAI 互換エンドポイント）¶
export OPENAI_API_BASE="https://api.qcode.cc/openai/v1"
export OPENAI_API_KEY="cr_あなたのQCodeキー"
aider --model openai/gpt-5.5
中国系 4 ファミリー（glm-5.2 / kimi-k3 / deepseek-v4-pro / qwen3.7-max など）は両方のレッグで動きます。id は 中国系モデル連携 を参照。
使い方¶
cd /path/to/your/project
# 日常の主力
aider --model anthropic/claude-sonnet-5
# 旗艦モデル
aider --model anthropic/claude-opus-5
Architect モード（推奨）¶
一方が計画し、もう一方が編集を適用します：
# Opus が計画 + Sonnet が編集（推奨）
aider --architect --model anthropic/claude-opus-5 --editor-model anthropic/claude-sonnet-5
# Sonnet が計画 + Haiku が編集（低コスト）
aider --architect --model anthropic/claude-sonnet-5 --editor-model anthropic/claude-haiku-4-5
2 つのモデルは同じプロトコルレッグである必要があります。混在（例：
anthropic/で計画、openai/claude-…で編集）すると編集側で拒否されます。
よく使うコマンド¶
Aider セッション内：
| コマンド | 説明 |
|---|---|
/add file.py |
ファイルをチャットのコンテキストに追加 |
/drop file.py |
ファイルを除外 |
/run pytest |
コマンドを実行し出力を AI に送る |
/diff |
すべての変更を表示 |
/undo |
直前の AI 編集を取り消す |
/commit |
現在の変更をコミット |
/help |
ヘルプを表示 |
バックアップノード¶
4 つのアクセスドメインは機能的に同一で、違いはネットワーク経路だけです。キーは共通：
| ノード | Anthropic（Claude） | OpenAI（GPT / 中国系） |
|---|---|---|
| グローバル | https://api.qcode.cc/api |
https://api.qcode.cc/openai/v1 |
| アジア（中国本土推奨） | https://asia.qcode.cc/api |
https://asia.qcode.cc/openai/v1 |
| 米国 | https://us.qcode.cc/api |
https://us.qcode.cc/openai/v1 |
| 欧州 | https://eu.qcode.cc/api |
https://eu.qcode.cc/openai/v1 |
利用可能なモデル¶
| モデル | Aider での名前 | 説明 |
|---|---|---|
| Claude Sonnet 5 | anthropic/claude-sonnet-5 |
推奨、コスパ良好 |
| Claude Opus 5 | anthropic/claude-opus-5 |
最も高性能 |
| Claude Haiku 4.5 | anthropic/claude-haiku-4-5 |
低コスト・高速 |
| GPT 5.5 | openai/gpt-5.5 |
OpenAI 旗艦 |
| GLM 5.2 | openai/glm-5.2 |
中国系、単価が低い |
claude-sonnet-4-6、claude-opus-4-8などの 4.x も引き続き販売中です（プレフィックスは同じくanthropic/）。最新一覧は qcode.cc/models。
Claude Code CLI との比較¶
| 観点 | Aider | Claude Code CLI |
|---|---|---|
| オープンソース | 完全オープン | クローズド |
| Git 統合 | 編集ごとに自動 commit | 手動 /commit |
| Architect モード | 2 モデルで計画+編集 | 単一モデル |
| ツール能力 | ファイル編集 + Shell | より豊富（LSP、検索、ブラウザ） |
| コンテキスト管理 | Repository Map インデックス | 20 万〜100 万トークン |
| クォータ | QCode.cc プランを共有 | QCode.cc プランを共有 |
おすすめの組み合わせ：素早い修正と Architect モードの計画には Aider、複雑なプロジェクト分析や自動化には Claude Code CLI。
よくある質問¶
model_not_available_on_endpoint が出る¶
Claude モデルを OpenAI レッグに送っています。2 点を確認してください：モデル名のプレフィックスは openai/ ではなく anthropic/、base は ANTHROPIC_API_BASE=https://api.qcode.cc/api。
"Model not found" が出る¶
Aider はプレフィックスで provider を判断します：
# 正しい
aider --model anthropic/claude-sonnet-5
# 誤り（プレフィックスなし）
aider --model claude-sonnet-5
API 呼び出しがタイムアウトする¶
別ノードに切り替えるか、タイムアウトを延ばします：
aider --model anthropic/claude-sonnet-5 --timeout 120
次のステップ¶
- エンドポイントと API パス — プロトコル × モデルファミリー対応表
- Cline 連携 — VS Code の GUI 代替
- コマンドラインのコツ — Claude Code の高度な使い方
- Aider 公式ドキュメント