# Aider 連携

> **最終確認**：2026-09-18 · 📄 公式ドキュメント準拠（上流リポジトリ、状態は下記の注記参照）

> **上流の活動状況**：Aider-AI/aider の最終コミットは 2026-05-22 で、以降の新規リリースはありません（2026-09-18 に GitHub API で確認）。本ページの接続方法はそのまま利用可能です。活発な保守が必要な場合は [Cline](/docs/ide/cline) や [Kilo Code](/docs/ide/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](https://aider.chat) |

[Aider](https://github.com/paul-gauthier/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 パス](/docs/getting-started/endpoints-and-api-paths) を参照。

## Aider を選ぶ理由

- **完全オープンソース**：API 利用料のみ
- **Architect モード**：一方が計画、もう一方が編集。品質が上がる
- **Git 深い統合**：AI の編集ごとに git commit
- **Repository Map**：tree-sitter によるコードベース全体のインデックス
- **両プロトコル対応**：Claude は Anthropic、GPT / 中国系は OpenAI

## インストール

```bash
# pipx 推奨（隔離インストール）
pipx install aider-chat

# または pip
pip install aider-chat
```

## Claude の設定（Anthropic エンドポイント）

```bash
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 公式ドキュメント](https://aider.chat/)。

永続化（`~/.zshrc` または `~/.bashrc` に追記）：

```bash
echo 'export ANTHROPIC_API_BASE="https://api.qcode.cc/api"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="cr_あなたのQCodeキー"' >> ~/.zshrc
source ~/.zshrc
```

## GPT と中国系モデルの設定（OpenAI 互換エンドポイント）

```bash
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 は [中国系モデル連携](/docs/usage/cn-models) を参照。

## 使い方

```bash
cd /path/to/your/project

# 日常の主力
aider --model anthropic/claude-sonnet-5

# 旗艦モデル
aider --model anthropic/claude-opus-5
```

### Architect モード（推奨）

一方が計画し、もう一方が編集を適用します：

```bash
# 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](https://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 を判断します：

```bash
# 正しい
aider --model anthropic/claude-sonnet-5

# 誤り（プレフィックスなし）
aider --model claude-sonnet-5
```

### API 呼び出しがタイムアウトする

別ノードに切り替えるか、タイムアウトを延ばします：

```bash
aider --model anthropic/claude-sonnet-5 --timeout 120
```

## 次のステップ

- [エンドポイントと API パス](/docs/getting-started/endpoints-and-api-paths) — プロトコル × モデルファミリー対応表
- [Cline 連携](/docs/ide/cline) — VS Code の GUI 代替
- [コマンドラインのコツ](/docs/usage/cli-tips) — Claude Code の高度な使い方
- [Aider 公式ドキュメント](https://aider.chat/)