Claude Code を名前だけ聞いたことがある／これから触る、コマンド操作の経験がない人向け
料理ブログのような何かをコードで作りたい・直したいとき、エンジニアにお願いするような感覚で日本語の指示を渡したい場面で使う。ゼロから土台を作る、既存のものに機能を足す、表示が崩れたバグを直す、といった作業をフォルダの中で claude と起動して頼む。1行の言い回し直しやコードの意味を聞くだけならブラウザのチャットで十分なこともある。
Claude Codeは、黒い画面に文字を打ち込んで使うAnthropic公式のAIコーディング道具です。「ログイン機能を直して」「テストを書いて動かして」みたいに普通の日本語で頼むと、コードを読んで、書いて、直して、コマンドを実行して、変更の保存まで一通りやってくれます。プログラミングの作業を、隣の席のエンジニアにお願いするような感覚で任せられる相棒、という立ち位置です。
公式の説明はかなりはっきりしていて、「あなたのコードベース（プロジェクトのファイル全部）を読み、ファイルを書き換え、コマンドを実行し、開発ツールと連携する agentic coding tool」と書かれています。ここで大事なのは「自分で動く」という部分です。1行だけ続きを提案してくれる入力補助とは別物だと思ってください。
噛み砕くと、何をしてくれる道具なの？
イメージとしては、新しく職場に来た優秀なエンジニアに、いきなりプロジェクトのフォルダ一式を渡す感じです。本人が中身を一通り読んで、どこに何が書いてあるか把握して、頼んだ作業を自分で進めてくれます。
たとえば「料理ブログのトップページに新着レシピ一覧を出して」と頼むと、関係するファイルを自分で探して、何ファイルもまたいで書き換えて、最後に動くか確認するところまでやります。私はここが一番ありがたいと思っています。
ファイル1個ずつ手で開いて指示する必要がない。これが効く。
普通のチャットAIとの違いもここです。ブラウザのチャットだと、コードをコピーして貼って、返ってきたコードをまた自分でファイルに貼り戻す往復が要ります。Claude Codeはその往復がなくて、本人が直接ファイルを触ります。
大事な前提：これは「黒い画面」の中で動く道具
Claude Codeの正体を一言でいうと、ターミナルの中で動くプログラムです。ターミナルというのは、文字のコマンドを打ち込んで操作する黒い画面のこと。WindowsでもMacでも標準で入っています。
つまり、アプリのアイコンをダブルクリックして開く普通のソフトとは入口が違います。最初に claude と打って起動して、そこから日本語で会話していく流れになります。ここでつまずく初心者が多いので、先に言っておきます。
ちなみに動く場所はターミナルだけではありません。デスクトップアプリ、ブラウザ、VS Codeの拡張でも同じ中身が動きます。ただ入口ごとの違いは話が長くなるので、別カード「CLI・デスクトップ・Webの違い」に分けてあります。このカードでは「基本はターミナルの中で動くもの」とだけ覚えてください。
「料理ブログ」を例に、頼んでから動くまでを見る
cooking-blog という名前の料理ブログを作る前提で、実際の流れを追います。頭の中で再現できるように、打つ言葉とClaude Codeの反応を順番に書きます。
ステップ1: プロジェクトのフォルダで起動する
まず作業したいフォルダに移動して、claude と打ちます。これでClaude Codeが立ち上がって、会話できる状態になります。
$ cd cooking-blog
$ claude起動の細かい手順やログインのやり方は、別カード「導入とログイン」にまとめてあります。ここでは「フォルダの中で起動する」とだけ押さえてください。
ステップ2: やってほしいことを日本語で書く
起動したら、命令ではなく相談する感覚で頼みます。たとえばこう打ちます。
> このブログにレシピ一覧ページを作りたい。トップから飛べるようにして専門用語を使う必要はありません。「こういうものが欲しい」を普通の言葉で伝えれば伝わります。
ステップ3: Claude Codeがプロジェクトを読む
いきなり書き始めるのではなく、まず今あるファイルを読んで状況を把握します。「トップページのファイルはこれ」「レシピのデータはここに置く形になっている」みたいに、自分で調べてから動きます。ここが入力補助との決定的な差です。
ステップ4: 変更の前に確認を出す
Claude Codeは黙ってファイルを書き換えたりしません。「このファイルをこう変えます、いいですか？」と差分を見せて、こちらの許可を待ちます。ここで初心者がやりがちな勘違いがあります。許可を出さないと先に進まないので、内容を見てOKなら承認する、という一手間が要ります。全自動で勝手に完成するわけではありません。
ステップ5: 実際にファイルを書き換える
承認すると、レシピ一覧ページのファイルを新しく作り、トップページにそこへのリンクを足す、という複数ファイルにまたがる作業を一気にやります。手で1ファイルずつ開く必要はありません。
ステップ6: 動くか確認して、変更を保存する
仕上げに「ちゃんと表示されるか確認して」「ここまでの変更を保存して」と頼めば、確認のコマンドを走らせたり、変更履歴に区切りをつけて保存したりまでやってくれます。最初から最後まで、画面はずっとターミナルの中です。
つまりClaude Codeは何をしてくれるのか
- やってくれる: プロジェクト全体を読んで、複数ファイルをまたいでコードを書く・直す。確認のコマンド実行や、変更履歴への保存まで一通り。
- やってくれない: 許可なしで勝手に全部完成させること。変更ごとに差分を見せて承認を待つので、こちらの判断は必ず挟まります。
- 意味が薄い場面: 1行の言い回しを直すだけ、コードの意味を聞くだけ、みたいな小さな用事。それならブラウザのチャットで十分なこともあります。
使いどころ3シナリオ（具体題材で再現）
シナリオ1: 料理ブログをゼロから立ち上げるとき
cooking-blog のフォルダを作って claude と起動し、「世界の魚料理を紹介するブログの土台を作って」と頼む使い方です。トップページ、レシピ一覧、1記事のページ、という骨組みを複数ファイルでまとめて作ってもらえます。私はこういう「最初の土台づくり」が一番ラクになったと感じています。空のフォルダから形が立ち上がるのは見ていて気持ちいい。
シナリオ2: 既存のブログにあとから機能を足すとき
すでに動いている料理ブログに「レシピを検索できる窓を付けたい」となったとき。関係するファイルを自分で探して、検索の入力欄と動きを足してくれます。どこを触ればいいか分からない状態でも、本人が読んで判断するので、こちらは欲しい機能を言葉で伝えるだけで済みます。
シナリオ3: 表示が崩れたバグを直すとき
「スマホで見るとレシピ写真がはみ出る」みたいな不具合。症状を日本語で伝えれば、原因になっているファイルをたどって、どこが悪いか突き止めて直すところまでやります。エラーの文章をそのまま貼り付けて「これ直して」でも通じます。原因探しを丸ごと任せられるのが大きい。
初心者が踏みやすい落とし穴
- アイコンをダブルクリックで開くソフトだと思ってしまう。Claude Codeはターミナルの中で
claudeと打って起動します。普通のアプリとは入口が違います。 - 全自動で完成すると期待してしまう。変更ごとに差分を見せて承認を待つ仕組みなので、内容を見てOKを出す一手間が必ず要ります。
- ブラウザのチャットと同じものだと思ってしまう。チャットはコードのコピペ往復が必要ですが、Claude Codeは本人が直接ファイルを書き換えます。ここが根本的に違います。
- 空のフォルダで起動して肩透かしを食らう。中身を読んで動く道具なので、まずは「何を作りたいか」を言葉で渡してあげると本領を発揮します。
- 専門用語で頼まないと動かないと思ってしまう。むしろ逆で、「こういうものが欲しい」を普通の日本語で伝えるほうが伝わります。
- 入口の違いで混乱する。ターミナル・デスクトップアプリ・ブラウザ・VS Code拡張のどれでも同じ中身が動きます。どれを選ぶかは別カードで切り分けています。
- 最初の起動とログインで止まる。導入とログインの手順は専用カードにまとめてあるので、まずそちらを片付けてから戻ってくると詰まりません。
書き方
claudeやってみるとこうなる
入力
$ cd cooking-blog
$ claude
> このブログにレシピ一覧ページを作りたい。トップから飛べるようにして出力例
Claude Codeがプロジェクトのファイルを読み、レシピ一覧ページを新しく作り、トップページにリンクを足す変更案を差分で提示。承認すると複数ファイルをまたいで書き換え、表示の確認と変更の保存までやってくれる。このページに出てきた言葉
- ターミナル
- 黒い画面に文字のコマンドを打ち込んで操作する画面。Windowsだと「コマンドプロンプト」「PowerShell」、Macだと「ターミナル」アプリ
- コードベース
- 1つのプロジェクトを構成するファイル全部のかたまり。料理ブログなら、見た目を作るファイルやデータを保存するファイルなどフォルダの中身まるごと
- エージェント
- 頼まれた目的に向かって、途中の手順を自分で判断して動くタイプのAI。調べる・直す・確認するを連続でこなす
- 差分
- 変更の前と後を並べて「ここをこう書き換える」と見せる表示。消える行と増える行が色分けでひと目で分かる
- 変更の保存（区切り）
- 「ここまでの作業を1つの区切りとして記録する」操作。後から「いつ何を変えたか」をたどれる、gitという仕組みの基本動作