4
2

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

@suikyo2023

【Claude Code】/config の全設定項目を表示順に整理してみた

4
Last updated at Posted at 2026-04-12

【Claude Code】/config の全設定項目を表示順に整理してみた

はじめに

Claude Codeには /config コマンドで対話的に設定を変更できるメニューがあります。

/config の画面

しかし、そこに並ぶ設定名（例: "Auto-compact", "Rewind code"）と、公式ドキュメントや settings.json で使われる設定キー（例: autoCompactEnabled, fileCheckpointingEnabled）の対応が一目ではわかりません。

公式ドキュメントには各設定の説明がありますが、複数ページに分散しており、/config の画面と突き合わせるには骨が折れます。Web上にも /config 表示名と設定キーの対応をまとめた記事が見当たりませんでした。

そこで、Claude Codeのバイナリに含まれる文字列を抽出して全設定キーを特定しました。本記事はその結果をまとめたものです。

調査手法: バイナリから文字列を抽出する

Claude Code v2.1 以降は、npm パッケージ（cli.js）ではなく、プリコンパイルされたバイナリとして配布されています。

# macOS / Linux の場合
~/.local/share/claude/versions/<バージョン番号>

# Windows の場合
%LOCALAPPDATA%\AnthropicClaude\claude-<バージョン番号>.exe

このバイナリはNode.jsロジックをELF形式にバンドルしたもので、strings コマンドで内部の文字列を抽出できます。設定メニューを構築している部分と DEFAULT_GLOBAL_CONFIG オブジェクト、そして設定の保存関数を特定し、表示名と設定キーの対応を抽出しました。

v2.1.101 以前は @anthropic-ai/claude-code npm パッケージの cli.js として配布されていました。

注意事項

  • 本記事は Claude Code v2.1.138 時点の情報です。アップデートで設定項目が増減する可能性があります
  • 一部の項目はモデルやログイン状態によって条件付き表示になります
  • 個人的な整理を目的に書いたものです。正確な仕様は公式ドキュメントを参照してください
  • 誤りや変更点を見つけた方は、コメントで教えていただけると助かります
  • 本記事の調査・執筆に Claude Code を使用しています

記事の読み方

  • 設定は /config の表示順 に並べています。実際の画面と見比べながら使えます
  • 各項目には /config での表示名、settings.json 等で使う設定キー、デフォルト値を記載しています
  • 「ローカル」と記載した設定は .claude/settings.local.json（プロジェクト個人設定）に保存されます

全設定一覧（/config 表示順）

# /config 表示名 設定キー デフォルト 備考
1 Auto-compact autoCompactEnabled true
2 Show tips spinnerTipsEnabled true ローカル設定
3 Reduce motion prefersReducedMotion false ローカル設定
4 Thinking mode thinkingEnabled true
5 Prompt suggestions promptSuggestionEnabled true ★新規
6 Session recap awaySummaryEnabled true ★新規
— Fast mode fastMode false Opus 4.6 使用時のみ表示
7 Rewind code (checkpoints) fileCheckpointingEnabled true
8 Verbose output verbose false
9 Terminal progress bar terminalProgressBarEnabled true
10 Show turn duration showTurnDuration true
11 Default permission mode defaultPermissionMode default
12 Worktree base ref worktreeBaseRef fresh ★新規
13 Use auto mode during plan useAutoModeDuringPlan true ★新規
14 Respect .gitignore in file picker respectGitignore true
15 Skip the /copy picker copyFullResponse false 旧表示名: Always copy full response
16 Auto-update channel autoUpdatesChannel latest
17 Theme theme dark
18 Local notifications preferredNotifChannel auto 旧表示名: Notifications
19 Push when actions required inputNeededNotifEnabled false ★新規
20 Push when Claude decides agentPushNotifEnabled false ★新規
21 Output style outputStyle default ローカル設定
22 Language language Default
23 Editor mode editorMode normal
24 Show last response in external editor externalEditorContext false ★新規
25 Show PR status footer prStatusFooterEnabled true
26 Model — Default
27 Auto-connect to IDE (external terminal) autoConnectIde false 旧表示名: Auto-install IDE extension
28 Claude in Chrome enabled by default claudeInChromeDefaultEnabled true
29 Teammate mode teammateMode auto
30 Default teammate model teammateDefaultModel —
31 Enable Remote Control for all sessions remoteControlAtStartup false

