ホーム/各種設定

各種設定

対象: 中級者〜

Claude Code の動作は設定ファイルで細かくカスタマイズできます。使用モデルの変更、許可するコマンドの制御、チーム全体のルール定義など、プロジェクトの要件に合わせた柔軟な設定が可能です。設定は複数のスコープ（範囲）に分かれており、優先順位があります。

設定ファイルの種類と優先順位

Claude Code は複数の設定ファイルを読み込みますが、左にあるものほど優先度が高く、同じ項目は上書きされます。図の各ボックスにホバーすると説明が表示されます。

Managed
→
CLI引数
→
ローカル
→
プロジェクト
→
ユーザー
← 優先度 高 ｜ 優先度 低 →（ホバーで詳細表示）

設定ファイル一覧

種類ファイルパススコープGit共有
ユーザー設定~/.claude/settings.json全プロジェクト共通No
プロジェクト設定.claude/settings.jsonプロジェクト全体Yes
ローカル設定.claude/settings.local.jsonプロジェクト（個人）No
CLAUDE.mdCLAUDE.md or .claude/CLAUDE.mdディレクトリ単位Yes

settings.json の構成例

設定ファイルは JSON 形式です。以下は代表的な設定項目を含む例です。

json
{
  "defaultMode": "default",
  "model": "claude-sonnet-4-6",
  "env": {
    "CUSTOM_VAR": "value",
    "DISABLE_AUTOUPDATER": "1"
  },
  "permissions": {
    "allow": [
      "Bash(npm run *)",
      "Read"
    ],
    "deny": [
      "Bash(rm -rf *)"
    ]
  },
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["tool", "mcp"]
    }
  }
}

CLAUDE.md — プロジェクトの指示書

CLAUDE.md は、Claude Code がセッション開始時に自動的に読み込むプロジェクト固有の指示書です。コーディング規約、ディレクトリ構造の説明、レビュー基準などを記述しておくと、Claude がそれに従って作業してくれます。チームメンバーと共有するため、Git にコミットしましょう。

ポイント

CLAUDE.md は「Claude への業務マニュアル」と考えてください。新しいチームメンバーに伝えるような情報を書くのが効果的です。

markdown
# プロジェクトルール

## コーディングスタイル
- TypeScript を使用
- 関数名は camelCase
- テストは Jest で記述

## ディレクトリ構造
- src/ にソースコード
- tests/ にテスト

環境変数

settings.json の env フィールドで環境変数を設定できます。Claude Code の内部動作やツールの挙動を制御するために使います。

変数名説明
DISABLE_AUTOUPDATER1 を設定すると自動更新を無効化
USE_BUILTIN_RIPGREP0 を設定するとシステムにインストール済みの ripgrep を使用
CLAUDE_CODE_GIT_BASH_PATHWindows 環境での Git Bash のパスを明示的に指定

機密ファイルの除外

APIキーやパスワードが含まれるファイルを Claude Code の読み取り対象から除外できます。

json
{
  "excludeSensitiveFiles": [
    "**/.env",
    "**/secrets.json",
    "**/*.key"
  ]
}

対話モード中に /config と入力すると、対話型の設定画面が開きます。

公式設定リファレンス ↗
← 前のページ
スキル