GadgetDrop
AI注目

Claude Codeをプロジェクトに触れさせる前に変えるべき4つの設定——承認プロンプト地獄を抜け出す5分の初期設定

GadgetDrop 編集部9
Claude Codeをプロジェクトに触れさせる前に変えるべき4つの設定——承認プロンプト地獄を抜け出す5分の初期設定

コーディングエージェント Claude Code を「とりあえずプロンプトを投げる」だけで使っている人は多いかもしれません。しかし、プロジェクトを触らせる前にわずか5分4つの設定を見直すだけで、その後の承認プロンプト連打やモデル選択のミスから解放されるとXDA Developersが報じています。同記事の記者が1年近くの使用経験をもとに「新規プロジェクトでは必ず変える」と明言する4設定を紹介します。

① 毎セッションの同じ修正指示から解放される:CLAUDE.md を最初に置く

新しいプロジェクトに入った同僚に対して、いきなり作業を任せるのではなく15分ほどの会話で前提を共有するのと同じ発想です。CLAUDE.md はプロジェクトのルートディレクトリに置く単純なマークダウンファイルで、Claude Code は毎セッションの最初にこのファイルを読み込みます。

書く内容は、使用している技術スタック、フォルダ構成、すでに固まっている命名規則やコーディング規約、触ってほしくない範囲などです。一度書いておけば、以降のプロンプトでは Claude Code が常にこの文脈を踏まえて応答するため、毎セッションで同じ修正指示を繰り返す必要がなくなるのが最大のメリットだと説明されています。数メッセージごとに訂正を入れる手間や、セッションごとにゼロから前提を説明し直す手間が消えるわけです。

プロジェクト開始時には /init コマンドを実行すれば、Claude Code がコードベースをスキャンしてスタック構成を読み取り、CLAUDE.md のたたき台を自動生成します。生成された内容は完全ではないものの出発点としては有用で、Claude Code がしてほしくない挙動をした際にその場で1行追記していく運用が現実的だとされています。

② 承認プロンプト地獄から抜け出す:事前にパーミッションを設定する

デフォルトの Claude Code は、bash コマンド実行・ファイル編集・Web検索など基本的な動作のたびに毎回確認を求めてきます。意図はユーザーを介在させるためですが、実際には npm installgit status のような同じ承認プロンプトを延々と Enter で承諾し続けるか、しびれを切らして --dangerously-skip-permissions を有効化してマシン全体を Claude に明け渡してしまうかの二択になりがちです。

中間解として推奨されているのが、事前にパーミッションを設定しておく方法です。Claude Code は allow / ask / deny の3種ルールに基づいて動作し、これらは .claude/settings.json に保存されます。/permissions コマンドから管理することも、JSON を直接編集することもできます。プロジェクトの性質に合わせて数分かけて設定するだけで、その後のセッション中に承認プロンプトに振り回されることが大幅に減ります。

③ コードを書かせる前に必ず設計させる:常にプランモードから始める

新しいプロジェクトでは、Claude にコードを1行でも書かせる前にまず plan mode へ切り替えるのが鉄則と紹介されています。プランモードは Claude Code のパーミッションモードのひとつで、ターミナル内で Shift+Tab を押すことで出入りできます。このモードでは Claude はファイルの読み取りや読み取り専用シェルコマンドの実行ができますが、コードを編集することはできません。

プランを確認して問題なければ、用途に応じて別のモードへ戻ります。

  • default: ツール使用のたびに初回のみ確認し、回答を記憶する標準モード
  • acceptEdits: ファイル編集および作業ディレクトリ内の一般的なファイルシステムコマンド(mkdirtouchmvcp)を自動承諾するモード
  • bypassPermissions: 一切確認を取らずすべて実行するモード

bypassPermissions については、Anthropic 自身が隔離コンテナや VM 内での実行のみを推奨しており、記事の著者もメインマシンでは使用していないと述べています。同じ姿勢が読者にも推奨されています。

④ 時間半減・機会損失をなくす:タスクに応じて3モデルを使い分ける

Claude Code は Opus・Sonnet・Haiku3モデルから選択できます。多くのユーザーはセットアップ時に一度決めたら以後変更しないものの、それでは Haiku で半分の時間で終わる作業に Sonnet を使ったり、Opus 級の推論が必要なプロジェクトで機会損失を起こしたりすると指摘されています。軽量タスクには軽量モデル、重い推論には強いモデルというだけのことですが、初期設定のままだとこの最適化が走らないわけです。

