はじめに
前回の記事で WSL Ubuntu に aider + Ollama をインストールしました。今回はその続きで、aider を使いこなすためのオプションやコマンドを紹介します。
本テーマは 3 回にわけて紹介予定です。
- インストール編（前回）
- aider のオプション編（今回）
- 実践編
全部を網羅するのではなく、初心者が最初に押さえておけば十分なものに絞りました。
目次
対象者
- aider をインストールしたけど、オプションがよくわからない人
- ローカル LLM（Ollama）で aider を快適に使いたい人
- チャット中のスラッシュコマンドを知りたい人
環境
- WSL2 Ubuntu
- Ollama インストール済み
- aider インストール済み（前回の記事参照）
推奨する起動コマンド
まずはこれをコピペして動かしてみてください。
aider --model ollama_chat/qwen2.5-coder:7b --edit-format whole --no-auto-commits
| オプション | 説明 | 備考 |
|---|---|---|
--model ollama_chat/<model> |
使用モデルを指定 | |
--edit-format whole |
ファイル全体を出力する形式 | 7B クラスでは diff 形式だと差分の書式を間違えてファイルが壊れやすい |
--no-auto-commits |
自動コミットを無効化 | デフォルトだと変更のたびにコミットされます。手動コミットしたい場合に追加してください |
スラッシュコマンド
チャット中に / で始まるコマンドが使えます。
| カテゴリ | コマンド | 説明 |
|---|---|---|
| ファイル管理 | /add <file> |
ファイルを編集対象として追加（ワイルドカード可） |
/drop <file> |
ファイルをセッションから除外（引数なしで全除外） | |
/ls |
現在チャットに含まれるファイル一覧を表示 | |
| 質問と変更 | /ask <質問> |
コードを変更せず質問のみ（調査・確認用） |
/code <依頼> |
コード変更を依頼 | |
| 実行・確認 | /run <コマンド> |
シェルコマンドを実行し、出力をチャットに送れる |
!<コマンド> |
/run のエイリアス（短縮形） |
|
/diff |
直前の変更の diff を表示 | |
| Git 操作 | /commit |
現在の変更をコミット |
/undo |
直前の git コミットを取り消し（ファイル変更も巻き戻す） | |
| セッション | /clear |
チャット履歴をクリア（ファイルリストは保持） |
/tokens |
現在のトークン使用量を表示 | |
/help |
ヘルプを表示 | |
/exit |
aider を終了する（/quit でも可） |
|
Ctrl+C |
生成途中で中断する |
補足
-
テキスト直打ち =
/code相当です。>プロンプトにそのまま入力すると aider はコードを書き換えようとします。質問だけしたい場合は必ず/askを付けてください -
/addはワイルドカードも使えます（/add src/*.py） -
!は/runのエイリアス（短縮形）です。出力はそのままチャットのコンテキストに入るので、「実行したらエラーが出た、直して」という流れがスムーズにできます -
/undoは aider が生成したコードが微妙だったときに即座にロールバックできます -
/tokensはコンテキスト上限に近づいているか確認できるので、ローカル LLM では地味に重要です
設定ファイル
毎回長いオプションを打つのは面倒なので、設定ファイルにまとめておくのがおすすめです。
aider を使いたいプロジェクトのルートに以下をコピペして設定ファイルを作成します。
cat > .aider.conf.yml << 'EOF'
# モデル設定
model: ollama_chat/qwen2.5-coder:7b
# Git 設定
auto-commits: false
# 編集形式（ローカル LLM では whole が安定）
edit-format: whole
EOF
これでプロジェクトルートから aider だけで起動できます。
aider
補足: ホームディレクトリ（
~/.aider.conf.yml）にも置けます。プロジェクトルートに.aider.conf.ymlがあればそちらが優先されます。
まとめ
| カテゴリ | よく使うもの |
|---|---|
| 起動オプション |
--model, --edit-format whole, --no-auto-commits
|
| ファイル管理 |
/add, /drop, /ls
|
| 質問と変更 |
/ask（質問のみ）, /code（変更依頼）。テキスト直打ち = /code
|
| 実行・確認 |
/run（!）, /diff, /undo
|
| セッション |
/clear, /tokens
|
| 設定ファイル |
.aider.conf.yml にまとめると楽 |
ローカル LLM で aider を使う場合のポイントは 2 つです。
-
--edit-format wholeを使う（diff 形式は 7B クラスだと不安定） -
/askで確認してから/codeで変更 する（いきなり書き換えさせない）
次回は実践編として、実際に aider + Ollama でコードを生成させた結果と性能評価を紹介します。
関連記事
ローカル LLM でvibecoding環境(aider + Ollama)を立ち上げてみよう
ローカル LLM でvibecoding環境(aider + Ollama)を立ち上げてみよう（オプション編）<=本記事