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アシスタントを定義します。サブエージェントの作成と使用について詳しくは、subagents documentationをご覧ください。

​

環境変数

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は、コードベースを理解し変更するのに役立つ強力なツールセットにアクセスできます：

ebookEdit** | Jupyterノートブックセルを変更 | はい | | NotebookRead | Jupyterノートブックの内容を読み取り表示 | いいえ | | Read | ファイルの内容を読み取り | いいえ | | Task | 複雑な多段階タスクを処理するサブエージェントを実行 | いいえ | | TodoWrite | 構造化されたタスクリストを作成・管理 | いいえ | | WebFetch | 指定されたURLからコンテンツを取得 | はい | | WebSearch | ドメインフィルタリング付きでWeb検索を実行 | はい | | Write | ファイルを作成または上書き | はい |

権限ルールは/allowed-toolsまたは権限設定で設定できます。

​

フックでツールを拡張

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

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

​

関連項目

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