特に便利な選択肢として紹介されているのが opusplan です。/model opusplan を実行すると、プランモード中は Opus(深い思考が必要なフェーズ)を使い、実装フェーズに移ると自動的に Sonnet へ切り替わります。プランの設計と実装の負荷配分がモデルレベルで自動最適化されるかたちで、設計フェーズに高性能モデルを当てる発想自体が無駄打ちを減らす設計と読めます。

どの設定もセットアップは5分以内——まずは何から始めるか

これら4つの設定は、いずれもセットアップに約5分しかかかりません。一方、効果は以降のセッションすべてで継続するため、設定メニューから得られる投資対効果としては最も大きい部類に入ると評価されています。

具体的な着手順としては、まず新規プロジェクトで /init を実行して CLAUDE.md のたたき台を作り、次に Shift+Tab でプランモードを試して挙動の感触をつかむのが入りやすい流れです。そのうえで /permissions で承認ルールを整え、最後に /model opusplan で設計と実装のモデル振り分けを任せると、4設定が無理なく揃います。Claude Code を本格的に使い始める前、もしくは新しいプロジェクトを開く前に一度だけ向き合っておくのが、その後のストレスを大きく減らす近道と言えそうです。

4つの初期設定の先へ:2026年に追加されたAgent viewと並列サブエージェント

Anthropicは2026年に入り、Claude Codeへ初期設定の範囲を超える新機能を投入しています。claude agents コマンドでは、起動中・ブロック中・完了済みのセッションを1画面に集約するAgent viewが提供されています。/goal は達成条件が満たされるまでターン横断で作業を継続させる新コマンドで、Rewindメニューには「Summarize up to here」で過去文脈を圧縮するオプションも追加されています。

並列サブエージェントを束ねるDynamic workflows

リサーチプレビュー段階のDynamic workflowsは、1セッション内で数百の並列サブエージェントを走らせ出力を検証する仕組みです。claude agents 用フラグとして --add-dir --settings --mcp-config --plugin-dir --permission-mode --model --effort --dangerously-skip-permissions が追加されました。Claude Opus 4.8 が Opus 4.7 と同価格で利用可能になり、Fast modeは既定でOpus 4.7上で動作します。

パーミッション設定をさらに踏み込む:評価順序と「ツール名のみ」denyの落とし穴

パーミッションのallow/ask/denyの3種ルールは並列に評価されるわけではなく、deny → ask → allow の順で評価され、最初に一致したルールが勝つ仕様です。denyが常に最優先で評価されるため、危険操作を確実に止めたい場合の挙動が予測しやすくなっています。

denyは書き方で意味が変わる

denyルールは記述の仕方によって挙動が分かれる点に注意が必要です。

書き方挙動
Bash のようなツール名のみツール自体をClaudeの文脈から外し、存在しないものとして扱う
Bash(rm *) のようなスコープ付きパターンツール自体は利用可能で、マッチした呼び出しだけブロックする

Bashルールはグロブの * を任意位置で使えるため、特定コマンドだけを狙い撃ちで止める粒度の指定もできます。加えてsandboxingというOSレベルの相補レイヤーがBashコマンドのファイルシステムおよびネットワークアクセスを制限し、パーミッションと組み合わせて多層防御を成立させる構造になっています。現状のルール一覧と、それがどのsettings.jsonから読み込まれたかは /permissions で確認できると公式ドキュメントが説明しています。

Q&A

Q. CLAUDE.md には具体的にどんなことを書けばよいですか? 使用している技術スタック、フォルダ構成、すでに採用しているコーディング規約、Claude Code に触ってほしくない範囲などが挙げられています。/init コマンドでたたき台を自動生成し、運用しながら追記していく方法が紹介されています。

Q. --dangerously-skip-permissions を使うのは危険ですか? 記事ではすべての承認を飛ばしてマシン全体を Claude に委ねる選択肢として説明されており、推奨はされていません。代わりに .claude/settings.json で allow / ask / deny ルールを事前定義し、プロジェクトごとに必要な範囲だけ自動承認する方法が現実的だと示されています。

Q. opusplan を使うメリットはどこにありますか? プランモード中は Opus、実装フェーズでは Sonnet が自動的に使い分けられる挙動が紹介されています。深い推論を要する設計フェーズに高性能モデルを当て、定型的な実装は軽量モデルに任せるという発想で、モデル選択の手間と無駄打ちを同時に減らせる点が利点として説明されています。

出典

ポストLINEで送るはてブ
GD

GadgetDrop 編集部

スマホ・PC・AI・XRなど幅広いテクノロジーを、スペックの行間まで読む視点で解説します。速報から深掘り分析まで、テック選びと業界理解に役立つ情報をお届けしています。