Claude Code(AIに日本語で頼んで、パソコンの作業を手伝ってもらう道具)で書いたコードを見直してもらうと、本当に危ないバグと、「ここは短く書ける」という整理の提案が、同じ一覧に混ざって出てくることがありました。研修でも「どれから直せばいいか分からない」という声をよく聞きました。
11月19日公開の2.1.328で、この混ざり方が整理されました。この記事では、Claude Codeの/simplifyと/code-reviewが、それぞれ何を受け持つようになったのかを見ます。
2.1.328で変わったこと
更新履歴に書かれた変更は2つです。
/code-reviewは、多くのモデルで、バグとCLAUDE.md(Claude Codeに毎回読ませる決まりのファイル)への違反だけを報告する。共通の部品の使い回し(同じ処理が2か所に書かれていたら1つにまとめる、など)、書き方の簡略化、効率の整理は/simplifyで頼む/code-reviewの指摘には「Important」「Pre-existing」「Nit」のどれかの印が付き、まとめの最後に直し方の案が添えられる。問題がなければ「Code review found no issues.」と出る
「多くのモデルで」とあるので、使っているモデルによっては前の動きのままのこともあります。公式ドキュメントの説明はまだ更新前の書き方なので、今は更新履歴が頼りです。
2つのコマンドの違いを表で見る
/code-review | /simplify | |
|---|---|---|
探すもの | バグ、決まりへの違反 | 使い回せる部品、簡略化、効率、処理を置く場所が適切か |
直すか | 初期は報告だけ。 | 見つけた整理をそのまま当てる |
動き方 | 深さをlowからmaxの5段階で選べる。ultraを付けると、Anthropic側のサーバーで時間をかけて見る | 4つの見直し役が同時に見る |
/simplify は、バグは探しません。公式の説明にも、バグを見つけたいなら /code-review を使うように、とはっきり書かれています。/code-review の詳しい使い方は、前の記事にまとめました。
3つの印の読み方
/code-review の指摘に付く印は、直す順番を決めるのに使えます。更新履歴は印の名前だけを挙げているので、以下の意味は私の読み方です。
- Important 今回の変更で入った、直すべき問題
- Pre-existing 今回の変更の前からあった問題
- Nit 小さな指摘。直さなくても動く
印が付くことで、指摘の数が多くても、全部を読む前に重さの見当がつきます。何も問題がなかったときに、はっきり「問題なし」と言ってくれるのも、地味ですが助かる変更です。これまでは、指摘が出ないと、見直しが本当に終わったのか不安になることがありました。
私は受講者の方に、まずImportantだけを直し、Pre-existingは別の日にまとめて片付ける、と伝えています。今回の変更と関係ない古い問題まで一度に直そうとすると、変更が大きくなり、何が原因で壊れたのか分からなくなるからです。
頼む順番
おすすめは、バグを先に、整理を後に、です。
/code-reviewでバグを探し、Importantを直す- テストを動かして、直したことで別の場所が壊れていないかを確かめる
/simplifyで整理をかける- もう一度テストを動かす
逆にすると、整理で書き換えた部分にバグが紛れ込んだとき、それが整理のせいなのか、もともとあったのかを見分けにくくなります。私も一度、整理を先にかけてから見直しを頼み、出てきたバグの原因を追うのに1時間かかりました。テストの用意がまだの人は、こちらから始めてください。
2.1.328のほかの変更から
同じ版では、ほかにもいくつか変わっています。目に付いたものを挙げておきます。
/bug(不具合の報告を送る命令)が、送る前に確認するようになった- Bedrock(AmazonのクラウドでClaudeを使う窓口)など他社クラウド経由のOpus 4.6とSonnet 4.6でも、オートモードが使えるようになった
- 実験的な機能のCode Modeが速くなった
Code Modeについては、別の記事で入れ方と条件を書きました。
古い使い方をしていた人へ
2.1.147より前は、今の /code-review が /simplify という名前で、見つけた問題をそのまま直す動きでした。自分で作った手順やスクリプト(決まった作業を自動で流す短いプログラム)の中で、バグを見つけるつもりで /simplify を呼んでいる人は、/code-review --fix に置き換えてください。
役割がはっきり分かれたことで、指摘の一覧は短くなります。短くなったぶん、Importantの1行を落ち着いて読む時間が取れるはずです。





