Claude Codeで何を頼めばいいか迷ったら|Phase分けで手戻りを減らす使い方

Phaseごとに区切った作業トレイと一時停止の境界を表したアイキャッチ

※本記事はプロモーションを含みます。

Claude Codeを使い始めたころ、私が最初に困ったのは「コマンドが分からない」ことよりも、「何をどこまで頼んでいいのか分からない」ことでした。

会話AIに相談する感覚のまま、やりたいことをまとめて渡すと、画面上ではどんどん作業が進んでいきます。けれど、あとから確認すると、想定していた順番と違っていたり、まだ触ってほしくない場所まで変更されていたりして、結局こちらの確認が重くなっていました。

そこで今は、Claude Codeに仕事を渡す前にChatGPTで要件を整理し、Claude CodeのPlanモードで進め方を確認してから、Phaseに分けて小さく実装してもらう形にしています。

この記事では、日本株チャートツールを作りながら私が変えていった、Claude Codeへの「仕事の渡し方」を整理します。

目次

Claude Codeで最初に困ったのは、操作より任せ方だった

Claude Codeについて調べると、コマンドや設定、便利な機能の話がたくさん出てきます。もちろん、それらを知ることも必要です。

ただ、私が実際につまずいたのは、その少し手前にある「仕事をどう渡すか」でした。

たとえば、日本株チャートツールを作りたいと考えたとき、頭の中にはいくつもの要望が同時にありました。

銘柄を選びたい。チャートを見たい。条件を追加したい。将来的には検証もしたい。

これをまとめて渡しても、AIはそれなりに自然な計画を出してくれます。ただ、この「自然に進んでいく感じ」が、私には少し怖いところでもありました。

私の中では、

  • これはまだ試したいだけ
  • 今回は画面だけ確認したい
  • このロジックは後でよい

といった優先度の違いがあります。

でも、それを伝えなければAIには分かりません。こちらが境界を決めずに渡すと、自分が想定していたより先まで作業が進んでしまうことがあります。

そこで私は、Claude Codeへ最初から大きな完成品を頼むのをやめました。

代わりに、「今回はどこまで進めるか」「何ができたら一度止まるか」「どこで私の判断に戻してほしいか」を先に書くようにしています。

この切り替えをしてから、Claude Codeを「全部作ってくれる相手」ではなく、「決めた範囲の作業を進めてもらう相手」として見やすくなりました。

任せる範囲が広くなるほど、最初に境界線を決めておくことが大事だと感じています。

一度に全部頼まず、Phaseで作業を小さく渡す

今の私がよく使っているのが、作業をPhaseに分ける進め方です。

Phaseという名前自体にこだわりがあるわけではありません。大事なのは、一度の依頼に「設定追加」「ロジック追加」「テスト」「結果確認」を全部混ぜないことです。

私の場合、だいたい次のように分けています。

PhaseAIに頼むこと人間が見ること
Phase 1最小の画面や処理を動かす目的に合う入口になっているか
Phase 2必要な設定や選択肢を追加する条件が増えすぎていないか
Phase 3ロジックや検証処理を足す想定と違う前提で動いていないか
Phase 4テストと結果確認をするこの状態を採用してよいか

これは、きれいな設計書を作るためのものというより、「どこで一度止めるか」を決めるためのメモに近いです。

AIに複数の作業をまとめて頼むと、確認する頃には変更範囲が大きくなっていることがあります。そこで私は、「ここまで来たら一度確認する」という区切りを意識するようになりました。

Phaseを分けておくと、うまくいかなかったときの戻り先も見つけやすくなります。

画面が違うのか。設定が足りないのか。ロジックが違うのか。テスト結果の見方が違うのか。

問題が起きた場所を切り分けやすくなるだけでも、AIへの戻し方はかなり楽になります。

私はClaude Codeに、

  • まずPhase 1だけ進める
  • この段階では保存処理や複雑な条件は入れない
  • 実装前に計画を出して一度止まる

といった形で頼むことが増えました。

完成を急いで一度に進めるよりも、途中で確認できる状態を残したほうが、私の場合は結果的に手戻りが少なくなっています。

日本株チャートツールではPhase 1から確認して進めた

日本株チャートツールを作ったときも、最初から全部をClaude Codeに実装してもらったわけではありません。

まずChatGPTを使って、自分の頭の中にあった「こうなったら便利」という要望を箇条書きに整理しました。

その内容をClaude CodeのPlanモードに渡し、どの順番で作るかを確認します。

ここで、いきなり実装に入らないことが私には大事でした。

コードを変更する前の計画段階であれば、「そこはまだいらない」「先にこちらを確認したい」といった違和感を戻しやすいからです。

実際のPhase 1では、まずチャートを表示する最小限の流れに絞りました。

銘柄を選ぶ。データを取得する。チャートを表示して確認する。

そこへ高度な条件や検証ロジックまで同時に入れてしまうと、動かなかったときに、どこが原因なのか私自身が追いにくくなります。

このときClaude Codeに頼みたかったのは、

「日本株チャートツールを全部作って」

ではありませんでした。

「まずチャート表示までの入口を動かせる状態にする。まだ判断ロジックは入れない。実装前に変更対象を説明する」

というところまでです。

かなり地味な違いですが、私にはこの違いが大きかったです。

AIに任せる作業を小さくすると、私が確認する範囲も小さくなります。確認できる範囲で進んでいると、次のPhaseにも進みやすくなります。

