Claude Codeのモデル設定|役割ごとに変える3か所と優先順位
Claude Codeのモデル設定は環境変数・エージェント定義ファイル・実行時オプションの3か所に分かれ、重なると決まった順序で上書きされます。AIエージェントのディレクター役とワーカー役へ別々に割り当てる書き方、2本ある優先順位、反映されないときに疑う順番までを検証環境つきで整理します。
Claude導入時に絶対にやっておくべき初期設定、権限設計、CLAUDE.mdの書き方まで、最初の一歩を実物ベースで解説します。
Claude Codeのモデル設定は環境変数・エージェント定義ファイル・実行時オプションの3か所に分かれ、重なると決まった順序で上書きされます。AIエージェントのディレクター役とワーカー役へ別々に割り当てる書き方、2本ある優先順位、反映されないときに疑う順番までを検証環境つきで整理します。
MCPの接続設定は、書く中身より先に置き場所で決まります。ローカル・プロジェクト・ユーザーの選び分け、名前がぶつかったときの採用順位、APIキーを書かずに配る書式、AIエージェントから本当に呼べたかを確かめる手順までを公式ドキュメントから整理します。
Claude Codeのプロジェクト構成は、完成版と中間物の分離・案件IDでの串刺し・読む先の限定という3つで決まります。AIエージェントが置き場を毎回探し直す往復をどこで止めるのか、フォルダの初期設計から書き込み拒否ルールの一行、動作確認の手順までを順にたどります。
SessionStartフックは、セッションが始まるたびに1回だけ発火し、スクリプトの標準出力をAIエージェントの文脈へ渡す仕組みです。注入スクリプトの書き方、settings.jsonへの登録、3本並べたときの役割分担、matcherを絞りすぎて効かなくなる原因までを実測つきで整理します。
Claude Codeのsettings.jsonは5階層で、優先順位はスコープの種類だけで決まります。スカラー値は上位が勝ち、配列値は合算されるという公式ドキュメントの規則を整理し、AIエージェントの設定をチーム共有と個人用にどう仕分けるかまで示します。
PreToolUseフックは、AIエージェントがコマンドを実行する直前に割り込み、allow・deny・ask・deferの4つで可否を返します。危険コマンドを遮断するPythonの実装、テストの書き方、誤検知を減らす配分の考え方を、公式ドキュメントと自社の運用実例で整理します。
Claude Codeの権限設定は、ツール呼び出しをdeny・ask・allowの3列へ仕分ける作業です。評価順序は固定で、ルールの細かさは順位を変えません。AIエージェントに任せてよい範囲を、公式ドキュメントと自社settings.jsonの実例から決めます。
CLAUDE.mdの書き方は、章立て・禁止事項・分割の3点で決まります。AIエージェントに起動のたびに読ませる指示ファイルを7章の型に落とし、書いても止まらない禁止事項の切り出し先と、200行を超えたときに読ませる量を減らす分け方を、公式ドキュメントと自社ファイルの実測から整理します。
Claude Codeの初期設定は、権限・フック・ルールファイル・記録の4観点を初日に決めておくと作り直しを防げます。AIエージェントに任せる範囲をどこに書けば仕組みとして効くのかを、公式ドキュメントと自社のsettings.jsonの実例から組み立てます。
「うちの業務でも動くのか」「どこから手をつけるのか」。記事を読んで出てきた疑問を、そのままお持ちください。自社でAIエージェントを動かしている実務者が、無料でお答えします。