Claude Code の設定ガイド｜CLAUDE.md・permissions・モデル切り替え
「Claude Code を使い始めたけれど、毎回同じ指示を繰り返している」「チームで設定を共有したい」「コストが気になるけれど、どこを調整すればいいかわからない」——こうした悩みは、Claude Code の設定を正しく理解することで解決できます。
Claude Code は、設定をほとんど行わなくてもすぐに使い始められるツールです。しかし、設定を適切に行うことで作業効率は大きく変わります。特に CLAUDE.md による指示の永続化、パーミッションによるセキュリティ管理、モデルの使い分けによるコスト最適化は、日常的に Claude Code を使うなら必ず押さえておきたいポイントです。
本記事では、Claude Code の設定方法を体系的に解説します。初期設定から応用的なチーム運用まで、この記事を読めば Claude Code を自分の開発スタイルに合わせてカスタマイズできるようになります。
BlueAI法人資料テンプレートをWeb向けに再構成
Claude Code の基本的な使い方についてはこちらの記事を参考にしてください。
関連記事 — 使い方 Claude Code の使い方ガイド｜基本操作から実践テクニックまで Claude Code の使い方を基本操作から実践テクニックまで解説。効果的なプロンプトの書き方、ファイル操作、Git 連携など、すぐに使えるノウハウを紹介します。
CLAUDE.md とは何か
CLAUDE.md は、Claude Code に対してプロジェクト固有のルールやコンテキストを伝えるための設定ファイル です。Markdown 形式で記述し、Claude Code がセッションを開始するたびに自動的に読み込まれます。
通常、Claude Code に指示を出すときは対話プロンプトに直接入力します。しかし、プロジェクトのコーディング規約やディレクトリ構成、使用しているフレームワークの情報など、毎回伝える必要がある情報をセッションごとに入力するのは非効率です。
CLAUDE.md にこれらの情報を書いておけば、セッションを新しく開始しても Claude Code が毎回自動的にルールを読み込んで従ってくれます 。いわば、Claude Code のための「プロジェクトマニュアル」です。
CLAUDE.md を使うメリット
指示の繰り返しが不要になる : コーディング規約、命名規則、使用ライブラリなどを毎回伝える手間がなくなる一貫性のある出力が得られる : 同じルールに基づいてコードが生成されるため、プロジェクト全体のスタイルが統一されるチームで設定を共有できる : Git にコミットすることで、チーム全員が同じルールで Claude Code を使える新メンバーのオンボーディングにも役立つ : プロジェクトのルールが文書化されることで、人間にとっても参考資料になる
CLAUDE.md の書き方と配置場所
CLAUDE.md は配置する場所によってスコープが異なります。用途に応じて使い分けましょう。
配置場所ごとのスコープ
配置場所 スコープ 用途 ~/.claude/CLAUDE.md全プロジェクト共通 個人の作業スタイル、言語設定 プロジェクトルート/CLAUDE.mdプロジェクト全体 コーディング規約、アーキテクチャ サブディレクトリ/CLAUDE.md特定ディレクトリ ディレクトリ固有のルール
Claude Code は起動時にこれらのファイルをすべて読み込み、マージして 適用します。グローバル設定とプロジェクト設定が矛盾する場合は、よりスコープの狭い設定が優先されます。
グローバル設定（~/.claude/CLAUDE.md）
マシン全体で共通のルールを定義します。すべてのプロジェクトに適用されるため、個人の作業スタイルに関する設定を書くのに適しています。
Copy # ~/.claude/CLAUDE.md
## 言語設定
- 日本語で応答すること
- コメントも日本語で書くこと
- 変数名・関数名は英語（camelCase）
## 作業スタイル
- 変更前に必ず既存コードのパターンを確認する
- テストファイルが存在する場合は、変更に合わせてテストも更新する
- コミットメッセージは日本語で書くプロジェクト設定（プロジェクトルート/CLAUDE.md）
プロジェクト固有のルールを定義します。Git にコミットしてチーム全体で共有するのが一般的です。
Copy # CLAUDE.md
## プロジェクト概要
- React + TypeScript の Web アプリケーション
- パッケージマネージャ: pnpm
- フレームワーク: React Router v7
## コーディング規約
- TypeScript strict モードを使用する
- コンポーネントは関数コンポーネントで書く
- CSS は Tailwind CSS を使用する
- テストは Vitest で書く
## ディレクトリ構成
- app/routes/ - ページコンポーネント
- app/components/ - 共通コンポーネント
- app/lib/ - ユーティリティ関数
## 命名規則
- ファイル名: kebab-case（例: user-profile.tsx）
- コンポーネント名: PascalCase（例: UserProfile）
- 変数・関数名: camelCase（例: getUserName）
## 開発コマンド
- `pnpm dev` - 開発サーバー起動
- `pnpm test` - テスト実行
- `pnpm build` - ビルド/init コマンドで自動生成
CLAUDE.md を一から書くのが面倒な場合は、/init コマンドを使ってプロジェクトの構成を自動分析し、CLAUDE.md を生成できます。
Claude Code がプロジェクトのファイル構成、package.json、設定ファイルなどを読み取り、適切な CLAUDE.md のテンプレートを生成してくれます。生成された内容をベースに、プロジェクト固有のルールを追加・修正していくのが効率的です。
CLAUDE.md を書くときのコツ
簡潔に書く : 長すぎる CLAUDE.md はトークンを消費します。本当に必要なルールだけを記述しましょう。
具体的に書く : 「きれいなコードを書く」のような曖昧な指示ではなく、「関数は50行以内に収める」「早期リターンを使う」など具体的なルールにします。
禁止事項を明記する : 「使ってはいけない」ものを明示すると効果的です。例えば、「any 型を使わない」「console.log をコミットしない」など。
開発コマンドを書く : ビルド、テスト、lint のコマンドを記載しておくと、Claude Code が適切なタイミングでこれらを実行できます。
パーミッション設定
Claude Code はファイルの読み書きやシェルコマンドの実行を行うため、パーミッション（許可）の管理 はセキュリティ上重要です。何を自動承認し、何を毎回確認するかを適切に設定することで、安全性と利便性のバランスを取れます。
パーミッションの仕組み
Claude Code がファイルを変更したりコマンドを実行したりするときには、デフォルトでユーザーの承認 が求められます。これは安全のための仕組みですが、信頼できる操作まで毎回承認するのは非効率です。
パーミッション設定では、以下の3つのレベルで制御できます。
Allow（許可） : 確認なしで自動実行するAsk（確認） : 実行前にユーザーに確認を求める（デフォルト）Deny（拒否） : 実行を禁止する
settings.json によるパーミッション設定
プロジェクトルートの .claude/settings.json にパーミッションルールを定義できます。
Copy {
"permissions" : {
"allow" : [
"Read" ,
"Glob" ,
"Grep" ,
"Bash(npm test)" ,
"Bash(npm run lint)" ,
"Bash(npm run build)" ,
"Bash(git status)" ,
"Bash(git diff)" ,
"Bash(git log)"
] ,
"deny" : [
"Bash(rm -rf *)" ,
"Bash(git push --force)" ,
"Bash(git reset --hard)"
]
}
} allow に追加したツールやコマンドは確認なしで実行されます。deny に追加したものは Claude Code が実行しようとしてもブロックされます。
設定のスコープ
パーミッション設定も CLAUDE.md と同様に複数のスコープがあります。
配置場所 スコープ ~/.claude/settings.json全プロジェクト共通 プロジェクトルート/.claude/settings.jsonプロジェクト固有
プロジェクト固有の設定は Git にコミットすることで、チーム全体で同じパーミッションルールを共有できます。
/permissions コマンド
現在のパーミッション設定を確認・変更するには、/permissions コマンドを使います。
対話的にパーミッションを追加・削除できるため、settings.json を直接編集するよりも手軽です。
おすすめのパーミッション設定
開発効率とセキュリティのバランスを考慮した、おすすめの設定を紹介します。
自動許可にしてよいもの:
ファイルの読み取り（Read, Glob, Grep）
テスト実行（Bash(npm test) など）
lint/format（Bash(npm run lint) など）
Git の参照系（git status, git diff, git log）
毎回確認すべきもの:
ファイルの書き込み（Write, Edit）
任意のシェルコマンド実行
Git の変更系（git commit, git push）
明示的に禁止すべきもの:
rm -rf による再帰的削除git push --force による強制プッシュgit reset --hard による変更の破棄本番環境に影響するデプロイコマンド
モデル切り替え
Claude Code では、使用する AI モデルを切り替えることができます。タスクの性質に応じてモデルを使い分けることで、品質とコストのバランスを最適化 できます。
/model コマンド
セッション中にモデルを切り替えるには、/model コマンドを使います。
利用可能なモデル一覧が表示され、対話的に選択できます。また、モデル名を直接指定することも可能です。
モデルの使い分け
Claude Code で利用できる主なモデルと、その使い分けの目安は以下の通りです。
モデル 特徴 おすすめの用途 Opus 複雑な推論を重視 アーキテクチャ設計、複雑なリファクタリング、根本原因分析 Sonnet 速度と精度のバランス 日常的なコーディング、機能追加、コードレビュー Haiku 速度とコストを重視 簡単な質問、ファイル検索、定型的な変更
起動時のモデル指定
コマンドラインから起動時にモデルを指定することもできます。
Copy claude --model sonnet特定のタスクに集中するセッションでは、あらかじめモデルを指定して起動すると効率的です。
コスト意識を持ったモデル選択
API 従量課金を使っている場合、モデルの選択はコストに直結します。目安として以下の使い分けが効果的です。
日常作業の8割は Sonnet : 品質・速度・コストのバランスが最も良い難しい問題には Opus : 複雑なバグの調査やアーキテクチャ判断など、精度が重要な場面で使用簡単なタスクには Haiku : ファイルの検索、簡単な質問、フォーマット変更など、精度をそこまで求めない場面で使用
サブスクリプションにも利用上限があり、任意の超過利用やAPIは別の課金条件になる場合があります。モデル選択は品質だけでなく、契約中の利用枠も確認してください。
コスト管理の設定
Claude Code を継続的に使う上で、コスト管理は避けて通れないテーマです。特に API 従量課金を利用している場合は、適切な管理設定を行いましょう。
/cost コマンドでモニタリング
セッション中のトークン消費量とコストを確認するには、/cost コマンドを使います。
入力トークン数、出力トークン数、推定コストが表示されます。定期的に確認する習慣をつけることで、予想外の高額請求を防げます。
Anthropic Console でのコスト上限設定
API 従量課金を使っている場合は、Anthropic Console から以下の設定が可能です。
月額の支出上限 : 1ヶ月のAPI利用料の上限を設定使用量アラート : 一定額に達したら通知を受け取る
これらの設定は Anthropic Console の「Settings」から行えます。想定外のコストを防ぐために、必ず上限を設定しておきましょう。
トークン消費を抑えるテクニック
日常的にコストを抑えるためのテクニックをまとめます。
/compact を活用する/compact を実行し、会話履歴を要約・圧縮しましょう。
具体的な指示を出す : 曖昧な指示は試行錯誤を招き、余分なトークンを消費します。最初から具体的に指示することで、やり直しの回数を減らせます。
CLAUDE.md を整備するCLAUDE.md に書いておくことで、毎回の説明が不要になりトークンを節約できます。
セッションを適切に区切る : 無関係な複数のタスクを同じセッションで処理すると、コンテキストが肥大化します。タスクが変わったら /clear で新しいセッションを始めましょう。
permissionsでファイルアクセスを制限する
Claude Codeの公式なアクセス制御として.claudeignoreへ依存しないでください。機密ファイルは.claude/settings.jsonのpermissions.denyへ指定します。
Copy {
"permissions" : {
"deny" : [
"Read(./.env)" ,
"Read(./.env.*)" ,
"Read(./**/*.pem)" ,
"Read(./**/*.key)" ,
"Read(./secrets/**)" ,
"Read(./data/customer/**)"
]
}
} パス指定は設定ファイルの場所や現在の作業ディレクトリに対して解決されます。/permissionsで、ルールとその設定元を確認してください。
Read denyはClaude Codeのファイルツールと、認識できる一部のシェル読み取りコマンドへ適用されます。任意のPython・Node.jsプロセスなどを含め、OSレベルでアクセスを止める必要がある場合はsandboxのファイルシステム制限を併用します。
チーム共有の設定方法
Claude Code の設定をチーム全体で共有することで、メンバー全員が一貫した開発体験を得られます。
Git にコミットすべき設定ファイル
以下のファイルはプロジェクトリポジトリにコミットし、チーム全体で共有しましょう。
ファイル 用途 CLAUDE.mdプロジェクトのルール・規約 .claude/settings.jsonパーミッション設定 .claude/commands/カスタムスラッシュコマンド
Git にコミットすべきでない設定ファイル
個人の好みに関する設定はグローバル設定（~/.claude/）に置き、リポジトリにはコミットしません。
Copy # ~/.claude/CLAUDE.md（個人設定の例）
## 個人の好み
- 日本語で応答する
- 説明は簡潔にする
- コード変更時は必ず差分を表示するチーム設定のベストプラクティス
段階的に導入する : 最初から完璧な CLAUDE.md を目指さず、チームで使いながら徐々にルールを追加していく
レビューに含める : CLAUDE.md の変更もコードレビューの対象にする。ルールの追加・変更がチーム全体に影響するため、合意形成が重要
定期的に見直す : プロジェクトの進行に伴い、不要になったルールやアップデートが必要なルールが出てくる。定期的なメンテナンスを行う
おすすめ初期設定テンプレート
最後に、Claude Code を使い始めるときにすぐ使えるテンプレートを紹介します。プロジェクトの状況に応じてカスタマイズしてください。
CLAUDE.md テンプレート
Copy # CLAUDE.md
## プロジェクト概要
- [プロジェクト名]: [簡単な説明]
- 技術スタック: [言語], [フレームワーク], [主要ライブラリ]
- パッケージマネージャ: [npm/pnpm/yarn/bun]
## コーディング規約
- 言語: TypeScript（strict モード）
- フォーマッター: Prettier
- リンター: ESLint
- テスト: Vitest
## 命名規則
- ファイル名: kebab-case
- コンポーネント名: PascalCase
- 変数・関数名: camelCase
- 定数: UPPER_SNAKE_CASE
## ディレクトリ構成
- src/routes/ - ページ
- src/components/ - 共通コンポーネント
- src/lib/ - ユーティリティ
- src/types/ - 型定義
## 開発コマンド
- `npm run dev` - 開発サーバー起動
- `npm test` - テスト実行
- `npm run build` - ビルド
- `npm run lint` - lint 実行
## 禁止事項
- any 型を使わない
- console.log をコミットしない
- インラインスタイルを使わない（Tailwind CSS を使用）settings.json テンプレート
Copy {
"permissions" : {
"allow" : [
"Read" ,
"Glob" ,
"Grep" ,
"Bash(npm test)" ,
"Bash(npm run lint)" ,
"Bash(npm run build)" ,
"Bash(npx tsc --noEmit)" ,
"Bash(git status)" ,
"Bash(git diff)" ,
"Bash(git log)"
] ,
"deny" : [
"Bash(rm -rf *)" ,
"Bash(git push --force)" ,
"Bash(git reset --hard)"
]
}
} 機密ファイル拒否テンプレート
Copy {
"permissions" : {
"deny" : [
"Read(./.env)" ,
"Read(./.env.*)" ,
"Read(./**/*.pem)" ,
"Read(./**/*.key)" ,
"Read(./**/*.cert)" ,
"Read(./secrets/**)"
]
}
} プロジェクト固有の機密パスを追加し、通常ファイルを誤って塞いでいないか/permissionsと実際の操作で確認します。
おすすめスキル
設定をさらに強化するスキルです。
Claude Brain Smart Tree
まとめ
本記事では、Claude Code の設定方法を体系的に解説しました。ポイントを振り返ります。
CLAUDE.md でルールを永続化する : プロジェクトのコーディング規約や構成情報を記述し、毎回の説明を省く配置場所でスコープを分ける : グローバル設定（~/.claude/）は個人の好み、プロジェクト設定は規約に使い分けるパーミッションで安全性を確保する : 信頼できる操作は自動許可、危険な操作は明示的に拒否するモデルを使い分ける : 日常は Sonnet、難問は Opus、簡易タスクは Haiku でコストを最適化する利用量を管理する : /usage（/costはエイリアス）で確認し、/compactでコンテキストを整理するpermissionsとsandboxでアクセスを制御する : 機密ファイルと外部実行の境界を作るチームで設定を共有する : CLAUDE.md と .claude/settings.json を Git にコミットする
設定は一度行えば終わりではなく、プロジェクトの成長に合わせて育てていくものです。まずはテンプレートをベースに始めて、使いながら最適化していくのがおすすめです。
モデルaliasと固定IDをチーム運用で使い分ける際は、モデルaliasと固定IDの更新情報 も確認してください。
設定の詳細やカスタムコマンドの活用方法について、さらに深く学びたい方は以下のレッスンを参照してください。
レッスン プロンプト術 — 60分 CLAUDE.md の書き方｜Claude Code の脳を育てる プロジェクト固有の文脈を CLAUDE.md にまとめ、毎回の説明をゼロにする書き方を体系化。階層構造、章立てテンプレート、更新運用、ハマる NG パターンまで、実プロジェクト例つきで解説します。
レッスン プロンプト術 — 60分 Claude Code プロンプトの書き方｜5 大原則と実例集 Claude Code への指示文を磨くプロンプトエンジニアリング実践。明確化・分解・例示など 5 大原則、Bad / Good 対比、職種別テンプレ集で、ChatGPT 流とは違う Claude Code 特有の作法を体系化します。
レッスン コスト管理 — 60分 Claude Code API 料金の仕組み｜トークン課金を解剖 Claude Code の請求書の正体を分解。トークンの数え方、入出力単価、Prompt Caching、コンテキストウィンドウまで、API 料金構造を完全解説。月額がいくらになるかの読み方を体に入れます。
株式会社BlueAI||法人向けAI導入・内製化支援