条件付き表示の設定（環境・モデル・ログイン状態によって /config に表示されない）:

設定キー 表示条件
fastMode Opus 4.6 モデル使用時のみ
voiceEnabled claude.ai アカウントでのログイン時のみ
syntaxHighlightingDisabled 条件によって非表示の場合あり
autoMemoryEnabled 条件によって非表示の場合あり
autoDreamEnabled 条件によって非表示の場合あり

各設定の詳細

1. Auto-compact

  • キー: autoCompactEnabled
  • デフォルト: true
  • コンテキストウィンドウが容量限界（約95%）に近づくと、古い会話を自動要約して圧縮する。長時間セッションの継続に必須。
  • 関連環境変数:
    • DISABLE_AUTO_COMPACT=1 — 自動コンパクション無効（手動 /compact は使用可能）
    • DISABLE_COMPACT=1 — 自動・手動の両方無効
    • CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=50 — 圧縮閾値をN%に変更（デフォルト約95%）

2. Show tips

  • キー: spinnerTipsEnabled
  • デフォルト: true
  • 保存先: ローカル設定（.claude/settings.local.json）
  • Claude処理中（spinner表示中）に操作ヒントを表示。spinnerTipsOverride でカスタムヒントも設定可能。

3. Reduce motion

  • キー: prefersReducedMotion
  • デフォルト: false
  • 保存先: ローカル設定
  • spinner、shimmer、点滅などのUIアニメーションを削減。アクセシビリティ向け。

4. Thinking mode

  • キー: thinkingEnabled
  • デフォルト: true
  • Extended Thinking（深い推論）を有効化。Claudeが複雑な問題を「考えてから」回答する。thinking tokenは通常の約3倍のコスト。
  • 関連設定: alwaysThinkingEnabled（Thinkingを常時固定で有効化）
  • 関連環境変数:
    • CLAUDE_CODE_DISABLE_THINKING=1 — 完全無効
    • CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1 — Adaptive thinking無効、固定予算に切り替え

5. Prompt suggestions ★新規

  • キー: promptSuggestionEnabled
  • デフォルト: true
  • 入力欄にプロンプト候補（サジェスト）を表示する機能。

6. Session recap ★新規

  • キー: awaySummaryEnabled
  • デフォルト: true
  • 5分以上離席してから会話に戻ると、Claudeが「離席中に何が起きていたか」を要約して表示する機能。無効にすると /config のコメントには "disable recaps in /config" と案内される。

Fast mode（条件付き表示）

  • キー: fastMode
  • デフォルト: false
  • 表示条件: Opus 4.6 モデル使用時のみ /config に表示
  • Opus 4.6を低遅延モードで実行。推論を削減し応答を高速化。精度は若干低下。/fast コマンドでも切り替え可能。

7. Rewind code (checkpoints)

  • キー: fileCheckpointingEnabled
  • デフォルト: true
  • 各プロンプト後にClaudeが編集したファイルのスナップショットを自動記録。Esc × 2 または /rewind で過去の時点に戻せる。
  • 注意: Bashコマンドによるファイル変更は追跡されない。
  • rewindメニュー:
    1. Restore code and conversation — ファイルと会話を復元
    2. Restore conversation — 会話のみ復元
    3. Restore code — ファイルのみ復元
    4. Summarize from here — 選択点から先を要約
  • 関連環境変数: CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING=1

8. Verbose output

  • キー: verbose
  • デフォルト: false
  • デバッグログの詳細度を上げる。tool use、context管理などの診断情報が出力される。環境変数 CLAUDE_CODE_DEBUG_LOG_LEVEL でもレベル制御可能（verbose / debug / info / warn / error）。

9. Terminal progress bar

  • キー: terminalProgressBarEnabled
  • デフォルト: true
  • 対応ターミナル（ConEmu, Ghostty 1.2.0+, iTerm2 3.6.6+）で処理中に進捗バーを表示。

10. Show turn duration

  • キー: showTurnDuration
  • デフォルト: true
  • 各レスポンス後に処理時間を表示（例: "Cooked for 1m 6s"）。

