CodeCraft Lab

最初のタスクをClaude Codeに頼んでみよう

実際のプロジェクトでClaude Codeを起動し、簡単なタスクを通じて基本的な使い方を体験します

入門13分で読了
基本操作タスク実行入門

このレッスンで学ぶこと

  • プロジェクトフォルダでClaude Codeを起動する方法
  • 自然言語で指示を出し、ファイルの作成・編集・確認を行う方法
  • 権限の確認ダイアログ(パーミッション)の仕組み

前提条件

  • Lesson 1 を完了し、claude コマンドが実行できる状態であること
  • 作業に使えるプロジェクトフォルダがあること(新規でも既存でもOK)

プロジェクトフォルダでClaude Codeを起動する

Claude Codeは、起動したディレクトリをプロジェクトのルートとして認識します。まず、作業したいプロジェクトのフォルダに移動してから起動しましょう。

cd /path/to/your/project
claude

Claude Codeが起動すると、バージョン情報と現在の作業ディレクトリが表示され、入力待ちのプロンプトが現れます。

プロジェクトがない場合

練習用のフォルダを作ってもOKです。以下のコマンドで空のプロジェクトを用意できます。

mkdir my-first-project && cd my-first-project && git init

対話の基本 -- 自然言語で指示を出す

Claude Codeの最大の特徴は、プログラミング言語ではなく普段使っている言葉で指示を出せることです。「この関数を修正して」「テストを書いて」「フォルダ構成を教えて」のように、同僚に頼むのと同じ感覚で話しかけましょう。

指示のポイントは3つあります。

  • 具体的に伝える: 「バグを直して」より「ログイン画面で空のフォームを送信するとエラーになるバグを直して」の方が良い結果になります
  • 段階的に進める: 大きなタスクは一度に頼まず、ステップに分けて伝えましょう
  • 確認しながら進める: Claude Codeが提案した変更は、適用前に確認できます

実践タスク1: プロジェクト構成を聞いてみる

まずは、Claude Codeにプロジェクトの中身を聞いてみましょう。これはファイルの読み取りだけなので、安全に試せます。

このプロジェクトの構成を教えて

Claude Codeはディレクトリ構造を読み取り、使われている技術スタック、主要なファイルの役割などを説明してくれます。もっと深掘りしたい場合は、続けて質問しましょう。

メインのエントリポイントはどのファイル?
依存ライブラリには何が使われている?
ファイルを直接指定するには

@ を付けてファイルパスを書くと、そのファイルの内容をClaude Codeに直接渡せます。例えば @src/index.ts の処理を説明して のように使います。

実践タスク2: 簡単なファイルを生成させる

次に、Claude Codeにファイルを作ってもらいましょう。以下のように指示します。

hello.js というファイルを作成して、"Hello from Claude Code!" と表示するスクリプトにして

Claude Codeはファイルの内容を提案し、書き込みの許可を求めてきます。ここで「権限の確認ダイアログ」が登場します。

権限の確認ダイアログを理解する

Claude Codeがファイルを書き込んだりコマンドを実行したりする前には、必ず許可の確認が表示されます。これはClaude Codeの重要な安全機能です。

確認が表示されたら、以下の選択肢があります。

操作意味
Yesこの1回だけ許可する
Yes, don't ask again for this fileこのファイルへの操作を今後も許可する
Yes, don't ask again for this sessionこのセッション中は同種の操作をすべて許可する
No拒否する
最初は個別に確認しよう

慣れるまでは「Yes」で1つずつ確認するのがおすすめです。Claude Codeの動きに慣れてきたら、セッション単位で許可するなど効率化していきましょう。

ファイルが作成されたら、実際に動かして確認してみましょう。

hello.js を実行して

Claude Codeが node hello.js のようなコマンドを提案し、実行の許可を求めてきます。許可すると、コマンドが実行され「Hello from Claude Code!」と表示されるはずです。

実践タスク3: 既存コードを修正させる

いま作った hello.js を修正してみましょう。

hello.js を修正して、現在の日時も一緒に表示するようにして

Claude Codeは既存ファイルの内容を読み取り、変更箇所を差分(diff)として表示してくれます。変更内容を確認してから許可すると、ファイルが更新されます。

