cc-settings

Claude Code Settings — 設定カタログ

Claude Code で 何がカスタマイズできるのか を能動的に発見するためのスキル。 3つのデータソースから最新情報を取得し、settings.json プロパティ + 環境変数の両方をカテゴリ別に一覧表示する。

設計思想

このスキルの目的は「設定の代行」ではなく「設定の発見」。 ユーザーは「何ができるか」を知りたい。設定作業自体は自分でやれる。

データソース（3点セット）

単一ソースでは漏れがあるため、3つを並列取得して統合する。

#	ソース	URL	カバー範囲
1	JSON Schema	https://json.schemastore.org/claude-code-settings.json	settings.json の構造化プロパティ
2	公式設定ドキュメント	https://code.claude.com/docs/en/settings	settings.json + ファイルスコープ + 未ドキュメント設定
3	公式環境変数ドキュメント	https://code.claude.com/docs/en/env-vars	env 内で使える全環境変数

なぜ3つ必要か: Schema はコミュニティ管理で遅れがち。公式ドキュメントには Schema にない設定（modelOverrides, worktree.*, allowedHttpHookUrls 等）が含まれる。環境変数は settings.json とは別体系で 90+ 個ある。

定数

SCHEMA_URL=https://json.schemastore.org/claude-code-settings.json
SETTINGS_DOC_URL=https://code.claude.com/docs/en/settings
ENV_VARS_DOC_URL=https://code.claude.com/docs/en/env-vars
GLOBAL_SETTINGS=~/.claude/settings.json
PROJECT_SETTINGS={cwd}/.claude/settings.json

設定ファイルのスコープ（ユーザーに説明する際の参考）

優先度	ファイル	パス	影響範囲	チーム共有
1 (最高)	managed-settings.json	~/.config/claude/managed-settings.json	マシン上の全ユーザー	IT 配布
2	settings.json	~/.claude/settings.json	全プロジェクトの自分	いいえ
3	settings.json	{project}/.claude/settings.json	リポジトリの全コラボレーター	はい (git)
4 (最低)	settings.local.json	{project}/.claude/settings.local.json	特定リポジトリの自分のみ	いいえ (.gitignore)

その他のファイル:

• ~/.claude.json — MCP サーバー設定（user/local）
• .mcp.json — プロジェクトスコープの MCP サーバー
• CLAUDE.md / .claude/CLAUDE.md / ~/.claude/CLAUDE.md — 指示・コンテキスト
• ~/.claude/agents/ / .claude/agents/ — サブエージェント定義

ワークフロー

Phase 1: データ取得（並列）

3つのソースを Agent サブエージェント3並列 で取得する。

Agent 1: Schema 取得

WebFetch: SCHEMA_URL
prompt: 「全プロパティの名前、型、description、デフォルト値を漏れなくリストしてください」

• リダイレクト発生時はリダイレクト先を再フェッチ

Agent 2: 公式設定ドキュメント取得

WebFetch: SETTINGS_DOC_URL
prompt: 「settings.json の全設定キーを抽出してください。キー名、説明、デフォルト値、設定例、対象スコープを含めてください」

Agent 3: 公式環境変数ドキュメント取得

WebFetch: ENV_VARS_DOC_URL
prompt: 「全環境変数を抽出してください。変数名、説明、デフォルト値を含めてください」

並行して: 現在の設定を Read

• グローバル: ~/.claude/settings.json
• プロジェクト（存在すれば）: {cwd}/.claude/settings.json

Phase 2: 統合・カテゴリ分類

3つのソースの結果を統合し、以下のカテゴリに分類する。

settings.json カテゴリ（17カテゴリ）