11. Default permission mode

  • キー: defaultPermissionMode
  • デフォルト: default
  • 起動時の権限設定。Shift+Tab でセッション中に変更可能。
  • 選択肢:
モード 動作
default 全tool useで確認ダイアログ
acceptEdits ファイル編集・簡単なBashは自動承認
plan read-onlyのみ（計画作成まで）
auto 背景チェック付き自動承認（研究版）
dontAsk すべて自動承認
bypassPermissions 権限チェック完全スキップ

12. Worktree base ref ★新規

  • キー: worktreeBaseRef
  • デフォルト: fresh
  • --worktree フラグでworktreeを作成する際の基準ブランチ・コミット。fresh（空コミット）の他、main などのブランチ名も指定可能。

13. Use auto mode during plan ★新規

  • キー: useAutoModeDuringPlan
  • デフォルト: true
  • Plan Mode（plan permission mode）から実行に移る際に、自動的に auto モードへ切り替えるかどうか。trueにすると、plan モード終了後に確認ダイアログなしで処理が進む。

14. Respect .gitignore in file picker

  • キー: respectGitignore
  • デフォルト: true
  • 前提: 入力プロンプトで @ を打つとプロジェクト内のファイルパス候補が表示される
  • この設定の効果: @ の候補一覧から .gitignore パターンに該当するファイルを除外する。falseにすると node_modules 内なども候補に出る

15. Skip the /copy picker

  • キー: copyFullResponse
  • デフォルト: false
  • 旧表示名: Always copy full response
  • 前提: /copy コマンドの動作:
    • /copy — 直前の応答をクリップボードにコピー
    • 応答にコードブロックが含まれる場合、**ピッカー（選択画面）**が表示され、特定のブロックだけコピーするか全文コピーするかを選べる
    • ピッカー内で w キーを押すと、クリップボードではなくファイルに書き出せる（SSH接続時に便利）
  • この設定の効果: trueにするとピッカーを表示せず、常に応答全文を即座にコピーする

16. Auto-update channel

  • キー: autoUpdatesChannel
  • デフォルト: latest
  • Claude Codeの自動更新チャネル。latest（最新）または stable（安定版）。

17. Theme

  • キー: theme
  • デフォルト: dark
  • UIの配色テーマ。Dark / Light。（バイナリ内の DEFAULT_GLOBAL_CONFIG で "dark" が確認済み）

18. Local notifications

  • キー: preferredNotifChannel
  • デフォルト: auto
  • 旧表示名: Notifications
  • ターミナル内での処理完了通知方法。autoではターミナルの能力に応じて自動選択。プッシュ通知は #19・#20 で別管理。

19. Push when actions required ★新規

  • キー: inputNeededNotifEnabled
  • デフォルト: false
  • Claudeが権限確認などユーザーの入力を待っている状態になったとき、プッシュ通知を送る。

20. Push when Claude decides ★新規

  • キー: agentPushNotifEnabled
  • デフォルト: false
  • Claudeがタスクを完了・決定したとき、プッシュ通知を送る。

21. Output style

  • キー: outputStyle
  • デフォルト: default
  • 保存先: ローカル設定（.claude/settings.local.json）
  • Claudeの応答スタイルを切り替える。プロジェクトごとに設定できる。
スタイル 効果
Default 標準のソフトウェアエンジニアリング向け応答
Explanatory 実装の意図やコードベースのパターンを解説する "Insights" セクションを追加
Learning 学習モード。小さなコード片を自分で書くよう促す（TODO(human) マーカー付き）
カスタム ~/.claude/output-styles/ または .claude/output-styles/ にMarkdownファイルを置いて独自スタイルを定義

22. Language

  • キー: language
  • デフォルト: Default（英語）
  • Claudeの応答言語。"japanese", "spanish", "french" などを指定可能。
  • 音声入力との連動: 設定した言語が音声認識の認識言語にも反映される。日本語で音声入力したい場合は必須。

23. Editor mode

  • キー: editorMode
  • デフォルト: normal
  • 入力プロンプトのキーバインド。normal または vim。

