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 とアクセス制御 - エンタープライズポリシー管理
• トラブルシューティング - 一般的な構成の問題の解決策