開発環境ガイド

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 が使える

参考

Esc で閉じます