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` 内でも設定可能