最終更新 11月8日 18:55

コードを書き始めた人向け|クロード Codeに最初に頼んでよい作業

コードを書き始めた人が、プログラムのフォルダを直す開発用の画面(クロード Code)に「何から頼んでよいか分からない」という場面から始めます。

本記事では、公式が例示する探索→小さな修正→テスト→説明付きコミットの順を整理します。自然言語で依頼できることは広いですが、初回から大きな機能追加を頼む必要はありません。速度や完成度は、手元の同じ作業の前後で確認します。料金と上限は料金ページで確認します。

次は、頼んでよい作業と後回しにする作業を分け、差分の確認は人が行う前提で進めます。

最初に頼む作業と後回し。後回しにするのは大きな機能追加と一括整理、本番への直接反映と秘密ファイル編集。最初に頼むのは探索と小さな修正、テスト実行と説明付きコミット。
最初に頼む作業と後回し。後回しにするのは大きな機能追加と一括整理、本番への直接反映と秘密ファイル編集。最初に頼むのは探索と小さな修正、テスト実行と説明付きコミット。
目次

最初に頼む作業と後回し

最初に頼むのは、探索と小さな修正、テスト実行、説明付きコミットです。後回しにするのは、大きな機能追加、意味の分からない一括整理、本番への直接反映、秘密情報の入ったファイルの編集です。製品ページは、ローカルで動き、変更やコマンドの前に許可を求めると書いています。

分からない操作は拒否し、小さな範囲に分けてください。一度に全部を頼むより、探索の回答を読んでから次の一文を出す方が、公式の進め方に近いです。

公式が勧める最初の順。1 プロジェクトの役割と入り口を質問して理解する。2 小さな変更だけ頼み確認画面を読む。3 テストがあれば実行し結果を人が見る。4 説明付きコミットまでを責任が持てる範囲で進める。5 同じ訂正が二度出たら指示ファイルへ移す。
公式が勧める最初の順。1 プロジェクトの役割と入り口を質問して理解する。2 小さな変更だけ頼み確認画面を読む。3 テストがあれば実行し結果を人が見る。4 説明付きコミットまでを責任が持てる範囲で進める。5 同じ訂正が二度出たら指示ファイルへ移す。

公式が勧める最初の順

  1. プロジェクトの役割と入り口を質問して理解する
  2. 小さな変更だけ頼み、確認画面を読む
  3. テストがあれば実行し、結果を人が見る
  4. 説明付きコミットまでを、責任が持てる範囲で進める
  5. 同じ訂正が二度出たら、指示ファイルへ移す

公式が最初に勧めるのは、プロジェクトの理解です。「このプロジェクトは何をするか」「使っている技術は何か」「入り口はどこか」「フォルダ構成を説明して」です。開発用の画面は必要なファイルを読むため、手動で文脈を足す必要はありません。

製品ページは、エージェント検索で構成と依存関係を把握すると説明しています。返ってきた説明は、自分でディレクトリを開いて突き合わせてください。探索は編集を伴わないため、許可の判断も少なく、最初の練習に向いています。

向く依頼と向かない依頼。向く依頼は使っている技術とフォルダ構成の説明、メインファイルへの小さな追加、失敗している検査の直しと再実行。向かない依頼は意味の分からない一括整理、秘密情報の入ったファイルの編集、本番への直接デプロイ。
向く依頼と向かない依頼。向く依頼は使っている技術とフォルダ構成の説明、メインファイルへの小さな追加、失敗している検査の直しと再実行。向かない依頼は意味の分からない一括整理、秘密情報の入ったファイルの編集、本番への直接デプロイ。

向く依頼と向かない依頼

向く依頼は、構成の説明、メインファイルへの小さな追加、失敗している検査の直しと再実行です。向かない依頼は、意味の分からない一括整理、秘密ファイルの編集、本番への直接デプロイです。公式の「許可を求める」説明と相性が悪い依頼は、初回には後回しにしてください。

依頼の型 公式の例 人が見る点
定型作業 テスト追加、lint修正、依存更新、リリースノート 実行結果と差分
機能とバグ 欲しい動きを文章で、エラー文を貼る 計画と影響範囲
Git ステージ、コミット文、ブランチ、プルリクエスト メッセージと対象ファイル

概要にある例は、claude "write tests for the auth module, run them, and fix any failures" や、claude "commit my changes with a descriptive message" です。依頼は具体的な方がよい、とクイックスタートは書いています。「バグを直して」より、「誤った認証情報のあと白い画面になるログインを直して」です。