24. Show last response in external editor ★新規

  • キー: externalEditorContext
  • デフォルト: false
  • 外部エディタ（VS CodeやJetBrainsのサイドパネル等）でClaudeの最後の応答を表示する。IDE連携時に使う。

25. Show PR status footer

  • キー: prStatusFooterEnabled
  • デフォルト: true
  • 前提: 現在のブランチにオープンなPull Requestがある場合、画面下部にPRリンクとレビュー状態が色付きで表示される（60秒ごとに自動更新）
    • 🟢 緑: approved / 🟡 黄: pending review / 🔴 赤: changes requested / ⚫ 灰: draft / 🟣 紫: merged
    • Ctrl+Click でブラウザからPRを開ける
    • 要件: gh CLIがインストール・認証済みであること
  • この設定の効果: このフッター表示のオン・オフを切り替える

26. Model

  • デフォルトで使用するClaudeモデルの選択。/model コマンドでも切り替え可能。CLI起動時に --model フラグでも指定できる。

27. Auto-connect to IDE (external terminal)

  • キー: autoConnectIde
  • デフォルト: false
  • 旧表示名: Auto-install IDE extension（旧キー: autoInstallIdeExtension）
  • 外部ターミナルからClaude Codeを起動したとき、VS Code / JetBrains のIDEへ自動接続する。

28. Claude in Chrome enabled by default

  • キー: claudeInChromeDefaultEnabled
  • デフォルト: true
  • 前提: Claude in Chrome: Chrome/Edge拡張機能で、Claude Codeからブラウザを直接操作できる機能。Webアプリのテスト、コンソールログの読み取り、フォーム操作、認証済みアプリ（Gmail, Notion等）へのアクセスなどが可能。/chrome コマンドまたは claude --chrome で起動
  • この設定の効果: trueにすると、セッション開始時にChrome連携をデフォルトで有効化する

29. Teammate mode

  • キー: teammateMode
  • デフォルト: auto
  • 前提: Agent Teams: 複数のClaude Codeインスタンス（teammate）が独立したタスクを並行処理する機能
  • この設定の効果: teammateの表示方法を切り替える
モード 動作 適した環境
auto 環境に応じて自動選択 —
in-process 全teammateをメインターミナル内で実行。Shift+Down で切り替え どのターミナルでも動作
tmux 各teammateを別ペインに表示。全員の出力を同時に見られる tmux / iTerm2 が必要

30. Default teammate model

  • キー: teammateDefaultModel
  • 上記Agent Teamsで起動されるteammateが使用するデフォルトモデル。未設定の場合はメインセッションと同じモデルを使用。

31. Enable Remote Control for all sessions

  • キー: remoteControlAtStartup
  • デフォルト: false
  • 前提: Remote Control: ローカルで動作中のClaude Codeセッションに、スマホ・タブレット・別PCのブラウザからアクセスする機能。claude --remote-control で起動するとセッションURLとQRコードが表示される。セッション自体はローカルマシン上で動作するため、ファイル・MCP・プロジェクト設定はそのまま利用可能
  • この設定の効果: 全セッションでRemote Controlを自動的に有効にするかどうか

推奨設定

/config の設定はすべてデフォルトのままでも動作するが、用途に応じて変更すると使いやすくなる。

日本語ユーザー向け

language: "japanese" を必ず設定する

Claudeが日本語で応答するだけでなく、音声入力の言語認識も日本語になる。

{
  "language": "japanese"
}

音声入力を使うなら /voice hold で有効化

language: "japanese" との組み合わせで、スペースキー長押しによる日本語音声入力が使える（claude.ai ログイン必要）。

初学者向け

outputStyle: "Explanatory" が学習効率を上げる

標準（default）はシンプルな回答が返ってくるが、Explanatory に変えると実装の意図・コードベースのパターン・設計上の選択を解説する "★ Insights" セクションが自動的に追加される。「なぜその実装か」が見えるため、コードを読むだけでなく理解を深めやすい。

{
  "outputStyle": "Explanatory"
}

outputStyle はローカル設定（.claude/settings.local.json）に保存されるため、プロジェクトごとに切り替えられる。

個人リポジトリ・Vault執筆者向け

defaultPermissionMode: "acceptEdits" で作業効率を上げる

