Claude Codeの/runと/verify|変更を実物のアプリで確かめる

公開 更新 著者 永上裕之仕事の自動化
AIが作った変更を、実際にアプリを動かして1つずつ確かめているイメージ

この記事の要点

  • /run はアプリを起動して動かし、/verify は変更が狙いどおり動くかをテストに頼らず実物で確かめる
  • 特別な準備の要るアプリは /run-skill-generator で起動手順を1回記録すると、次から迷わず動かせる
  • verify という名前のスキルがあると、コミットの直前に Claude がそれを走らせる(v2.1.286 以降)

AIにコードを直してもらったあと、「テストは通りました」と言われても、画面を開くと崩れていた──そんな経験はないでしょうか。テストや型のチェックが通ることと、実際に使って動くこと は別の話です。

Claude Code には、この「実物で確かめる」作業を任せるためのスキルが最初から入っています。この記事は、公式ドキュメント「Extend Claude with skills」の「Run and verify your app」と「Run your checks before each commit」(2026年11月22日確認)にもとづいて、使い方を手順の形でまとめます。

結論:作ったら /verify、手順が特殊なら一度だけ記録する

/verify は、ビルドしてアプリを動かし、変更が狙いどおりかを確かめるスキル です。公式ドキュメントでは「テストや型のチェックに逃げずに」確かめるもの、と説明されています。

スキル役割
/runアプリを起動して動かし、変更が動いている様子を見る
/verifyビルドして動かし、コードの変更が狙いどおりかを確かめる
/run-skill-generator/run と /verify に、このプロジェクトの起動の仕方を教える

スキルそのものの仕組みは Claude Codeのスキルとは? で解説しています。

変更する・動かす・確かめるの3段階が矢印でつながる流れ図
変更する・動かす・確かめるの3段階が矢印でつながる流れ図(イメージ)

手順1:まずはそのまま /run・/verify を使う

/run と /verify は準備なしで動きます。 プロジェクトの種類(コマンドで動く道具・サーバー・画面で操作する道具・ブラウザで動くもの)と、README や package.json、Makefile の中身から、起動の仕方を推し量ります。

  1. Claude に変更を頼む
  2. 終わったら /verify と打つ
  3. Claude がビルドして動かし、確かめた結果を報告する
  4. 狙いと違う所があれば、そのまま直してもらう

ふつうに起動できるプロジェクトなら、これだけで足ります。

手順2:起動が特殊なら /run-skill-generator で記録する

データベースが要る・環境変数のファイルが要る・画面の環境が要る・ビルドが何段階もある、といったプロジェクトでは、推し量りが当たりにくくなると公式ドキュメントは注意しています。

そういうときは /run-skill-generator を使います。

  1. /run-skill-generator と打つ
  2. Claude が 何もない状態からアプリを動かすところまで を試す
  3. うまくいったやり方(インストールのコマンド・環境変数・起動の手順)を記録する
  4. 記録は このプロジェクト用のスキル として .claude/skills/run-<名前>/ に入り、コミットされる

これ以降は、/run も /verify も、同じリポジトリで動くほかのエージェントも、記録した手順に沿って動きます。毎回、起動のやり方を探し直さなくて済みます。/run-skill-generator はプロジェクトごとに1回、ビルドや起動のやり方が変わったときにもう1回、が目安です。

/verify も自分で手順を残す

/verify は、記録がない状態でアプリをビルドして動かしたとき、うまくいったやり方を .claude/skills/verify/SKILL.md に書き残します。リポジトリの一番上、または複数のパッケージをまとめたリポジトリなら触ったパッケージのフォルダに置かれます。一番上に置かれた記録は、最初から入っている /verify の代わりに使われます。

この記録を Claude が書き直すのは、手順のせいで失敗したとき(コマンドが通らなかった・手順が抜けていた)だけです。毎回の会話で中身が変わることはないので、そのままコミットしておけます。

コミットの前に自動で確かめさせる

セッションの始まりに verify か simplify という名前のスキルがあると、Claude はコミットの直前にそれを走らせます(ドキュメントやテストだけの変更は除く)。これには v2.1.286 以降が必要です。条件は次の3つです。

つまり、一度 /verify に手順を記録させてコミットしておけば、以後は「コミットの前に実物で確認」が自動でつく ということです。

向いている場面・向いていない場面

場面向き不向き
画面の崩れや操作の流れを直したあと向いている(テストでは見えにくい)
社内の小さな道具を作り直したあと向いている
本番のデータに触れないと動かないアプリ注意。試し用の環境やデータで動かせる手順を記録する
文章やドキュメントだけの変更コミット前の自動確認の対象外

アプリの画面まで含めて確かめたいなら、Claude Code Desktop の iOSシミュレーターの画面 や、別のフォルダで並行して試す worktree も組み合わせられます。プルリクエストの段階でもう一度見てもらうなら Claude Codeのコードレビュー が使えます。

よくある質問

/verify とテストの実行は何が違いますか?

テストは書かれた確認項目だけを調べます。/verify は ビルドしてアプリを動かし、変更が狙いどおりに働くかを実物で確かめる ためのもので、公式ドキュメントでもテストや型のチェックに頼らないことが強調されています。両方を使うのが安心です。

記録されたスキルは手で直してもいいですか?

プロジェクトのスキルなので、中身はふつうのファイルです。起動の手順が変わったときは、/run-skill-generator をもう一度走らせて記録し直すのが確実です。

チームの全員に同じ確認をさせたい

記録したスキルをコミットしておけば、同じリポジトリを使う人とエージェントが同じ手順を使います。設定の点検には Claude Codeの/doctor も役立ちます。

まとめ

出典

永上裕之

ユニコスクール株式会社 代表取締役。AIエージェント専門のスクール&コミュニティを運営しています。

この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。

関連する記事