Claude Code の設定

​

構成スコープ

​

利用可能なスコープ

​

各スコープを使用する場合

• 組織全体で強制する必要があるセキュリティポリシー
• オーバーライドできないコンプライアンス要件
• IT/DevOps により展開される標準化された構成

• すべての場所で必要な個人設定（テーマ、エディター設定）
• すべてのプロジェクト全体で使用するツールとプラグイン
• API キーと認証（安全に保存）

• チーム共有設定（権限、hooks、MCP サーバー）
• チーム全体が持つべきプラグイン
• コラボレーター全体でのツール標準化

• 特定のプロジェクトの個人的なオーバーライド
• チームと共有する前に構成をテストする
• 他のユーザーには機能しないマシン固有の設定

​

スコープの相互作用

1. Managed（最高） - 何によってもオーバーライドできない
2. コマンドライン引数 - 一時的なセッションオーバーライド
3. Local - プロジェクトとユーザー設定をオーバーライド
4. Project - ユーザー設定をオーバーライド
5. User（最低） - 他に何も設定を指定しない場合に適用

​

スコープを使用する機能

​

設定ファイル

• ユーザー設定は ~/.claude/settings.json で定義され、すべてのプロジェクトに適用されます。
• プロジェクト設定はプロジェクトディレクトリに保存されます：
  • .claude/settings.json ソース管理にチェックインされ、チームと共有される設定用
  • .claude/settings.local.json チェックインされない設定用。個人設定と実験に役立ちます。Claude Code は作成時に .claude/settings.local.json を無視するように git を構成します。自分でファイルを作成する場合は、gitignore に手動で追加してください。 このファイルはリポジトリのものではなく、あなたのものであるため、その権限 allow ルールは、.claude/settings.json allow ルールが必要とするワークスペース信頼ステップなしで有効になります。リポジトリがファイルを提供する場合（たとえば、コミットすることで）、ワークスペース信頼は引き続き適用されます。
• Managed 設定：集中管理が必要な組織向けに、Claude Code は managed 設定の複数の配信メカニズムをサポートしています。すべて同じ JSON 形式を使用し、ユーザー設定またはプロジェクト設定でオーバーライドできません：
  • サーバー管理設定：Anthropic のサーバーから Claude.ai 管理コンソール経由で配信されるか、自己ホスト型の Claude apps gatewayから配信されます。サーバー管理設定を参照してください。
  • MDM/OS レベルのポリシー：macOS と Windows のネイティブデバイス管理を通じて配信されます：
    • macOS：com.anthropic.claudecode managed preferences ドメイン。plist のトップレベルキーは managed-settings.json をミラーリングし、ネストされた設定は辞書として、配列は plist 配列として機能します。Jamf、Iru（Kandji）、または同様の MDM ツールの構成プロファイルを通じて展開します。
    • Windows：HKLM\SOFTWARE\Policies\ClaudeCode レジストリキーと JSON を含む Settings 値（REG_SZ または REG_EXPAND_SZ）。グループポリシーまたは Intune を通じて展開します
    • Windows（ユーザーレベル）：HKCU\SOFTWARE\Policies\ClaudeCode（最低ポリシー優先度、管理者レベルのソースが存在しない場合のみ使用）
  • ファイルベース：managed-settings.json と managed-mcp.json をシステムディレクトリに展開：
    • macOS：/Library/Application Support/ClaudeCode/
    • Linux と WSL：/etc/claude-code/
    • Windows：C:\Program Files\ClaudeCode\
    レガシー Windows パス C:\ProgramData\ClaudeCode\managed-settings.json は v2.1.75 以降サポートされなくなりました。そのロケーションに設定を展開した管理者は、ファイルを C:\Program Files\ClaudeCode\managed-settings.json に移行する必要があります。
    ファイルベースの managed 設定は、managed-settings.json と同じシステムディレクトリ内の managed-settings.d/ ドロップインディレクトリもサポートしています。これにより、別々のチームが単一ファイルの編集を調整することなく、独立したポリシーフラグメントを展開できます。 systemd 規則に従い、managed-settings.json が最初にベースとしてマージされ、その後、ドロップインディレクトリ内のすべての *.json ファイルがアルファベット順にソートされてマージされます。スカラー値の場合、後のファイルが前のファイルをオーバーライドします。配列は連結され、重複排除されます。オブジェクトはディープマージされます。. で始まる隠しファイルは無視されます。 マージ順序を制御するには、数値プレフィックスを使用します。たとえば、10-telemetry.json と 20-security.json です。
  managed 設定と Managed MCP 構成の詳細を参照してください。 このリポジトリには、Jamf、Iru（Kandji）、Intune、およびグループポリシー用のスターターデプロイメントテンプレートが含まれています。これらを出発点として使用し、ニーズに合わせて調整してください。
  Managed デプロイメントは、strictKnownMarketplaces を使用してプラグインマーケットプレイスの追加を制限することもできます。詳細については、Managed マーケットプレイス制限を参照してください。