個人用プロジェクトや信頼できる環境では、ファイル編集と簡単なBashコマンドを自動承認する acceptEdits が実用的。確認ダイアログが減り、作業がスムーズになる。

ただし:

  • dontAsk（全自動承認）や bypassPermissions（権限チェック完全スキップ）は非推奨。意図しないファイル削除・コマンド実行のリスクがある
  • 不特定のリポジトリを扱う場合はデフォルト（default）のまま使う方が安全

autoUpdatesChannel: "stable" で安定した環境を維持する

記事執筆中や安定したワークフローでは stable チャネルが望ましい。デフォルトの latest は最新機能が使えるが破壊的変更が入ることもある。

prStatusFooterEnabled: false — gh CLI を使わない環境では不要

gh CLI が未インストールまたは未認証の環境（個人Vault等）では明示的に false にするとすっきりする。

変えない方が良い設定（デフォルト推奨）

設定 デフォルト 理由
autoCompactEnabled true 長時間セッションに必須。無効化すると途中でコンテキストが詰まる
thinkingEnabled true 推論の質に直結。無効化するとコスト削減になるが品質が落ちる
fastMode false Opus 4.6 以外では効果なし。精度優先なら無効のまま
fileCheckpointingEnabled true 失敗時の巻き戻しに必須。無効化は非推奨
awaySummaryEnabled true 離席後に状況把握しやすい。特別な理由がなければオンのまま

設定ファイルの優先順位

/config で変更した設定がどこに保存されるかは、設定の種類によって異なります。Claude Codeの設定ファイルは4層構造で、後のものが優先されます:

優先度 ファイル 適用範囲 共有
1 (低) Managed policy 全マシンユーザー IT管理者が配布
2 ~/.claude/settings.json 全プロジェクト共通 個人
3 .claude/settings.json リポジトリ共有 git commit対象
4 (高) .claude/settings.local.json このリポジトリの自分だけ gitignore対象
  • /config で変更した設定の多くは ~/.claude.json（preferences）に保存される
  • spinnerTipsEnabled・prefersReducedMotion・outputStyle はローカル設定（.claude/settings.local.json）に保存される
  • permissions 関連は ~/.claude/settings.json または .claude/settings.json に保存される
  • 環境変数は全ファイルより優先される

環境変数での制御

一部の設定は環境変数でも制御可能です:

環境変数 対応設定
DISABLE_AUTO_COMPACT=1 Auto-compact無効
DISABLE_COMPACT=1 Auto-compact + 手動compact無効
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=N 圧縮閾値をN%に変更
CLAUDE_CODE_DISABLE_THINKING=1 Thinking完全無効
CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING=1 Rewind code無効
CLAUDE_CODE_DEBUG_LOG_LEVEL=verbose ログレベル変更
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL=1 IDE拡張自動インストール無効
CLAUDE_CODE_SYNTAX_HIGHLIGHT=0 シンタックスハイライト無効
CLAUDE_EFFORT=high セッションのeffortレベル設定（low/medium/high/xhigh/max）

参考文献

  • Claude Code Settings — 公式ドキュメントの設定ページ。設定キーと説明の一次情報
  • Claude Code Environment Variables — 環境変数リファレンス
  • Claude Code Directory — ~/.claude.json 等のファイル構成の説明
  • Voice Dictation — 音声入力機能の詳細
  • ソースコード: Claude Code バイナリ（v2.1.138）の文字列抽出 — 設定の保存関数・DEFAULT_GLOBAL_CONFIG・メニュー構築部分から設定キーを特定

更新履歴

日付 内容
2026-04-12 初版作成（Claude Code v2.1.101）
2026-05-10 v2.1.138 に更新。/config 実画面との突き合わせで全面改訂。項目数 25→31 に増加。新規項目追加（Prompt suggestions, Session recap, Worktree base ref, Use auto mode during plan, Push×2, Show last response in external editor）。表示名変更 3 件（Skip the /copy picker, Local notifications, Auto-connect to IDE）。条件付き表示・保存先（ローカル設定）の明記。推奨設定セクション追加。調査手法を更新（cli.js → ELFバイナリ）
4
2
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
4
2

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?