AI Log

ツールガイド / Claude Code / 2 毎日つかう

一般的なワークフロー(Common workflows):不具合の調べ方・作り直し・テストなどの進め方

公式を確かめた日 2026年10月1日(木) / 約8分で読めます

Anthropic の公式の説明(下の「公式のページ」)を、内容を足さずに読みやすい日本語に書き直したものです。公式の翻訳ではなく、Anthropic が作ったものでもありません。公式は予告なく変わるので、使う前に公式のページもご覧ください。

このページで分かること

先に知っておく言葉

作業ごとの指示の順番

公式は、どの使い方(ターミナル・デスクトップアプリなど)でも使える指示の型として、次の順番を挙げています。指示の言葉はプロジェクトに合わせて変えます。例は日本語に言い換えています。

  1. 「このコードの全体像を教えて」と大きく聞く
  2. 作りの考え方・主なデータ・ログイン(認証)の扱い方など、気になる所を順に聞く
  3. 探したい機能があるときは、関係するファイルを探させ、それらがどうつながっているか、たとえばログインの処理が画面からデータベースまでどう流れるかをたどらせる
  1. 「テストを動かすとエラーが出る」とエラーを伝える
  2. 直し方の案をいくつか出させる
  3. 選んだ案で直させる
  1. 古い書き方を使っている所を探させる
  2. 新しい書き方への直し方を提案させる
  3. 動きを変えないことを条件に直させる
  4. 直した所のテストを動かさせる
  1. テストで確かめられていない所を探させる
  2. テストのひな形を足させる
  3. 境目の値など、思わぬ場合のテストを足させる
  4. 新しいテストを動かして、落ちたら直させる

テストについて公式は、Claude が今あるテストのファイルを見て、書き方・道具・確かめ方を合わせる、としています。

コード以外のフォルダでも使える

Claude Code は、どのフォルダでも動きます。メモをためたフォルダや、説明書きのフォルダ、markdown のファイルの集まりでも、コードと同じように探す・書き換える・整理する、ができます。Claude はファイルを使うたびに読み直すので、ほかのアプリで直した中身も、次に読むときには見えています。

画像を渡す

  1. 画像を会話に入れます。やり方は3つです
  1. 「何が写っている?」「このエラーの画面の原因は?」「この見本に合わせた見た目を作って」のように指示します

1つの会話で、いくつもの画像を使えます。

@ でファイルやフォルダを指す

決まった時刻に動かす

どこで動かしたいかで、公式は4つの方法を挙げています。

続ける・並べる・先に計画を見る

公式が挙げている使いどころ

公式のページに書いてあるコツとすすめだけを並べます。

あわせて読む

公式のページ

確認メモ:2026年10月1日に、公式の英語のページと日本語のページを開いて、作業ごとの順番・画像の渡し方・@ の使い方・決まった時刻に動かす4つの方法・続け方と並べ方を突き合わせました。公式のページに更新日の表示は無いため、この日付は「このサイトが確かめた日」です。指示の例の英文そのものは載せず、短い日本語に言い換えました。ターミナルでの細かい操作(フォルダの移り方、プルリクエストに結びついたセッションの探し方、worktree の後片付け、claude -p の出力の形)、言語ごとのコードを読む道具(プラグイン)、大きなリポジトリでの設定、言語を丸ごと移すブログの案内、画像の番号を押して開く操作は、このページには載せていません。「スタックトレース」「テスト」「リファクタリング」「プルリクエスト」の言い換えは公式の用語集に無く、ふつうの意味を一言で添えたものです。「不具合のとき」の「コマンド」は、用語集の Command(/名前 で呼ぶ指示)ではなく、パソコンに打つ命令の意味です。公式の日本語版は、決まった時刻に動かす節の書き出しに英語版に無い「長時間実行される」が入り、/loop の説明から「決まった間隔の」の条件が落ちていたため、英語版に合わせました。