人が残す確認。必ず見るのは差分(変更ファイルと内容。説明できる範囲だけ残す)と実行結果(テストと再現手順。動かない修正は戻す)。
人が残す確認。必ず見るのは差分(変更ファイルと内容。説明できる範囲だけ残す)と実行結果(テストと再現手順。動かない修正は戻す)。

人が残す確認

変更が出たら、差分を読み、テストがあれば公式例どおり実行結果を見ます。コミット文は自分が責任を持てる内容に直します。CI連携やGitHub Actionsは公式に案内がありますが、初回は後回しにしてください。まずはローカルの小さな修正と、説明付きコミットまでにしてください。

テストが無いプロジェクトでは、変更後に自分で再現手順を残してください。再現できない修正は、コミット前に戻します。複数ファイルにまたがる依頼は、先に探索してからにしてください。影響範囲の説明が返ってきたら、その一覧を人が見て、対象外を指示で外します。

依頼文を具体的にする。対象は触ってよいファイルやフォルダ。結果は通したい検査や欲しい動き。禁止は関係ない整理や削除をしないこと。段階は複雑な作業を番号付きに分けること。
依頼文を具体的にする。対象は触ってよいファイルやフォルダ。結果は通したい検査や欲しい動き。禁止は関係ない整理や削除をしないこと。段階は複雑な作業を番号付きに分けること。

依頼文を具体にする

対象、完了条件、やらないことを一文ずつ出します。「全部やって」より、触ってよいファイル、通したい検査、関係ない整理をしない、と書く方が確認しやすいです。複雑な作業は番号付き手順に分ける例が公式にあります。表の作成、API、画面、と段階を踏む書き方です。

先にスキーマや既存実装を分析させてから変更する、という助言もあります。クイックスタートは、斜線(/)で呼び出すコマンドとスキルを出し、Tabで補完、上矢印で履歴、Shift+Tab で許可モードを切り替えると案内しています。最初の週は、この四つと /help だけで足ります。

公式は「同僚に頼むように話す」と書いています。欲しい結果、守る制約、触ってよいディレクトリを一文ずつ出す方が、広い依頼より確認しやすいです。同じ利用枠を会話用の画面と共有します。長い作業の前に料金ページの上限説明を見てください。実測値は自分の利用枠と請求画面で確認します。

最初の一週間の練習メニュー

一日目は探索だけです。二日目は小さな変更一つと確認画面の読み方です。三日目はテスト実行の結果を人が見ます。四日目は説明付きコミットです。五日目は、同じ訂正を指示ファイルへ移すかどうかを決めます。速さの数字より、型を固定する方が、説明できる差分が残ります。

編集ソフトを変える必要はありません。公式は既存のIDEやCLIツールと並べて使えると説明しています。端末、VS Code、JetBrains、デスクトップ、ウェブから選べます。入り口を増やすほど権限管理が増えるため、初回は端末の対話だけで足ります。

よくあるつまずき

  • 初回から大きな機能追加を頼み、影響範囲を追えない
  • 確認画面を読まずに許可し、差分を説明できない
  • テスト結果を見ずにコミットする
  • 同じ訂正を毎回書き、指示ファイルへ移さない
  • 会話用の画面と同じ感覚で、フォルダ全体を一文で任せる

つまずいたときは、依頼を一文に狭め、探索に戻してからやり直してください。

FAQ

最初から機能追加を頼んでよいですか?

公式は探索から始める例を出しています。機能追加は、構成を説明させたあとの方が影響範囲を追いやすいです。

生成コードは必ず動きますか?

保証はありません。公式もテスト実行や確認を作業の一部として例示しています。差分と実行結果を人が見てください。

エディタを変える必要はありますか?

ありません。公式は既存のIDEやCLIツールと並べて使えると説明しています。端末、VS Code、JetBrains、デスクトップ、ウェブから選べます。

コミットまで頼んでよいですか?

公式例にあります。ただしメッセージと対象ファイルは人が責任を持てる内容に直してください。

どのくらい速くなりますか?

速度や完成度は、手元の同じ作業の前後で確認してください。

まとめ

コードを書き始めた人は、探索、小さな修正、テスト、説明付きコミットの順で足ります。大きな機能追加と一括整理は後回しです。差分と実行結果の確認は人が行います。効果を語るときは自社のデータ・期間・担当をそろえます。料金と上限は料金ページで確認します。

迷ったら依頼を狭くし、確認画面を読んでから進めてください。

参考文献

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

この記事を書いた人

コメント

コメントする

目次