AICLI CHEATS ● CHAPTER 01 · Aider Community (OSS) / Aider 最終更新 2026.05.18
01
Aider Community (OSS)
Aider
OSS のターミナル型 AI コーディングツール。/add /architect /code、git連携、設定ファイルの早見表。
LAST CHECK05.182026
凡例 / LEGEND
🟢安全 読み取り専用
🟡注意 書込・課金・送信
🔴 危険 権限スキップ・破壊操作
公開 2026.05.17 更新 2026.05.18 公式 →

Python 製のターミナル型 AI コーディングツール。Apache 2.0 ライセンスの OSS。Claude Code や Codex CLI と比べると軽量で、「git と組み合わせた変更管理」が最初から強く意識されているのが特徴。

複数 LLM プロバイダ（Anthropic、OpenAI、Gemini、ローカルモデル等）にそのまま接続できる。

凡例

  • 🟢 安全 — 読み取り・参照のみ
  • 🟡 注意 — ファイル編集・課金発生
  • 🔴 危険 — 破壊的操作リスクあり

クイックリファレンス

起動オプション

コマンドリスク用途
aider🟡通常起動（git status を読んで対象ファイル提案）
aider <files>🟢編集対象を指定して起動
aider --model <name>🟢モデル指定（sonnet / gpt-5.4 / gemini/…）
aider --read <file>🟢読み取り専用で context に追加
aider --architect --editor-model <name>🟡Architect + Coder の二段運用
aider --no-auto-commits🟢自動 commit を無効化

スラッシュコマンド（セッション中）

コマンド用途
/add <files>ファイルを編集対象に追加
/drop <files>ファイルを編集対象から除外
/read <file>読み取り専用で context に追加
/architectアーキテクト（設計）モード
/codeコーダー（実装）モード（デフォルト）
/ask <q>コード変更せず質問だけ
/diff直近の変更を diff 表示
/undo直近の AI 変更を取り消し
/commit手動で git commit
/test <cmd>テスト実行（失敗を Aider に渡す）
/lint <cmd>linter 実行
/model <name>モデル切替
/clear履歴クリア
/helpコマンド一覧

インストール

# pip
pip install aider-install
aider-install

# uv（推奨、高速）
uv tool install --force --python python3.12 aider-chat@latest

公式の Installation ガイド も参照。

認証は環境変数で API キーを渡す:

export ANTHROPIC_API_KEY=sk-ant-...
export OPENAI_API_KEY=sk-...
export GEMINI_API_KEY=...

起動

基本

cd your-project
aider

🟡 注意 / 自動的に git status を見て、関連ファイルを context に入れる。初回は Add files to the chat? と聞かれるので、編集対象のファイルだけ入れる。

モデル指定

aider --model sonnet               # Claude Sonnet
aider --model gpt-5.4              # GPT 系
aider --model gemini/gemini-2.5-pro

サポートモデル一覧 は公式参照。Aider は LiteLLM ベースなので、ほぼ全てのプロバイダで動く。

編集対象ファイルを最初から指定

aider src/auth.ts tests/auth.test.ts

🟢 安全 / 起動時に「これらを編集します」と Aider に伝える。

スラッシュコマンドのコツ

一覧は冒頭のクイックリファレンス参照。実戦で効くのは /test と /lint。失敗ログがそのまま Aider に渡って自動修正のループに入るので、TDD 的な進め方と相性がいい。

Architect / Coder モード

Aider 特有の2モード設計。

モード役割
Architect設計判断・大枠の方針を作る。コードは書くが diff として提示するだけ
CoderArchitect の出力を受けて実際にファイルを編集する

/architect で切り替えると、Architect が考えた方針を別モデル（Coder）が実装する流れになる。

# 起動時から2モデル分離
aider --architect --model sonnet --editor-model haiku

🟡 注意 / 別モデルを使うので料金が二重にかかる。シンプルな変更なら不要、複雑な refactor のときに効く。

設定ファイル

.aider.conf.yml             # プロジェクトの設定
~/.aider.conf.yml           # ユーザー全体
.aider.model.settings.yml   # モデル固有の設定
.env                        # API キー等

.aider.conf.yml の例:

model: sonnet
auto-commits: true
git: true
attribute-author: true
read:
  - CLAUDE.md
  - docs/architecture.md

🟡 注意 / .aider.conf.yml を git に上げると、チーム全員に同じ設定が共有される。API キーは別途 .env に分離。

Git 連携

Aider の最大の特徴。デフォルトで:

  1. AI が変更した瞬間に 自動で git commit
  2. コミットメッセージは AI が生成
  3. 「Aider が変更」「ユーザーが変更」の区別が log に残る
git log --oneline
# AI が変更したコミットは "(aider)" タグ付き

メリット: いつでも git revert や aider --undo で戻せる安心感

デメリット: コミットが細かく増える。マージ前に git rebase -i で squash が必要

無効化したいなら:

aider --no-auto-commits

または .aider.conf.yml で auto-commits: false。

読み取り専用ファイル

context に入れるが Aider に編集させない:

aider --read CLAUDE.md --read docs/spec.md src/auth.ts

🟢 安全 / 設計ドキュメントや既存コードの参考は read で。

セキュリティで意識すること

  • API キーは 必ず環境変数か .env で。.aider.conf.yml に直書きしない
  • --auto-commits が ON なら、機密ファイルが間違って commit されないか定期確認
  • .aiderignore で .env secrets/ *.pem などを除外
  • Architect モードで別プロバイダのモデル使う場合、両方のキーが必要 = 二重露出注意
  • /test /lint で実行されるコマンドは Aider が解釈なしで shell に流すので、信頼できるスクリプトのみ

つまづきがちな点

「Aider が大量のファイルを context に詰め込む」 → 起動時に /add で必要なファイルだけ指定する。/drop で削れる。

「料金が想定より高い」 → Architect モードで Opus 等の高額モデルを使っているとき。Coder 側を Haiku に倒すと安くなる。/help の Token usage で確認。

「git commit が細かすぎて履歴がうるさい」 → マージ前に git rebase -i で squash。または --no-auto-commits で完全手動。

「特定の LLM プロバイダで動かない」 → LiteLLM の対応モデル一覧を確認。プロバイダ固有のエンドポイント URL が必要なケースあり（OPENAI_API_BASE 等の環境変数）。

このページは執筆時点の挙動。Aider は OSS で更新頻度が高いので、致命的な変更は 公式ドキュメント と GitHub release を確認してから使う。