Claude Codeで開発する
Claude Codeの基本操作
起動のしかた、頼み方、確認のしかた、よく使うコマンドを整理します。
Claude Code を、日々の開発で使うための基本操作をまとめます。ここでの操作は、ターミナル版(claude コマンド)を前提にしています。VS Codeのパネルでも、考え方は同じです。
起動する
作業するプロジェクトのフォルダへ移動して、claude を実行します。
cd ~/projects/my-app
claude
Claude Code は、起動したフォルダの中のファイル を読んで作業します。そのため、プロジェクトのフォルダで起動するのが基本です。
頼み方の基本
普通の日本語で、「何をしてほしいか」を書きます。
このプロジェクトは何をするものですか?
README に、インストール方法を追記してください
ログイン画面で、パスワードが空のまま送信できてしまいます。直してください
コツは、具体的に書く ことです。
| あいまいな頼み方 | 具体的な頼み方 |
|---|---|
| バグを直して | ログイン後に画面が真っ白になる。入力を間違えたときの処理を確認して直して |
| テストを書いて | calc.py の割り算で、0で割る場合のテストを書いて。モックは使わないで |
| 見た目を良くして | トップページのボタンの余白を広げて、スマホでも押しやすくして |
ファイルを指定したいときは、@ に続けてファイル名を書きます(例: @src/index.js)。
確認と承認
Claude Code は、ファイルを変更したり、コマンドを実行したりする前に、許可を求めます。内容を読み、問題なければ許可します。どの操作を確認なしで進めるかは、権限モード で決まります。
| モード | 動き |
|---|---|
Manual(default) | ファイルの編集やコマンドの実行のたびに、確認する |
acceptEdits | ファイルの編集は確認せず、それ以外は確認する |
plan | ファイルを変更せず、調査と計画だけを行う |
auto | 背景で安全確認をしながら、確認なしで進める |
セッション中に Shift + Tab を押すと、モードが切り替わります。画面の下に、いまのモードが表示されます。
起動したときのモードは、Claude Code のバージョンや設定によって違います。最近のバージョンでは、auto で始まることがあります。最初に、画面の下に表示されているモードを確認してください。
慣れないうちは、変更を1つずつ確認できるモードで使い、内容を読む習慣をつけるのがおすすめです。起動時に claude --permission-mode plan と指定すると、計画モードで始められます。
作業中の操作
| やりたいこと | 操作 |
|---|---|
| 作業を止める | Esc |
| 直前の変更を元に戻したい | Esc を2回押す、または /rewind |
| 話題を変える前に、会話をリセットする | /clear |
| 使えるコマンドを見る | /help または / と入力 |
| 前の会話を選んで再開する | /resume(起動時なら claude -r) |
| 直近の会話を続ける | 起動時に claude -c |
| 終了する | /exit または Ctrl + D を2回 |
| 命令の履歴をたどる | ↑ キー |
Esc で止めても、それまでの会話は残ります。方向を変えたいときに、途中で止めて指示し直せます。
会話の長さに気をつける
Claude Code は、会話が長くなると、前の指示を忘れたり、間違いが増えたりします。次のことを心がけます。
- 関係のない作業に移る前に、
/clearで会話をリセットする - 同じ間違いを2回以上直しても直らないときは、
/clearして、学んだことを含めた具体的な指示で、やり直す - 調べ物が大きいときは、「調査はサブエージェントにやらせて」と頼む
1回だけ質問して終わる
対話画面を開かず、1回だけ質問して結果を表示するには、-p を付けます。
claude -p "このプロジェクトの構成を説明して"
確認する
-
claudeを起動して、質問に答えてもらえた - 変更の許可を求められ、内容を見て承認できた
-
Shift + Tabで、権限モードが切り替わるのを確認できた -
/clearと/exitが使える