設定概要

設定の優先順位

設定は以下の順序で適用されます（上位数が優先）。

1. エンタープライズ管理ポリシー - managed-settings.json
2. コマンドライン引数 - 起動時のフラグ
3. ローカルプロジェクト設定 - .claude/settings.local.json
4. 共有プロジェクト設定 - .claude/settings.json
5. ユーザー設定 - ~/.claude/settings.json

グローバル設定

claude config set --global または ~/.claude/settings.json で設定します。

設定キー	値	説明
preferredNotifChannel	iterm2 / terminal_bell / notifications_disabled	通知先
theme	dark / light / light-daltonized / dark-daltonized	カラーテーマ
verbose	true / false	Bash出力の全量表示

メイン設定

認証・セキュリティ

設定キー	説明	例
apiKeyHelper	認証値生成スクリプト	/bin/generate_temp_api_key.sh
forceLoginMethod	ログイン方法の制限	claudeai / console
includeCoAuthoredBy	Co-authored-byを含める	false

セッション・環境

設定キー	説明	例
env	セッションに適用する環境変数	{"FOO": "bar"}
cleanupPeriodDays	トランスクリプト保持日数	20
model	デフォルトモデルの上書き	claude-3-5-sonnet-20241022
outputStyle	出力スタイル	Explanatory

チーム・表示

設定キー	説明	例
teammateMode	チームメイトの表示モード	in-process / tmux / auto
enableAllProjectMcpServers	全プロジェクトMCPサーバーを許可	true
claudeMdExcludes	CLAUDE.mdの除外パターン	["**/monorepo/CLAUDE.md"]

ステータスライン

カスタムスクリプトでターミナルステータスラインにセッション情報を表示します。

{
  "statusLine": {
    "script": "/path/to/statusline.sh"
  }
}

スクリプトには以下のJSONが入力されます。

{
  "model": { "display_name": "Opus 4.6" },
  "workspace": { "current_dir": "/home/user/project" }
}

パーミッション設定

permissions ブロックでツールの実行権限を制御します。

{
  "permissions": {
    "allow": ["Bash(git diff:*)"],
    "ask": ["Bash(git push:*)"],
    "deny": ["WebFetch", "Read(./.env)"],
    "additionalDirectories": ["../docs/"],
    "defaultMode": "acceptEdits"
  }
}

ルールタイプ	説明
allow	確認なしで許可
ask	毎回確認
deny	常に拒否

高度な設定

必要に応じて使用する設定キーです。

動作制御

設定キー	説明	例
forceRemoteSettingsRefresh	リモート設定を強制的に再取得する	true
disableSkillShellExecution	スキル内のシェルコマンド実行を無効化	true
showThinkingSummaries	拡張思考モードのサマリーを表示	true

MCPサーバー制御

設定キー	説明	例
allowedMcpServers	許可するMCPサーバー名のリスト	["context7", "playwright"]
deniedMcpServers	拒否するMCPサーバー名のリスト	["untrusted-server"]

管理者配布設定（managed-settings.d/）

~/.claude/managed-settings.d/ ディレクトリに .json ファイルを配置すると、複数の設定ファイルを分割管理できます。エンタープライズ環境でポリシーを配布する際に使用します。個々のファイルは通常の settings.json と同じ構造で記述し、ファイル名のアルファベット順にマージされます。

~/.claude/managed-settings.d/
  01-security.json
  02-permissions.json
  03-mcp-servers.json

フック設定

hooks ブロックでツール実行前後のカスタムコマンドを設定します。詳細はHooks設定を参照してください。

設定コマンド一覧

claude config list              # 一覧表示
claude config get <key>         # 値の取得
claude config set <key> <value> # 値の設定
claude config add <key> <value> # 値の追加
claude config remove <key> <value> # 値の削除