Claude Code の設定

​

設定ファイル

• ユーザー設定は ~/.claude/settings.json で定義され、すべてのプロジェクトに適用されます。
• プロジェクト設定はプロジェクトディレクトリに保存されます：
  • .claude/settings.json はソース管理にチェックインされ、チームと共有される設定用
  • .claude/settings.local.json はチェックインされない設定用で、個人的な設定と実験に便利です。Claude Code は作成時に .claude/settings.local.json を無視するように git を構成します。
• Claude Code のエンタープライズデプロイメントでは、エンタープライズ管理ポリシー設定もサポートしています。これらはユーザー設定とプロジェクト設定より優先されます。システム管理者は以下にポリシーをデプロイできます：
  • macOS: /Library/Application Support/ClaudeCode/managed-settings.json
  • Linux および WSL: /etc/claude-code/managed-settings.json
  • Windows: C:\ProgramData\ClaudeCode\managed-settings.json
• エンタープライズデプロイメントは、ユーザー構成サーバーをオーバーライドする管理 MCP サーバーも構成できます。エンタープライズ MCP 構成を参照してください：
  • macOS: /Library/Application Support/ClaudeCode/managed-mcp.json
  • Linux および WSL: /etc/claude-code/managed-mcp.json
  • Windows: C:\ProgramData\ClaudeCode\managed-mcp.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"
  }
}

​

利用可能な設定

​

権限設定

​

サンドボックス設定

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["docker"],
    "network": {
      "allowUnixSockets": [
        "/var/run/docker.sock"
      ],
      "allowLocalBinding": true
    }
  },
  "permissions": {
    "deny": [
      "Read(.envrc)",
      "Read(~/.aws/**)"
    ]
  }
}

• Read 拒否ルールはサンドボックス内のファイル読み取りをブロックします
• Edit 許可ルールはファイル書き込みを許可します（デフォルトに加えて、例えば現在の作業ディレクトリ）
• Edit 拒否ルールは許可されたパス内の書き込みをブロックします

• WebFetch 許可ルールはネットワークドメインを許可します
• WebFetch 拒否ルールはネットワークドメインをブロックします

​

設定の優先順位

1. エンタープライズ管理ポリシー（managed-settings.json）
   • IT/DevOps によってデプロイされます
   • オーバーライドできません
2. コマンドラインの引数
   • 特定のセッションの一時的なオーバーライド
3. ローカルプロジェクト設定（.claude/settings.local.json）
   • 個人的なプロジェクト固有の設定
4. 共有プロジェクト設定（.claude/settings.json）
   • ソース管理内のチーム共有プロジェクト設定
5. ユーザー設定（~/.claude/settings.json）
   • 個人的なグローバル設定

​

構成システムについての重要なポイント

• メモリファイル（CLAUDE.md）：Claude が起動時にロードする指示とコンテキストを含みます
• 設定ファイル（JSON）：権限、環境変数、およびツール動作を構成します
• スラッシュコマンド：セッション中に /command-name で呼び出すことができるカスタムコマンド
• MCP サーバー：追加のツールと統合で Claude Code を拡張します
• 優先順位：より高いレベルの構成（エンタープライズ）がより低いレベルのもの（ユーザー/プロジェクト）をオーバーライドします
• 継承：設定はマージされ、より具体的な設定がより広いものに追加またはオーバーライドされます

​

システムプロンプトの可用性

​

機密ファイルの除外

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

​

サブエージェント構成

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

​

プラグイン構成

​

プラグイン設定

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

​

enabledPlugins

• ユーザー設定（~/.claude/settings.json）：個人的なプラグイン設定
• プロジェクト設定（.claude/settings.json）：チームと共有されるプロジェクト固有のプラグイン
• ローカル設定（.claude/settings.local.json）：マシンごとのオーバーライド（コミットされない）

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

​

extraKnownMarketplaces

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

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

• github：GitHub リポジトリ（repo を使用）
• git：任意の git URL（url を使用）
• directory：ローカルファイルシステムパス（path を使用、開発用のみ）

​

プラグインの管理

• マーケットプレイスから利用可能なプラグインを参照
• プラグインをインストール/アンインストール
• プラグインを有効/無効
• プラグインの詳細を表示（提供されるコマンド、エージェント、フック）
• マーケットプレイスを追加/削除

​

環境変数

​

Claude が利用可能なツール

​

フックでツールを拡張

​

関連項目

• Identity and Access Management - Claude Code の権限システムについて学ぶ
• IAM とアクセス制御 - エンタープライズポリシー管理
• トラブルシューティング - 一般的な構成の問題の解決策