Claude Codeの基本的な使い方最初の依頼・承認・差分の確認・やり直し
Claude Codeで、最初の作業を進める手順を整理します。読むだけの質問から始め、小さな変更を依頼し、権限の確認と差分のチェック、テスト、やり直し、会話の進め方まで、安全で実用的な基本の流れを解説します。
公的機関・公式資料などの一次情報と照合して作成しています。このサイトについて
Claude Codeの基本的な使い方とは
Claude Codeを起動したら、いきなり大きな変更を頼まず、段階的に慣れていくのが、基本の進め方です。ここでは、「読む → 小さく変える → 確認する → 記録する」という、安全で実用的な、最初の一連の流れを紹介します。コマンド名・画面の表示は、更新されることがあるため、細かな操作は公式ドキュメントで確認してください(Claude Codeとは)。
ステップ1:読むだけの質問から始める
最初は、ファイルを変更しない、読むだけの依頼で、Claude Codeの動き方を確認します。
| 依頼の例 | 目的 |
|---|---|
| 「このプロジェクトの構成と、主なファイルの役割を説明して」 | コードベースの把握 |
| 「〇〇機能は、どのファイルで実装されていますか」 | コードの探索 |
| 「このエラーメッセージの原因として、考えられるものを教えて」 | 調査の補助 |
Claude Codeは、ファイルを読み、検索して、答えます。どのファイルを読んでいるかが、画面に表示されるので、動き方の理解に役立ちます。
ステップ2:小さな変更を頼む
読むだけの依頼に慣れたら、影響の小さい変更を頼みます。
| 依頼の例 | 内容 |
|---|---|
| 「READMEに、インストール手順のセクションを追加して」 | ドキュメントの編集 |
| 「この関数に、説明コメントを追加して」 | コメントの追加 |
| 「〇〇の変数名を、△△に変更して」 | 小さなリファクタリング |
依頼は、具体的に書きます(Claude Codeへの指示の出し方)。
ステップ3:権限の確認に答える
ファイルの編集やコマンドの実行の前に、許可を求める確認が表示されます(権限設定とパーミッションモード)。
| 選択肢 | 内容 |
|---|---|
| 今回のみ許可 | その1回だけ、許可する |
| 以降も許可(その種類の操作を) | 同種の操作を、今後も許可する |
| 却下 | 実行させない(理由や別の指示を伝える) |
内容を読まずに、許可し続けないことが重要です。特に、コマンドの実行は、何を実行しようとしているかを確認してください。不明なコマンドは、却下して、説明を求めます。
ステップ4:差分を確認する
ファイルが変更されたら、変更内容(差分)を確認します。
| 確認方法 | 内容 |
|---|---|
| 画面に表示される変更内容 | 編集の際に、変更前後が表示される |
| Gitの差分 | git diff などで、変更箇所を確認する(Gitと組み合わせた開発フロー) |
| エディタ・IDEの差分表示 | 視覚的に確認する(IDE連携(VS Code・JetBrains)) |
意図しない変更(関係のないファイルの変更、削除、設定の書き換え)がないかを、確認します。
ステップ5:テストで確認する
変更が正しく動くかは、テストの実行で確認します。
| 方法 | 内容 |
|---|---|
| Claude Codeに、テストの実行を依頼 | 「テストを実行して、結果を教えて」 |
| 自分でテストを実行 | 結果を確認する |
| テストがない場合 | 動作確認の手順を、一緒に考える(テスト駆動の進め方) |
ステップ6:記録する(コミット)
問題がなければ、変更をGitに記録(コミット)します。Claude Codeに、コミットを依頼することもできます。
| 注意点 | 内容 |
|---|---|
| コミットメッセージの確認 | 内容が、変更に合っているか |
| 小さな単位で記録 | 作業の区切りごとに、記録する |
| 機密情報の混入 | 鍵・パスワードが含まれていないか |
やり直し・止め方
| 状況 | 対処 |
|---|---|
| 作業を途中で止めたい | 中断のキー操作(多くはEscキー)で、中断する |
| 変更を元に戻したい | Gitで、変更を破棄する。または、チェックポイントの巻き戻し機能(/rewind)を使う、Claude Codeに元に戻すよう依頼する(仕様は公式で確認) |
| 方向が違う | 指示を修正して、再度依頼する。会話を、整理する |
| 会話が混乱した | 新しい会話を始める(コンテキスト管理(/compact・/clear)) |
作業前に、Gitでコミットしておくと、どんな変更でも、元に戻せる安心感があります。
会話の進め方のコツ
| コツ | 内容 |
|---|---|
| 1回の依頼を小さく | 大きな作業は、段階に分ける |
| 目的と条件を伝える | 何を、なぜ、どんな制約で |
| 例や参照先を示す | 「〇〇ファイルの書き方に合わせて」 |
| 確認を挟む | 計画を先に出させ、承認してから実行(プランモード) |
| 都度、結果を確認 | 次の指示の前に、結果を確認 |
具体例:小さな機能の追加
- 「
utils.jsに、日付をYYYY-MM-DD形式に変換する関数を追加して。既存の関数の書き方に合わせて。」と依頼。 - 変更案が表示される。内容を確認して、許可する。
- 「その関数のテストを書いて、実行して」と依頼。
- テストの結果を確認する。失敗したら、その結果を伝えて修正を依頼する。
- すべて通ったら、差分を確認して、コミットを依頼する。
よくある失敗
| 失敗 | 対策 |
|---|---|
| いきなり大きな変更を頼む | 小さく、段階的に |
| 確認を読まずに許可 | 内容を読む習慣 |
| 差分を見ない | 必ず確認する |
| 作業前に記録していない | Gitでコミットしてから始める |
| 同じ会話を使い続ける | 区切りで、新しい会話にする |
Claude Codeの基本的な使い方のFAQ(よくある質問)
Q. 何を頼めばよいか分かりません。
A. まず、「このプロジェクトを説明して」から始めて、気になった点を深掘りしてください。
Q. 間違った変更をされたら?
A. Gitで元に戻せます。作業前にコミットしておくと安心です。
Q. 毎回、許可を求められて面倒です。
A. 慣れてきたら、安全な操作に限って、許可の設定を調整できます(権限設定とパーミッションモード)。
筆者の見解(Claude Codeの基本的な使い方)
Claude Codeの使い始めは、「新人エンジニアに、最初の仕事を任せる」時の接し方に似ています。最初は、読むだけ、次に小さな変更、慣れたら少しずつ範囲を広げる。そして、成果物は必ず自分の目で確認する。この積み重ねが、信頼と効率の両方を生むと思います。
Claude Codeの基本的な使い方の関連項目
- Claude Codeのインストールと初期設定
- CLAUDE.mdの書き方
- 権限設定とパーミッションモード
- Claude Codeへの指示の出し方
出典(一次情報)
本記事は一般的な情報の提供を目的としています。AIのサービス・機能・料金・仕様は頻繁に更新されるため、最新の内容は各社の公式ドキュメントでご確認ください。「筆者の見解」は一つの考え方です。