• その他の構成は ~/.claude.json に保存されます。このファイルには、OAuth セッション、MCP サーバーユーザーおよびローカルスコープの構成、プロジェクトごとの状態（許可されたツール、信頼設定）、およびさまざまなキャッシュが含まれます。プロジェクトスコープの MCP サーバーは .mcp.json に別途保存されます。

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test *)",
      "Read(~/.zshrc)"
    ],
    "deny": [
      "Bash(curl *)",
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)"
    ]
  },
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp"
  },
  "companyAnnouncements": [
    "Welcome to Acme Corp! Review our code guidelines at docs.acme.com",
    "Reminder: Code reviews required for all PRs",
    "New security policy in effect"
  ]
}

​

編集がいつ有効になるか

• model：セッション中に切り替えるには /modelを使用します
• outputStyle：システムプロンプトの一部。/clear または再起動時に再構築されます

​

Managed 設定の無効なエントリ

• インタラクティブセッションは起動時に無効なエントリをリストするダイアログを表示します。
• -p を使用したヘッドレス実行は stderr にサマリーを出力します。
• claude doctorは各無効なエントリをそのソースとフィールドとともにリストします。

​

利用可能な設定

​

グローバル構成設定

​

Worktree 設定

​

権限設定

​

権限ルール構文

​

サンドボックス設定

​

サンドボックスパスプレフィックス

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["docker *"],
    "filesystem": {
      "allowWrite": ["/tmp/build", "~/.kube"],
      "denyRead": ["~/.aws/credentials"]
    },
    "network": {
      "allowedDomains": ["github.com", "*.npmjs.org", "registry.yarnpkg.com"],
      "deniedDomains": ["uploads.github.com"],
      "allowUnixSockets": [
        "/var/run/docker.sock"
      ],
      "allowLocalBinding": true
    }
  }
}

• sandbox.filesystem 設定（上記）：OS レベルのサンドボックス境界でパスを制御します。これらの制限は、Claude のファイルツールだけでなく、すべてのサブプロセスコマンド（例：kubectl、terraform、npm）に適用されます。
• 権限ルール：Edit allow/deny ルールを使用して Claude のファイルツールアクセスを制御し、Read deny ルールを使用して読み取りをブロックし、WebFetch allow/deny ルールを使用してネットワークドメインを制御します。これらのルールからのパスもサンドボックス構成にマージされます。

​

属性設定

• コミットはデフォルトでgit トレーラー（Co-Authored-By など）を使用し、カスタマイズまたは無効にできます
• プルリクエストの説明はプレーンテキストです

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