#	カテゴリ	対象プロパティ	一言説明
1	モデル・推論	model, modelOverrides, effortLevel, fastMode, fastModePerSessionOptIn, alwaysThinkingEnabled, availableModels	使用モデルと思考設定
2	権限・セキュリティ	permissions (allow/deny/ask/defaultMode/disableBypassPermissionsMode/additionalDirectories)	ツールの許可/拒否
3	サンドボックス	sandbox (enabled, network, filesystem, ignoreViolations, excludedCommands, auto*, enableWeaker*)	Bash 実行の隔離設定
4	Hooks	hooks (19イベント), disableAllHooks, allowedHttpHookUrls, httpHookAllowedEnvVars	イベント駆動の自動処理
5	MCP サーバー	enableAllProjectMcpServers, enabledMcpjsonServers, disabledMcpjsonServers, allowedMcpServers, deniedMcpServers	外部ツール連携
6	プラグイン	enabledPlugins, extraKnownMarketplaces, skippedMarketplaces, skippedPlugins, pluginConfigs	拡張機能
7	Git・属性	includeGitInstructions, includeCoAuthoredBy, attribution (commit/pr)	Git 連携と著者表示
8	UI・表示	statusLine, outputStyle, spinnerVerbs, spinnerTipsEnabled, spinnerTipsOverride, terminalProgressBarEnabled, showTurnDuration, prefersReducedMotion, fileSuggestion	見た目のカスタマイズ
9	言語	language	応答言語
10	認証	apiKeyHelper, awsCredentialExport, awsAuthRefresh, forceLoginMethod, forceLoginOrgUUID	API キー・ログイン
11	ストレージ	cleanupPeriodDays, plansDirectory, respectGitignore, autoMemoryEnabled, autoMemoryDirectory	データ保持と保存先
12	更新	autoUpdatesChannel	自動アップデート
13	エージェントチーム	teammateMode, agent	マルチエージェント
14	Worktree	worktree.symlinkDirectories, worktree.sparsePaths	ワークツリー設定
15	管理者向け	allowManagedHooksOnly, allowManagedPermissionRulesOnly, allowManagedMcpServersOnly, blockedMarketplaces, strictKnownMarketplaces, companyAnnouncements, pluginTrustMessage, disallowedTools	組織管理用
16	フィードバック	feedbackSurveyRate, skipDangerousModePermissionPrompt	調査・プロンプト制御
17	その他	skipWebFetchPreflight, otelHeadersHelper, env	テレメトリ等

環境変数カテゴリ（12カテゴリ）

#	カテゴリ	一言説明
E1	モデル・API	ANTHROPIC_MODEL, ANTHROPIC_API_KEY 等
E2	AWS Bedrock	CLAUDE_CODE_USE_BEDROCK 等
E3	Google Vertex AI	CLAUDE_CODE_USE_VERTEX 等
E4	Microsoft Foundry	CLAUDE_CODE_USE_FOUNDRY 等
E5	Bash・シェル	BASH_DEFAULT_TIMEOUT_MS, CLAUDE_CODE_SHELL 等
E6	コンテキスト・思考	CLAUDE_CODE_DISABLE_1M_CONTEXT, MAX_THINKING_TOKENS 等
E7	機能の有効化/無効化	CLAUDE_CODE_DISABLE_* 系, CLAUDE_CODE_ENABLE_* 系
E8	テレメトリ・レポート	DISABLE_TELEMETRY, DISABLE_ERROR_REPORTING 等
E9	MCP	MAX_MCP_OUTPUT_TOKENS, MCP_TIMEOUT 等
E10	プロキシ・mTLS	HTTP_PROXY, CLAUDE_CODE_CLIENT_CERT 等
E11	SDK・エージェント	CLAUDE_CODE_ACCOUNT_UUID, CLAUDE_CODE_TEAM_NAME 等
E12	その他	CLAUDE_CONFIG_DIR, USE_BUILTIN_RIPGREP 等

注意: 3つのソースの結果に含まれるが上記カテゴリに該当しないプロパティは「新着」として別枠で表示する。

Phase 3: カタログ表示

表示フォーマット（引数なしの場合 = カテゴリ一覧）

## Claude Code 設定カタログ

3つのソースから取得しました。

### settings.json（{N} 件）

| # | カテゴリ | 項目数 | 設定済 | 説明 |
|---|---------|-------|-------|------|
| 1 | モデル・推論 | 7 | 3 | 使用モデルと思考設定 |
| 2 | 権限・セキュリティ | 6 | 1 | ツールの許可/拒否 |
| ...

### 環境変数（{M} 件）

| # | カテゴリ | 項目数 | 設定済 | 説明 |
|---|---------|-------|-------|------|
| E1 | モデル・API | 14 | 0 | モデル指定・APIキー |
| E2 | AWS Bedrock | 4 | 0 | Bedrock 連携 |
| ...

詳細を見たいカテゴリの番号を教えてください（例: 4, E5）。
`--all` で全項目、`--env` で環境変数のみ表示。

表示フォーマット（カテゴリ指定の場合）

## カテゴリ: {カテゴリ名}

| 設定項目 | 型 | デフォルト | 現在値 | 説明 |
|---------|-----|----------|-------|------|
| model | string | - | opus[1m] | 使用モデルの指定 |
| ...

💡 設定方法: ~/.claude/settings.json に追記

環境変数カテゴリの場合:

## カテゴリ: {カテゴリ名}

