設定の置き場所と優先順位、日常の効きが大きいキーから解説します。
Claude Code の設定は settings.json に書きます。置き場所は 3 つ: ~/.claude/settings.json (自分の全プロジェクト共通)、.claude/settings.json (プロジェクト共有・git にコミット)、.claude/settings.local.json (自分 × このプロジェクトだけ・git 対象外)。
同じキーが複数の場所にある時は、local → project → user の順で上が勝ちます (キー単位)。permissions のルールだけは上書きでなく合算されます。
編集は /config の設定画面からでも、ファイル直接でも OK。設定の変更は基本的に再起動で反映されます。
まずこの 8 個
日常の効きが大きい順。ここだけ押さえれば十分始められる。
ツール実行の許可/拒否/確認ルール。「毎回聞かれて面倒」はここで解決
使いどころ: allow に頻用コマンドを足すと承認ダイアログが減る (/fewer-permission-prompts が候補を提案してくれる)
全セッションとサブプロセスに効く環境変数
使いどころ: API 設定・プロキシ・自作スクリプトへの引き渡し
メインセッションのモデル (起動時に 1 回読まれる。途中変更は /model)
使いどころ: 既定モデルの固定
効果レベル (働く量) をセッションを跨いで固定する
使いどころ: 毎回 /effort を打たなくて済む
イベント (ツール実行前後・応答完了時 等) に自作スクリプトを仕掛ける
使いどころ: 自動整形・ガード・ログの配線。自動化の心臓部
コマンド実行の砂場 (通信先や書込先を制限)。credentials/allowList/denyList で細かく制御
使いどころ: 無人運転・夜間実行を安全にする
ステータスラインを自作スクリプトでカスタマイズ (JSON が stdin で渡る)
使いどころ: コンテキスト使用率など常時見たい情報を出す
文脈が上限に近づいたら自動で要約圧縮する (既定 true)
使いどころ: 長丁場の安定運転
モデル・応答
主モデルが使えない時の代替モデル (最大 3 つの配列)
使いどころ: 障害時も止めない
選択できるモデルを制限する
使いどころ: チーム運用でモデルを固定
/advisor (第二の意見) に使うモデル
使いどころ: アドバイザー運用
拡張思考を全セッションで既定 ON にする
使いどころ: 重い判断が多い人
ファストモード (出力速度優先・モデルは下がらない) を既定 ON
使いどころ: 対話のテンポ重視
表示・操作
ターミナル UI の描画方式
使いどころ: 環境で崩れる時や好みで
入力欄のキーバインド
使いどころ: vim 派はここ
! コマンドで使うシェル
使いどころ: Windows 環境
応答の口調・スタイルを指定 (システムプロンプトの一部になる)
使いどころ: 出力の型を固定したい時
スクリーンリーダー向けの装飾なし出力
使いどころ: 読み上げ環境
処理中のヒント表示 (既定 true)
使いどころ: 消したい人は false
メモリ・履歴
自動メモリ (セッションを跨ぐ記憶) の有効/無効 (既定 true)
使いどころ: 記憶させたくない案件で false
自動メモリの保存先を変更する
使いどころ: 記憶を別の場所で管理
読み込ませない CLAUDE.md を glob で指定
使いどころ: 巨大 monorepo で一部だけ読ませる
編集前のファイルを自動スナップショット (/rewind の復元元・既定 true)
使いどころ: 巻き戻し前提の安全運転
古いセッションファイルの自動削除期間 (既定 30 日)
使いどころ: 履歴を長く/短く持ちたい時
離席から戻った時の 1 行サマリー表示 (既定 true)
使いどころ: —
機能の有効/無効
全フックとカスタムステータスラインを無効化
使いどころ: フック起因の不具合切り分け
同梱スキルを無効化
使いどころ: 素の状態で使いたい時
別デバイスからの遠隔操作機能を無効化
使いどころ: セキュリティ要件
Remote Control 接続時のスマホ push 通知を許可
使いどころ: 外出中に完了通知が欲しい時
自動更新のチャンネル (既定 latest)
使いどころ: 安定重視なら stable
質問ダイアログを放置した時に自動続行するまでの時間 (既定 never)
使いどころ: 無人運転との併用
MCP (外部ツール連携)
プロジェクトの .mcp.json にある MCP サーバーを全部自動承認
使いどころ: 信頼できるリポジトリで
.mcp.json のうち承認するサーバーを個別指定
使いどころ: 選んで許可
.mcp.json のうち拒否するサーバーを個別指定
使いどころ: 特定だけ塞ぐ
よく使う環境変数
settings.json の env に書くか、シェルで export する。
そのセッションだけ効果レベルを指定する
使いどころ: 一時的な上げ下げ
拡張思考の上限。0 で無効化
使いどころ: 思考を切って速度優先
自動圧縮を止める
使いどころ: 圧縮タイミングを自分で握る
自動更新を止める
使いどころ: バージョン固定運用
自動メモリを無効化
使いどころ: 記憶なし運用
色出力の無効/強制 (サブプロセスに効く)
使いどころ: ログ収集・CI
テレメトリの制御
使いどころ: 組織ポリシー
OpenTelemetry でメトリクスを外部送信 (otlp 等)
使いどころ: 利用状況の計測基盤に繋ぐ