AIエージェント入門

Claude Code /config完全ガイド|モデル切替とAuto-Compactを使いこなす

Claude Code /config完全ガイド|モデル切替とAuto-Compactを使いこなす

この記事の結論

Claude Codeの/configコマンドが制御する設定を全解説。モデル選択・Auto-Compact・Extended Thinking・出力スタイルの最適化手順をコピペ可能な設定例とともに紹介。

「Claudeの回答が冗長すぎる」「コンテキストが切れるタイミングが早い」——Claude Codeを日常的に使い始めると、こういった細かい不満が積み重なってくる。

それらの大半は /config(エイリアス: /settings)コマンド一つで解決できる。ところが、設定項目が多すぎて何を変えればいいか分かりにくい。実際に100社以上のAI導入支援の現場で使ってきた経験から、「これだけ調整すれば体感が変わる」設定に絞って解説する。

AIエージェント設計の基本についてはAIエージェント構築完全ガイドも参照してほしい。

まず試したい「5分即効」設定3選

/configを開いたらまずここを変えてみよう。体感が変わる順に並べた。

即効テクニック1: 出力スタイルを用途で切り替える

/configの「Style」タブで以下の4モードから選択できる。

モード 特徴 向いている場面
Normal デフォルト。バランス型 汎用的な作業全般
Concise 短く直接的な応答 コード生成・リファクタ中心のセッション
Explanatory 概念の説明つき・教育的 新しいフレームワークを学びながら実装するとき
カスタム 任意のインストラクション プロジェクト固有のコーディングルールを強制したいとき

コマンドラインから直接スタイルを切り替えることもできる。デバッグ作業が多い日は /output-style concise で余計な説明を省くのが効果的だ。

# インタラクティブセッション内で即時切り替え
/output-style concise

# または /fast コマンドも同じ効果
/fast

動作環境: Claude Code v2.1.x以上 / インタラクティブREPLセッション内で実行

即効テクニック2: Auto-Compactの閾値を調整する

デフォルトではコンテキストウィンドウの90%に達したタイミングで自動要約(Auto-Compact)が走る。長時間のデバッグセッションでは、要約品質を上げるために閾値を80%に下げるのが有効だ。

# ~/.bashrc または ~/.zshrc に追加
export CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=80

# 設定反映確認(新しいターミナルで)
echo $CLAUDE_AUTOCOMPACT_PCT_OVERRIDE

または /config の「Auto-compact」設定から直接オフにすることもできる。長時間の実装セッションで「要約されて文脈が切れた」と感じる場合は、まずここを試してほしい。

ポイント: 要約を80%時点で行うと、その後の20%分のコンテキストが「要約後の余裕」として残る。これにより要約自体の品質が上がる。

即効テクニック3: Extended Thinkingをタスクに応じてコントロール

Extended Thinking(内部推論パス)はデフォルトで有効になっている。複雑なアーキテクチャ設計には必要だが、単純なコード補完では逆に遅くなる原因になる。

# Extended Thinkingを無効化(シンプルタスク向け)
export CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1

# 思考トークンの上限を設定(有効時)
export MAX_THINKING_TOKENS=10000

/configの「Extended Thinking」トグルからも切り替えられる。

3つのアプローチで/configを理解する

アプローチ 対象 主な設定項目
パフォーマンス調整 速度・コスト最適化 モデル選択、Extended Thinking、Fast Mode
セッション品質改善 長時間の作業品質 Auto-Compact、Rewindチェックポイント
出力スタイル設定 応答の見やすさ 出力スタイル、Verbose、ターン時間表示

モデル選択——/model コマンドとの連携

/configでモデルを固定することもできるが、実務では /model コマンドでセッション中に動的に切り替えるのが効率的だ。

# 2026年4月時点の利用可能なモデル一覧
/model

# 高度な推論が必要なアーキテクチャ設計フェーズ
/model claude-opus-4-6

# コード生成・リファクタの量産フェーズ
/model claude-sonnet-4-6

# 1Mトークンの長大コンテキストが必要な場合
/model claude-sonnet-4-6[1m]

# 単純なドキュメント整理や反復タスク
/model claude-haiku-4-5