| 環境変数 | デフォルト | 現在値 | 説明 |
|---------|----------|-------|------|
| BASH_DEFAULT_TIMEOUT_MS | - | 3600000 | Bash タイムアウト |
| ...

💡 設定方法: settings.json の "env" 内に追記、またはシェル環境変数として設定

現在値の表示ルール:

• settings.json に値があれば → その値を表示
• env 内に値があれば → その値を表示
• 未設定 → 「-」と表示

表示フォーマット（--all の場合）

全カテゴリを順番に表示。管理者向け（カテゴリ15）はデフォルト省略、末尾に「--admin で表示」と注記。

Phase 4: フォローアップ

カタログ表示後、ユーザーが特定の設定に興味を示したら：

1. その設定の詳細（型、取りうる値、設定例）を説明
2. 現在値との差分を表示
3. 必要ならその場で設定を変更する提案（ただし押し付けない）

引数

引数	説明
(なし)	カテゴリ一覧を表示
<カテゴリ番号>	指定カテゴリの詳細（例: 4, E5）
<キーワード>	キーワードで設定項目を検索
--all	全項目を一覧表示
--env	環境変数のみ表示
--diff	設定済み vs 未設定の差分を表示
--admin	管理者向け設定も表示

Hooks 一覧（カテゴリ4 の補足）

イベント	タイミング	ユースケース例
PreToolUse	ツール呼び出し前	危険なコマンドをブロック
PostToolUse	ツール完了後	ログ記録、通知
PostToolUseFailure	ツール失敗後	エラー通知
PermissionRequest	権限確認表示時	自動承認/拒否
Notification	通知時	Slack/Discord 連携
UserPromptSubmit	プロンプト送信時	入力バリデーション
Stop	応答完了時	フィードバック収集
SubagentStart	サブエージェント生成時	監視
SubagentStop	サブエージェント完了時	結果集約
PreCompact	コンテキスト圧縮前	重要情報の保存
TeammateIdle	チームメンバー待機時	リソース管理
TaskCompleted	タスク完了時	進捗通知
Setup	リポジトリ初期化時	環境セットアップ
InstructionsLoaded	CLAUDE.md ロード時	設定検証
ConfigChange	設定変更時	設定同期
WorktreeCreate	ワークツリー生成時	環境準備
WorktreeRemove	ワークツリー削除時	クリーンアップ
SessionStart	セッション開始時	初期化処理
SessionEnd	セッション終了時	終了処理

Hook の型:

• command: シェルコマンド実行（command, timeout, async, statusMessage）
• prompt: LLM にプロンプトで判断させる（prompt, model, timeout）
• agent: エージェントに検証させる（prompt, model, timeout）
• http: HTTP POST リクエスト（url, headers, allowedEnvVars, timeout）

権限ルールの書式（カテゴリ2 の補足）

ToolName                     → ツール全体を許可/拒否
ToolName(pattern)            → パターンマッチ
ToolName(/path/pattern)      → パスパターン
mcp__server                  → MCP サーバー全体
mcp__server__tool            → MCP サーバーの特定ツール
WebFetch(domain:example.com) → ドメイン指定
Agent(Explore)               → 特定エージェント型

利用可能なツール名: Agent, Bash, Edit, ExitPlanMode, Glob, Grep, KillShell, LS, LSP, MultiEdit, NotebookEdit, NotebookRead, Read, Skill, Task, TaskCreate, TaskGet, TaskList, TaskOutput, TaskStop, TaskUpdate, TodoWrite, ToolSearch, WebFetch, WebSearch, Write, mcp__*

エラーハンドリング

エラー	対応
Schema フェッチ失敗	公式ドキュメントのみで表示
公式ドキュメントフェッチ失敗	Schema のみで表示（環境変数は非表示）
全ソース失敗	スキル内のカテゴリ定義をフォールバックとして使用
settings.json が存在しない	「現在値」欄を全て「-」で表示
ソース間で矛盾する情報	公式ドキュメント > Schema の優先度で採用
未知のプロパティ発見	「新着」カテゴリに自動分類

注意事項

• Schema は SchemaStore コミュニティ管理。公式リリースから遅れる場合がある
• 公式ドキュメントの URL はリダイレクトされることがある（docs.anthropic.com → code.claude.com）
• 管理者向け設定（managed settings）は組織の IT 管理者が使うもの。個人ユーザーは基本的に触らない
• settings.json と settings.local.json は別物。local は .gitignore 向け
• プロジェクト settings.json はグローバルを上書き（マージではなくオーバーライド）
• 環境変数はシェル環境でも settings.json の env 内でも設定可能