🤖 Generated with [Claude Code](https://claude.com/claude-code)

{
  "attribution": {
    "commit": "Generated with AI\n\nCo-Authored-By: AI <ai@example.com>",
    "pr": ""
  }
}

​

ファイル提案設定

{
  "fileSuggestion": {
    "type": "command",
    "command": "~/.claude/file-suggestion.sh"
  }
}

{"query": "src/comp"}

src/components/Button.tsx
src/components/Modal.tsx
src/components/Form.tsx

#!/bin/bash
query=$(cat | jq -r '.query')
# your-repo-file-index をあなた自身のファイル検索コマ​​ンドに置き換えます
your-repo-file-index --query "$query" | head -20

​

フッターリンクバッジ

{
  "footerLinksRegexes": [
    {
      "type": "regex",
      "pattern": "\\b(?<key>PROJ-\\d+)\\b",
      "url": "https://issues.example.com/browse/{key}",
      "label": "{key}"
    }
  ]
}

​

Hook 構成

• Managed hooks と SDK hooks が読み込まれます
• managed 設定 enabledPlugins で強制的に有効にされたプラグインからの Hooks が読み込まれます。これにより、管理者は組織マーケットプレイスを通じて検証済みの hooks を配布しながら、他のすべてをブロックできます。信頼は完全な plugin@marketplace ID によって付与されるため、別のマーケットプレイスからの同じ名前のプラグインはブロックされたままです
• ユーザー hooks、プロジェクト hooks、およびその他すべてのプラグイン hooks はブロックされます

{
  "allowedHttpHookUrls": ["https://hooks.example.com/*", "http://localhost:*"]
}

{
  "httpHookAllowedEnvVars": ["MY_TOKEN", "HOOK_SECRET"]
}

​

ポリシーヘルパーで managed 設定を計算

{
  "managedSettings": {
    "permissions": { "deny": ["Read(//etc/secrets/**)"] }
  },
  "claudeMd": "# Organization context\n...",
  "appendSystemPrompt": "Always cite the internal style guide."
}

​

設定の優先度

1. Managed 設定（サーバー管理、MDM/OS レベルのポリシー、または managed 設定）
   • IT がサーバー配信、MDM 構成プロファイル、レジストリポリシー、または managed 設定ファイルを通じて展開するポリシー
   • コマンドラインの引数を含む他のレベルでオーバーライドできません
   • managed ティア内では、優先度は：policyHelper出力（構成されている場合は唯一の managed ソースとして使用）> リモート（claude.ai サーバー管理または Claude apps gateway配信）> MDM/OS レベルのポリシー > ファイルベース（managed-settings.d/*.json + managed-settings.json）> HKCU レジストリ（Windows のみ）です。1 つの managed ソースのみが使用されます。ソースはマージされません。ただし、サンドボックスロックキー sandbox.network.allowManagedDomainsOnly と sandbox.filesystem.allowManagedReadPathsOnly、それらの関連ホワイトリスト、allowAllClaudeAiMcps、およびサンドボックスバイナリパス sandbox.bwrapPath と sandbox.socatPath は、管理者制御の managed ソースがそれらを設定する場合に尊重されます。ユーザー書き込み可能な HKCU ティアは除外されます。ファイルベースティア内では、ドロップインファイルとベースファイルがマージされます。
   • Agent SDK または IDE 拡張機能などの埋め込みホストプロセスによってプログラム的に提供される managed 設定。デフォルトではこれは管理者デプロイ済みの managed ティアが存在する場合は無視されます：サーバー管理設定、MDM または OS レベルのポリシー、または managed 設定ファイル。ユーザー書き込み可能な HKCU レジストリフォールバックは管理者デプロイ済みソースとしてカウントされません。管理者は parentSettingsBehaviorを "merge" に設定することでオプトインできます。埋め込み側の値はフィルタリングされるため、managed ポリシーを厳しくできますが、緩くすることはできません。
2. コマンドラインの引数
   • 特定のセッションの一時的なオーバーライド。JSON は --settings <file-or-json> を通じて渡され、ファイルベース設定と同じルールを使用して他のレイヤーとマージされます：ここで設定されたキーはローカル、プロジェクト、またはユーザー設定の同じキーをオーバーライドし、キーを省略すると下位レイヤーの値が保持されます
3. ローカルプロジェクト設定（.claude/settings.local.json）
   • 個人的なプロジェクト固有の設定
4. 共有プロジェクト設定（.claude/settings.json）
   • ソース管理内のチーム共有プロジェクト設定
5. ユーザー設定（~/.claude/settings.json）
   • 個人的なグローバル設定

​

アクティブな設定を確認

​

構成システムの重要なポイント

• メモリファイル（CLAUDE.md）：Claude が起動時に読み込む命令とコンテキストを含みます
• 設定ファイル（JSON）：権限、環境変数、およびツール動作を構成します
• Skills：/skill-name で呼び出すか、Claude によって自動的に読み込むことができるカスタムプロンプト
• MCP サーバー：追加のツールと統合で Claude Code を拡張します
• 優先度：高レベルの構成（Managed）が低レベルの構成（User/Project）をオーバーライドします
• 継承：設定はマージされ、スカラー値はより高い優先度のスコープからオーバーライドされ、配列は連結されます。例外：fallbackModel は位置が意味を持つ順序付きチェーン：これを定義する最高優先度ファイルが全体の値を提供します。v2.1.175 以降、availableModels は managed またはポリシー値が低優先度エントリを完全に置き換えます

​

システムプロンプト

​

機密ファイルを除外

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Read(./config/credentials.json)",
      "Read(./build)"
    ]
  }
}

​

Subagent 構成

• ユーザー subagents：~/.claude/agents/ - すべてのプロジェクト全体で利用可能
• プロジェクト subagents：.claude/agents/ - プロジェクト固有で、チームと共有できます

​

プラグイン構成

​

プラグイン設定

{
  "enabledPlugins": {
    "formatter@acme-tools": true,
    "deployer@acme-tools": true,
    "analyzer@security-plugins": false
  },
  "extraKnownMarketplaces": {
    "acme-tools": {
      "source": {
        "source": "github",
        "repo": "acme-corp/claude-plugins"
      }
    }
  }
}

​

enabledPlugins

• ユーザー設定（~/.claude/settings.json）：個人的なプラグイン設定
• プロジェクト設定（.claude/settings.json）：チームと共有されるプロジェクト固有のプラグイン
• ローカル設定（.claude/settings.local.json）：マシンごとのオーバーライド（Claude Code が作成する場合は gitignored）
• Managed 設定（managed-settings.json）：すべてのスコープでのインストールをブロックし、マーケットプレイスからプラグインを非表示にする組織全体のポリシーオーバーライド

{
  "enabledPlugins": {
    "code-formatter@team-tools": true,
    "deployment-tools@team-tools": true,
    "experimental-features@personal": false
  }
}

​

pluginConfigs

{
  "pluginConfigs": {
    "deployer@acme-tools": {
      "options": {
        "api_endpoint": "https://api.example.com"
      }
    }
  }
}

​

extraKnownMarketplaces

1. チームメンバーはフォルダを信頼するときにマーケットプレイスをインストールするよう求められます
2. チームメンバーはそのマーケットプレイスからプラグインをインストールするよう求められます
3. ユーザーは不要なマーケットプレイスまたはプラグインをスキップできます（ユーザー設定に保存）
4. インストールは信頼境界を尊重し、明示的な同意が必要です

{
  "extraKnownMarketplaces": {
    "acme-tools": {
      "source": {
        "source": "github",
        "repo": "acme-corp/claude-plugins"
      }
    },
    "security-plugins": {
      "source": {
        "source": "git",
        "url": "https://git.example.com/security/plugins.git"
      }
    }
  }
}

• github：GitHub リポジトリ（repo を使用）
• git：任意の git URL（url を使用）
• directory：ローカルファイルシステムパス（開発のみ、path を使用）
• hostPattern：マーケットプレイスホストに一致する正規表現パターン（hostPattern を使用）
• settings：ホストされたリポジトリなしで settings.json に直接宣言されたインラインマーケットプレイス（name と plugins を使用）

{
  "extraKnownMarketplaces": {
    "team-tools": {
      "source": {
        "source": "settings",
        "name": "team-tools",
        "plugins": [
          {
            "name": "code-formatter",
            "source": {
              "source": "github",
              "repo": "acme-corp/code-formatter"
            }
          }
        ]
      }
    }
  }
}

​

strictKnownMarketplaces

• macOS：/Library/Application Support/ClaudeCode/managed-settings.json
• Linux と WSL：/etc/claude-code/managed-settings.json
• Windows：C:\Program Files\ClaudeCode\managed-settings.json

• managed 設定（managed-settings.json）でのみ利用可能
• ユーザーまたはプロジェクト設定でオーバーライドできません（最高優先度）
• ネットワーク/ファイルシステム操作の前に強制されます（ブロックされたソースは実行されません）
• hostPattern と pathPattern を除き、ソース仕様に対して完全一致を使用します。hostPattern と pathPattern は正規表現マッチングを使用します

• undefined（デフォルト）：制限なし - ユーザーは任意のマーケットプレイスを追加できます
• 空配列 []：完全ロックダウン - ユーザーは新しいマーケットプレイスを追加できません
• ソースのリスト：ユーザーは正確に一致するマーケットプレイスのみを追加できます

1. GitHub リポジトリ：

{ "source": "github", "repo": "acme-corp/approved-plugins" }
{ "source": "github", "repo": "acme-corp/security-tools", "ref": "v2.0" }
{ "source": "github", "repo": "acme-corp/plugins", "ref": "main", "path": "marketplace" }

2. Git リポジトリ：

{ "source": "git", "url": "https://gitlab.example.com/tools/plugins.git" }
{ "source": "git", "url": "https://bitbucket.org/acme-corp/plugins.git", "ref": "production" }
{ "source": "git", "url": "ssh://git@git.example.com/plugins.git", "ref": "v3.1", "path": "approved" }

3. URL ベースのマーケットプレイス：

{ "source": "url", "url": "https://plugins.example.com/marketplace.json" }
{ "source": "url", "url": "https://cdn.example.com/marketplace.json", "headers": { "Authorization": "Bearer ${TOKEN}" } }

4. NPM パッケージ：

{ "source": "npm", "package": "@acme-corp/claude-plugins" }
{ "source": "npm", "package": "@acme-corp/approved-marketplace" }

5. ファイルパス：

{ "source": "file", "path": "/usr/local/share/claude/acme-marketplace.json" }
{ "source": "file", "path": "/opt/acme-corp/plugins/marketplace.json" }

6. ディレクトリパス：

{ "source": "directory", "path": "/usr/local/share/claude/acme-plugins" }
{ "source": "directory", "path": "/opt/acme-corp/approved-marketplaces" }

7. ホストパターンマッチング：

{ "source": "hostPattern", "hostPattern": "^github\\.example\\.com$" }
{ "source": "hostPattern", "hostPattern": "^gitlab\\.internal\\.example\\.com$" }

• github：常に github.com に対してマッチ
• git：URL からホスト名を抽出（HTTPS と SSH 形式の両方をサポート）
• url：URL からホスト名を抽出
• npm、file、directory：ホストパターンマッチングではサポートされていません

8. パスパターンマッチング：

{ "source": "pathPattern", "pathPattern": "^/opt/approved/" }
{ "source": "pathPattern", "pathPattern": ".*" }

{
  "strictKnownMarketplaces": [
    {
      "source": "github",
      "repo": "acme-corp/approved-plugins"
    },
    {
      "source": "github",
      "repo": "acme-corp/security-tools",
      "ref": "v2.0"
    },
    {
      "source": "url",
      "url": "https://plugins.example.com/marketplace.json"
    },
    {
      "source": "npm",
      "package": "@acme-corp/compliance-plugins"
    }
  ]
}

{
  "strictKnownMarketplaces": []
}

{
  "strictKnownMarketplaces": [
    {
      "source": "hostPattern",
      "hostPattern": "^github\\.example\\.com$"
    }
  ]
}

• repo または url は正確に一致する必要があります
• ref フィールドは正確に一致する必要があります（または両方が未定義）
• path フィールドは正確に一致する必要があります（または両方が未定義）

// これらは異なるソースです：
{ "source": "github", "repo": "acme-corp/plugins" }
{ "source": "github", "repo": "acme-corp/plugins", "ref": "main" }

// これらも異なります：
{ "source": "github", "repo": "acme-corp/plugins", "path": "marketplace" }
{ "source": "github", "repo": "acme-corp/plugins" }

{
  "strictKnownMarketplaces": [
    { "source": "github", "repo": "acme-corp/plugins" }
  ]
}

{
  "extraKnownMarketplaces": {
    "acme-tools": {
      "source": { "source": "github", "repo": "acme-corp/plugins" }
    }
  }
}

{
  "strictKnownMarketplaces": [
    { "source": "github", "repo": "acme-corp/plugins" }
  ],
  "extraKnownMarketplaces": {
    "acme-tools": {
      "source": { "source": "github", "repo": "acme-corp/plugins" }
    }
  }
}

• 制限はネットワークリクエストまたはファイルシステム操作の前にチェックされます
• ブロックされた場合、ユーザーはソースが managed ポリシーでブロックされていることを示す明確なエラーメッセージを表示します
• 制限はマーケットプレイスの追加およびプラグインのインストール、更新、リフレッシュ、および自動更新に対して強制されます。ポリシーが設定される前に追加されたマーケットプレイスは、そのソースがホワイトリストと一致しなくなると、プラグインのインストールまたは更新に使用できません
• Managed 設定は最高優先度を持ち、オーバーライドできません

​

strictPluginOnlyCustomization

{
  "strictPluginOnlyCustomization": ["skills", "hooks"]
}

​

プラグインの管理

• マーケットプレイスから利用可能なプラグインを参照
• プラグインをインストール/アンインストール
• プラグインを有効/無効にする
• プラグインの詳細を表示（提供される skills、agents、hooks）
• マーケットプレイスを追加/削除

​

環境変数

​

Claude が利用できるツール

​

関連項目

• 権限：権限システム、ルール構文、ツール固有パターン、および managed ポリシー
• 認証：Claude Code へのユーザーアクセスをセットアップ
• 設定をデバッグする：設定、hook、または MCP サーバーが有効にならない理由を診断
• インストールとログインのトラブルシューティング：インストール、認証、およびプラットフォームの問題