動作環境: Claude Code v2.x / claude.aiアカウント(各モデルのサブスクリプション必要)

コスト観点の参考値(実際のコストはAnthropicの公式料金ページで確認のこと、最終確認日: 2026-04-07):

モデル 得意なタスク 相対速度
Opus 4.6 複雑な設計判断・深い推論 低速
Sonnet 4.6 コーディング全般(メイン) 中速
Haiku 4.5 軽量な反復タスク 高速

設定ファイルで永続化する——settings.json

/configで変更した内容の多くは ~/.claude/settings.json に書き込まれる。プロジェクト固有の設定は .claude/settings.json(リポジトリルート)に置くことでチーム共有もできる。

// ~/.claude/settings.json の主要設定例
// 注意: 本番環境で使用する前に、必ずテスト環境で動作確認してください。
{
  "model": "claude-sonnet-4-6",
  "autoCompact": true,
  "alwaysThinkingEnabled": true,
  "cleanupPeriodDays": 30,
  "includeCoAuthoredBy": false
}

プロジェクトルートに置く .claude/settings.json はチームメンバーと共有できる。ただし ~/.claude/settings.json(グローバル)より優先度が高いため、プロジェクト固有の上書きとして機能する。

Rewindチェックポイント——コードを壊した時の保険

/configの「Rewind checkpoints」をオンにすると、Claudeがファイルを変更する前に自動スナップショットを取る。大規模なリファクタ中に「やっぱり戻したい」となった時の保険として有効だ。

# チェックポイントから特定ファイルを戻す
/rewind

# ターミナル内でインタラクティブに操作
# 矢印キーでチェックポイントを選択、Enterで復元

【要注意】よくある設定ミスと回避策

失敗1: 全設定をGlobal(~/.claude)に書いてしまう

❌ プロジェクトA用の設定をグローバルに保存し、プロジェクトBに影響する
⭕ プロジェクト固有の設定は .claude/settings.json(リポジトリルート)に分離する

失敗2: Extended Thinkingオンでシンプルタスクを処理する

❌ ドキュメント生成など単純な作業でもExtended Thinkingが走り遅い
⭕ タスクの複雑さに応じて /fast(Concise + 思考オフ)を使い分ける

失敗3: Auto-Compactを完全オフにして文脈が失われる

❌ Auto-Compactを切ったまま長時間作業し、コンテキスト上限でセッションが強制終了
⭕ オフより「閾値を80%に下げる」のが現実的な妥協点

失敗4: /config変更が反映されないと思って再設定する

❌ 環境変数の変更後に新しいターミナルを開かずClaude Codeを使い続ける
⭕ 環境変数は新しいシェルセッションで反映される。source ~/.zshrc後に確認する

まとめ:今日から始める3つのアクション

  1. 今日やること: /configを開いて出力スタイルを「Concise」に変えてみる — コード補完が多いなら即効果が出る
  2. 今週中: CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=80.zshrcに追加し、長時間セッションの品質変化を確認する
  3. 今月中: プロジェクトルートに .claude/settings.json を作成してチームの標準設定を共有する

参考・出典


あわせて読みたい:
Claude Code Hooks完全解説 — PreToolUse/PostToolUseで安全性と自動化を両立する
Claude Codeカスタムスキルガイド — プロジェクト固有の振る舞いを定義する


著者: 佐藤傑(さとう・すぐる)
株式会社Uravation代表取締役。早稲田大学法学部在学中に生成AIの可能性に魅了され、X(旧Twitter)で活用法を発信(@SuguruKun_ai、フォロワー10万人超)。100社以上の企業向けAI研修・導入支援を展開。著書累計3万部突破。
ご質問・ご相談はお問い合わせフォームからお気軽にどうぞ。

Need help moving from reading to rollout?

この記事を読んで導入イメージが固まってきた方へ

Uravationでは、AIエージェントの要件整理、PoC設計、社内導入、研修まで一気通貫で支援しています。

この記事をシェア

X Facebook LINE

※ 本記事の情報は2026年4月時点のものです。サービスの料金・仕様は変更される可能性があります。最新情報は各サービスの公式サイトをご確認ください。

関連記事