| name | cc-settings |
| description | Claude Code settings catalog — discover what you can customize. Fetches latest settings and env vars from 3 sources (JSON Schema + official docs + official env-vars docs) to show all available options. Use when user says '設定', 'settings', '設定一覧', '設定カタログ', 'what can I configure', '何が設定できる', 'Claude Code設定', '設定項目', '環境変数', 'env vars', or wants to discover available Claude Code configuration options. |
| version | 3.0.0 |
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 |
環境変数カテゴリ（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: フォローアップ
カタログ表示後、ユーザーが特定の設定に興味を示したら：
- その設定の詳細（型、取りうる値、設定例）を説明
- 現在値との差分を表示
- 必要ならその場で設定を変更する提案（ただし押し付けない）
引数
| 引数 | 説明 |
|---|
| (なし) | カテゴリ一覧を表示 |
<カテゴリ番号> | 指定カテゴリの詳細（例: 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 内でも設定可能
