はじめに

Claude Code が Opus 4.7 にバージョンアップしてから、これまでの「丁寧な指示の出し方」が逆に作業効率を落とすケースが増えました。

実務でClaude Code MAXを毎日使い倒している立場（ベンチャーCTOとして10年実装）から、Opus 4.7 移行後に現場でやめた指示パターンを5つ紹介します。

旧モデル（Sonnet 4.x、Opus 4.5/4.6）から乗り換える方の参考になれば。

1. ステップを過剰に分解した「マイクロタスク指示」

Before（旧モデル時代）

1. まず該当ファイルを Read で読んで
2. 次にこの関数を見つけて
3. その関数の引数の型を確認して
4. その上で、こう修正して

旧モデルでは「やるべき手順」を細かく示さないと余計な探索や勘違いが起きやすかった。

After（Opus 4.7）

[ファイルパス]:[行番号] の関数で、引数の型をXに変更してください。
副作用が出る箇所があれば一緒に直してください。

Opus 4.7 は コードベースを自分で読み込んで関連箇所を判断する力 が上がっており、過剰なステップ分解はむしろ思考の邪魔になります。「ゴール」「触っていい範囲」だけ示せば、必要な探索は自分でやってくれます。

2. 「思考プロセスを書いて」指示

Before

作業前に思考プロセスを書いてください。
1. 現状理解
2. 仮説
3. 実行計画
を順に書いてから、コードを書き始めてください。

旧モデルは「いきなりコードを書いて方向性を間違える」ことが多かったため、思考のフレーミングを強制していた。

After

Opus 4.7 は 拡張思考（extended thinking）が標準で挙動に組み込まれている ため、明示的に思考フェーズを書かせる指示は冗長になります。むしろ「コードに集中してください」と書いた方が、出力が読みやすくなります。

3. 「不要な改修はしないで」を細かく書く

Before

- 関係ないファイルは触らないでください
- 既存テストは壊さないでください
- ライブラリの追加は事前確認してください
- リファクタは今回はやらないでください

旧モデルは「ついで仕事」で関係ない場所を変更しがちだったので、ガードレールを大量に書いていた。

After

Opus 4.7 は CLAUDE.md で「Don't add features, refactor, or introduce abstractions beyond what the task requires」のような原則を一度書いておけば、毎回の指示に明示しなくても守るようになりました。

# CLAUDE.md（プロジェクト共通）

## 振る舞いの原則
- 依頼された範囲だけを変更する。リファクタや別箇所の改善は別タスクで提案する。
- ライブラリ追加が必要な場合は、追加前に理由とともに提案する。
- 既存のテストが落ちないことを確認してから完了報告する。

毎タスクの指示文がスッキリし、意思決定の繰り返しを CLAUDE.md 側に集約できます。

4. 「コードレビューをお願いします」と曖昧に投げる

Before

このPR、レビューお願いします。

旧モデルは「全体をなんとなく見て、気付いたコメントを並べる」傾向があり、雑なレビューになりがちでした。

After

Opus 4.7 は 観点を明示するとレビュー品質が劇的に上がる ので、曖昧投げをやめて観点ベースで投げるようになりました。

このPRをレビューしてください。観点は以下：
- セキュリティ（認証ロジック、SQL Injection、XSS）
- 例外系の網羅（外部API失敗、タイムアウト、null安全）
- パフォーマンス（N+1クエリ、不要な再レンダリング）

各観点ごとに「OK / 要修正 / 検討事項」で出してください。

観点を5〜10個渡すだけで、人間レビュアーに近い深さの指摘が返ってきます。

5. 「サブエージェントを使って」と毎回明示する

Before

このタスクは並列に分割できそうなのでサブエージェントを起動して、
A機能/B機能/C機能をそれぞれ別エージェントに割り当ててください。

旧モデルでは並列化の判断を自発的にはしてくれず、毎回明示していました。

After

Opus 4.7 は タスクの独立性を判断して、必要なら自分でサブエージェント（Agent ツール）を起動する ようになりました。

A機能、B機能、C機能を実装してください。
互いに独立しているなら並列に進めてもらって構いません。

これだけで、独立性のあるサブタスクが並列実行され、体感の所要時間が半分以下になることがあります。

まとめ：モデルが上達したら、指示も「抽象度を上げる」

整理すると、Opus 4.7 移行で減らした指示は次の通り：

やめたパターン	代替アプローチ
マイクロタスク分解	ゴール + 触ってよい範囲だけ書く
思考プロセス強制	extended thinking に任せる
毎回ガードレール明記	CLAUDE.md に原則を集約
曖昧なレビュー依頼	観点を明示したレビュー指示
並列化の毎回指示	独立性だけ伝えて自走させる

共通するのは、「人間が代わりにやっていた判断」をモデルに返していく ということです。

モデルが上達するほど、人間の指示は 抽象度を上げる 方向に進化します。逆に旧モデル時代の細かい指示を残したままだと、せっかくのモデル能力を抑え込んでしまうので、定期的な棚卸しが効きます。

この指示設計をベースにした AI×プログラミング学習サポートをMENTAで提供しています → https://menta.work/plan/20251
Claude Code活用の発信は YouTube でも → https://www.youtube.com/channel/UC1rXVD9WYsQPQEWZyd-A1KA/