Claude Codeで作ったものが、本当に正しく動いているのか。研修で一番多い質問の1つです。

11月16日、Claude Codeを作っているチーム自身が、この問いへの考え方をブログで公開しました。書いたのはAnthropicのAddy Osmani氏です。チームのコードの約9割はClaudeが書き、Claudeが見直しているそうです。そのチームがどうやって品質を保っているのか。この記事では、Claude Codeの検証の考え方を、非エンジニアでも真似できる部分に絞って読み解きます。

検証があるから、任せる量を増やせる

ブログの出発点は単純です。確かめる仕組みがないと、人は1つか2つのClaudeしか動かせない。全部を自分の目で見ないといけないからです。確かめる仕組みが信頼できれば、別々の作業を、何十ものClaudeに同時に任せられる。

つまり検証は、ブレーキではなくアクセルだ、という考え方です。これは私の研修での実感とも合います。受講者の方が「Claude Codeは怖くて任せられない」と言うとき、原因はたいてい、出来上がったものを確かめる方法を持っていないことです。

力を入れる3種類のテスト

テストは、作ったものが期待どおりに動くかを自動で確かめる仕組みのことです。ブログは3種類を挙げています。

種類

何を確かめるか

例

E2E(端から端まで)テスト

利用者の操作の流れが最後まで通るか

カートに入れる、支払う、確認画面が出る

性質のテスト

「どんな入力でも必ず成り立つこと」が崩れないか

口座の残高が決してマイナスにならない

差分のテスト

古い仕組みと新しい仕組みに同じ入力を与えて、結果が同じか

古い集計表と作り直した集計表に同じデータを入れ、合計が一致するか

1つだけ選ぶならE2Eテスト、とブログははっきり書いています。ごまかしが効きにくく、失敗したときに画面の写しと、どこで止まったかが残るからです。Claudeにアプリを起動させ、操作させ、結果を見させるためのスキル(Claude Codeに覚えさせる決まった手順)を用意しているそうです。

自分の作ったアプリでE2Eテストを試すなら、Claude Codeに「画面を開いて、ログインして、一覧が出るまでを確かめるテストを書いて」と頼むところから始められます。テストを書かせる基本は、こちらの記事にあります。

プログラムを書かない人でも考え方は同じです。Claude Codeに作らせたExcelの集計の道具なら、手で計算した3件と結果が合うかを、直すたびに確かめる。これが小さなE2Eテストです。

チームの決まりで真似しやすいもの

ブログには細かい決まりがたくさん出てきます。その中から、個人や小さなチームでも真似しやすいものを選びました。

  1. コミット(変更を記録する単位)の前に、Claudeが「verify」という確認のスキルを通す(通していないコミットを止める仕組みもある)
  2. 確認に落ちたら、Claudeが直す。3回直しても通らなければ人に回す
  3. Claudeが、合否を判定する条件(テスト)のほうを勝手に甘くできないようにする
  4. どの方法で確かめたかを、コミットに書き残す。確かめていなければ「なし」と書く
  5. たまに失敗するテストを、やり直しで通したことにしない。原因が分からなければ消して、理由を書く

私がいちばん効くと思うのは3つ目です。Claudeにテストを通すよう頼むと、コードではなくテストのほうを甘くしてしまうことがあります。私も一度、テストが全部通ったと報告されて喜んだら、確かめる条件のほうが書き換えられていた、という失敗をしました。

見直し役は増やさず、1つを育てる

コードの見直しについても、面白い考え方が書かれています。見直し役のClaudeを何人も重ねるのではなく、1つの見直し役を、REVIEW.mdという決まりのファイルで育てる、というものです。

しかも、見直し役が読むREVIEW.mdは、変更を加える前の、チームの正式な版のものです。変更の中で決まりを書き換えて、見直しをすり抜けることができない作りになっています。

なお、REVIEW.mdを読むのは、GitHubの変更の提案(プルリクエスト)を見る管理型のCode Reviewです。手元で使う /code-review はREVIEW.mdを読まず、CLAUDE.mdの決まりに従います。手元の見直しの機能の使い方は、こちらの記事にまとめています。

見直し役も見直す

最後に、見直し役そのものの成績を測る話が出てきます。あとで取り消された変更や、人が却下した変更を集めて、見直し役が見逃していなかったかを確かめます。見逃しが2つ以上の変更でくり返し出たら、新しい決まりにする候補にします。

ここまでやるのは大きなチームだけだと思うかもしれません。ただ、「Claudeが見逃したものをメモしておき、同じものが2回出たらCLAUDE.md(Claude Codeに毎回読ませる決まりのファイル)に書く」くらいなら、今日から一人でもできます。

明日から変えること

このブログを読んで、私が研修の中身に足そうと決めたのは2つです。完成を報告されたら、まず「どうやって確かめたか」を聞くこと。そして、確かめる仕組みの変更は、人が見てから入れること。

Claude Codeに任せる量を増やしたい人ほど、先に確かめる仕組みに時間をかけてください。それが結局、一番の近道です。