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

{
  "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"
  }
}

​

利用可能な設定

​

権限設定

​

設定の優先順位

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/ - プロジェクト固有で、チームと共有可能

​

環境変数

​

設定オプション

• 設定一覧：claude config list
• 設定確認：claude config get <key>
• 設定変更：claude config set <key> <value>
• 設定に追加（リスト用）：claude config add <key> <value>
• 設定から削除（リスト用）：claude config remove <key> <value>

​

グローバル設定

​

Claudeが利用できるツール

​

hooksでツールを拡張

​

関連項目

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