さらに踏み込んだ修正も試してみましょう。

hello.js にコマンドライン引数で名前を受け取る機能を追加して。引数がなければ "World" をデフォルトにして

このように、段階的に機能を追加していく使い方がClaude Codeとの作業の基本パターンです。

指示を出す

やりたいことを自然言語で伝えます。具体的に書くほど、期待通りの結果が得られます。

提案を確認する

Claude Codeが変更内容を表示します。コードの差分や実行するコマンドを確認しましょう。

許可して適用する

問題なければ許可します。想定と違えば「No」を選んで、指示を修正して再度お願いしましょう。

結果を確認する

変更が適用されたら、動作確認をします。「実行して」と頼めばClaude Codeがテストしてくれます。

Claude Codeが得意なこと・苦手なこと

初めて使うときに「何でもできるのでは」と期待しすぎたり、逆に「大したことないのでは」と過小評価したりしがちです。Claude Codeの得意・苦手を理解しておくと、効果的に活用できます。

得意なこと

  • コードベース全体の理解: プロジェクト内のファイルを横断的に読み取り、アーキテクチャや依存関係を把握する
  • コードの生成・修正: 新しい関数やファイルの作成、既存コードのリファクタリング、バグ修正
  • テストの作成: 既存コードに対するユニットテストやテストケースの自動生成
  • ドキュメント作成: READMEやコードコメント、API仕様書の生成
  • Git操作: コミットメッセージの生成、プルリクエストの作成、差分の要約
  • デバッグ支援: エラーメッセージの解析、原因の特定、修正案の提示

苦手なこと

  • リアルタイム情報の取得: 最新のニュースや現在のAPIステータスなど、外部への問い合わせが必要な情報
  • GUIの操作: ブラウザのボタンをクリックしたり、デスクトップアプリを操作すること
  • 大量のファイルの同時変更: 一度に数十ファイルを変更するような大規模な作業は、段階的に分けた方が確実
  • プロジェクト固有のルールの把握: 初回セッションでは、チーム独自の規約やルールを知りません(これはLesson 4で学ぶCLAUDE.mdで解決できます)

セッションの終了方法

作業が終わったら、以下のいずれかの方法でClaude Codeを終了できます。

方法説明
/exitスラッシュコマンドで終了
Ctrl + Dショートカットキーで終了
Ctrl + C を2回強制終了(処理中の場合)
セッションは自動保存されます

Claude Codeとの会話はローカルに自動保存されます。次回 claude --continue で起動すると、前回の会話の続きから再開できます。途中で終了しても作業内容が失われることはありません。

よくある質問

Q: Claude Codeが勝手にファイルを書き換えることはありますか?

いいえ、ありません。Claude Codeはファイルの変更やコマンドの実行前に必ず許可を求めます。許可しない限り、プロジェクトに変更は加えられません。

Q: 日本語で指示を出しても大丈夫ですか?

はい、日本語で指示を出せます。Claude Codeは日本語を理解し、日本語で応答します。コードのコメントやコミットメッセージも日本語で生成するよう指示できます。

Q: 間違った変更が適用されてしまったらどうすれば?

Gitを使っていれば git checkout -- ファイル名 で変更を取り消せます。Claude Codeに「さっきの変更を元に戻して」と頼むこともできます。

まとめ

このレッスンでは、以下のことを体験しました。

  • プロジェクトフォルダでClaude Codeを起動する方法
  • 自然言語で指示を出してプロジェクト構成を確認する方法
  • ファイルの新規作成と既存ファイルの修正を依頼する方法
  • 権限の確認ダイアログの仕組みと安全な使い方
  • Claude Codeの得意なこと・苦手なこと
  • セッションの終了と再開の方法

Claude Codeとの対話は、「指示 → 確認 → 許可 → 検証」のサイクルが基本です。このパターンに慣れれば、より複雑なタスクも安心して任せられるようになります。

次のステップ

次のレッスンでは、Claude Codeのスラッシュコマンドやショートカットなど、操作を効率化するための基本コマンドを学びます。

Lesson 3: 知っておきたい基本コマンドとショートカット に進みましょう。