Claude Codeを使うハードルは、機能を全部理解することよりも、「自分が確認できる粒度まで作業を小さく切ること」で下がったように感じています。

エラーは原因を抱え込まず、状態ごとAIに戻す

Claude Codeで作業していると、もちろんエラーも出ます。

日本株チャートツールでは、yfinanceまわりでデータ取得がうまくいかない場面もありました。

以前の私なら、まずエラー文を読んで、自分で検索して、原因を理解してから修正しようとしていたと思います。

今は、最初の動きが少し変わりました。

もちろん、修正内容を採用するかどうかは最後に自分で判断します。ただ、エラーが出たときに原因を最初から全部自分で抱えるのではなく、そのときの状態をまとめてAIへ戻します。

渡すのは、たとえば次のような情報です。

  • 実行した操作
  • 出たエラー全文
  • 期待していた結果
  • 実際に起きたこと
  • まだ変更してほしくない範囲
  • 修正する前に説明してほしいこと

私は「直して」だけでは、なるべく渡さないようにしています。

何をしたら、何が起きて、本当はどうなってほしかったのか。

ここまで渡したうえで、まず原因の候補と修正方針を出してもらいます。

AIにエラーを戻すことで、私が一人で原因を抱え込む必要は減りました。

ただし、AIが出してきた説明や修正案を、そのまま正しいものとして扱うわけではありません。

修正案が出てきたら、私は「どこを変更するのか」「ほかに影響しそうな場所はないか」「何を実行して確認するのか」を見ます。

ここでもPhase分けが役立ちました。

もともとの変更範囲が小さければ、エラー対応によって別の場所まで影響が広がっていないかも追いやすいからです。

AIにエラー対応そのものを丸ごと任せるというより、エラーの状態を整理して渡し、次に見る場所を一緒に絞っていく感覚に近いです。

任せる範囲が広がるほど、人間の判断は前に出す

Claude Codeを使う前は、AIに仕事を任せられるようになれば、自分の作業は単純に減っていくと思っていました。

実際に使ってみると、少し違いました。

コードを書くような作業の一部はAIに任せられます。一方で、人間側の仕事は「仕様を決める」「どこで区切るか決める」「出てきた結果を採用するか判断する」といったところに移っていきます。

私がPhaseを分けているのも、AIを信用していないからではありません。

むしろ、AIへ任せる範囲を広げても、自分が途中で状況を見失わないようにするためです。

どこまで任せるのかが曖昧なままだと、作業が進んだあとに確認する量が増えます。そうなると、結局Claude Codeを使うこと自体が重くなってしまいます。

私の場合、Claude Codeへ渡す前にChatGPTで考えを整理することも増えました。

ChatGPTでは、要件や論点を整理する。

Claude Codeでは、実装計画を確認し、決めた範囲の変更を進めてもらう。

最後に私が、計画や差分、実際の動きを確認して判断する。

この流れにすると、それぞれに何を頼んでいるのかが混ざりにくくなりました。

「Claude Codeで何ができるのか」を最初から全部覚えようとすると、私には少し大変でした。

それよりも、

「次はどこまで頼むか」

「どこで一度止めるか」

「失敗したら何をAIへ戻すか」

から考えるほうが、実際の作業には取り入れやすかったです。

AIに仕事を任せる入口は、うまいプロンプトを一発で書くことではありませんでした。

私の場合は、頼む範囲を小さくして、エラーを一人で抱え込まず、自分が判断する場所を残しておくことでした。

次に詰まりやすい点は初回依頼テンプレートで確認する

ここまで書いてきたのは、Claude Codeの細かな操作手順というより、「どう仕事を渡すか」という話です。

最初に何を頼むのか。どこで止めるのか。エラーが起きたら何をAIへ戻すのか。

このあたりが決まってくると、私はClaude Codeを使いやすくなりました。

一方で、そもそもの初回依頼をどう書くのか、目的や完了条件をどう置くのか、Claude CodeではCLAUDE.mdをどう使うのか、ほかのAI向けにAGENTS.mdを使う場合はどうつなぐのか、といったところで迷うこともあります。

そこは、別の記事で、私が最初につまずいた点と初回依頼のテンプレートを整理しています。

Claude Codeの使い方で最初に決めておきたいこと|始め方で詰まった経験から作った初回依頼テンプレート

今回の記事で扱ったPhase分けは、その次の段階です。

最初の依頼で目的と完了条件を置く。

実際の作業ではPhaseを分けて進める。

エラーが出たら、そのときの状態ごとAIへ戻す。

そして、次に進んでよいかは自分で確認する。

こう考えるようになってから、Claude Codeは「全部を任せる相手」というより、「自分が確認できる単位で仕事を前へ進めてもらう相手」として使いやすくなりました。

私も最初からこの形で使えていたわけではありません。手戻りしたり、エラーで止まったりしながら、少しずつ頼み方を変えています。

今のところ大事だと感じているのは、AIに任せたあとで、人間側が状況を見失わない形にしておくことです。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

東証プライム上場企業で生成AIの開発に携わるAIエンジニアです。

仕事では最先端のAIを扱いながら、日常ではあまり活用できていないことに気づきました。

本当にAIは人生を変えるのか.

それを確かめるため、株式投資や副業、子どもとの遊びなどにAIを取り入れ、暮らしがどう変わるのかを実験・発信していきます。

目次