Claude Code設定

Claude Codeは、ニーズに合わせて動作を設定するための様々な設定を提供しています。インタラクティブREPLを使用する際に/configコマンドを実行することで、Claude Codeを設定できます。

​

設定ファイル

settings.jsonファイルは、階層設定を通じて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"
  }
}

​

利用可能な設定

settings.jsonは多数のオプションをサポートしています：

​

権限設定

​

設定の優先順位

設定は優先順位の順序で適用されます（高い順から低い順）：

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を拡張します
• 優先順位：上位レベルの設定（エンタープライズ）が下位レベル（ユーザー/プロジェクト）を上書きします
• 継承：設定はマージされ、より具体的な設定がより広範な設定に追加または上書きします

​

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

​

機密ファイルの除外

Claude Codeが機密情報を含むファイル（APIキー、シークレット、環境ファイルなど）にアクセスするのを防ぐには、.claude/settings.jsonファイルのpermissions.deny設定を使用します：

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

これは非推奨のignorePatterns設定を置き換えます。これらのパターンに一致するファイルは、Claude Codeから完全に見えなくなり、機密データの偶発的な露出を防ぎます。

​

サブエージェント設定

Claude Codeは、ユーザーレベルとプロジェクトレベルの両方で設定できるカスタムAIサブエージェントをサポートしています。これらのサブエージェントは、YAMLフロントマターを持つMarkdownファイルとして保存されます：

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

サブエージェントファイルは、カスタムプロンプトとツール権限を持つ専門のAIアシスタントを定義します。サブエージェントの作成と使用について詳しくは、サブエージェントドキュメントをご覧ください。

​

環境変数

Claude Codeは、その動作を制御するために以下の環境変数をサポートしています：

​

設定オプション

設定を管理するには、以下のコマンドを使用します：

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

デフォルトではconfigはプロジ設定を変更します。グローバル設定を管理するには、--global（または-g）フラグを使用します。

​

グローバル設定

グローバル設定を設定するには、claude config set -g <key> <value>を使用します：

​

Claudeが利用できるツール

Claude Codeは、コードベースを理解し変更するのに役立つ強力なツールセットにアクセスできます：

権限ルールは/allowed-toolsまたは権限設定で設定できます。ツール固有の権限ルールも参照してください。

​

hooksでツールを拡張

Claude Code hooksを使用して、任意のツール実行の前後にカスタムコマンドを実行できます。

例えば、ClaudeがPythonファイルを変更した後に自動的にPythonフォーマッターを実行したり、特定のパスへのWrite操作をブロックして本番設定ファイルの変更を防いだりできます。

​

関連項目

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