AIコーディング入門講座①：Claude Codeの作り直しを防ぐ要件の固め方

Claude Codeで違うものができて2回作り直した末の、要件の固め方です。壁打ちプロンプト4本と導入4手順つき。

「『こんなアプリを作って』と頼んだら、動くものはすぐ出てきた。でも思っていたのと違って、いま作り直している」。そんな状態の方に向けて書いています。

この記事を読むと得られるもの

・Claude Codeで要件を壁打ちするための、コピペ用プロンプト4種類の全文（方法①のステップ1〜4で1本ずつ。ステップ4が、壁打ちの内容を「要件定義書」として一発でまとめてもらうプロンプトです） ・要件定義書を仕様書ファイルとして書き出すプロンプトと、次回以降のセッションに引き継ぐプロンプト ・superpowersの導入コマンドと、/brainstormingスキルの使い方 ・機能追加が続くときに使う、Claude Desktopのプロジェクト活用プロンプト

こんな人におすすめ

・Claude Codeでアプリや業務ツールを作り始めたが、指示の出し方に迷っている人 ・「思っていたのと違うものができる」を繰り返してしまっている人 ・作ったアプリに機能を追加していくたびに、一からアプリの説明をし直すのが面倒な人

こんな人には向いていません

・すでに要件定義書を書き慣れている人 ・ターミナル（文字でコマンドを打つ画面）に一切触れずに済ませたい人（この記事で扱うClaude Codeはターミナルで動く版なので、生成されたコードを動かす操作は出てきます。コードを書くのはClaude Codeで、みなさんではありません）

このシリーズの6テーマ・9記事について

Claude Codeでアプリを作り、公開し、育てていくまでを6つのテーマ・9本の記事に分けて書いています。番号は読む順です。①から順に読むと「作る→直す→公開する→育てる」の流れになります。④⑤⑥は分量が多いので、それぞれ前編・後編の2本に分けてあります。

① 要件定義編 ── 「思っていたのと違うものができる」を、作る前に防ぐ （この記事）
② 計画→実装編 ── 「頼んだのにやってくれない」の正体を知って、Auto Modeに任せる
③ 不具合対応の基本編 ── 直したバグが別の画面で再発するのを止める
④ セキュリティ監査編（前編・後編） ── 動くけれど安全か分からないアプリを、確かめてから公開する
⑤ 技術的負債編（前編・後編） ── 増えたコードのどこが危ないかを、壊さずに洗い出す
⑥ なぜなぜ分析と横並びチェック 完全版（前編・後編） ── 「他に該当なし」でも再発するのを、機械で止める

はじめてアプリを作るなら①→②→③。人に使ってもらう前に④。アプリが育ってきたら⑤⑥へ進んでください。テーマ①〜⑥はどれから読んでも単体で完結します。ただし④⑤⑥の後編は、前編で作ったものを手元に置いて進む前提です。

9本とも、コードを書いたことがない方が読める形にしてあります。④⑤⑥はコマンドの結果を読む場面が出てきますが、打つのはほぼClaude Codeなので、読んで判断できれば足ります（④で自分で打つのは数回だけです）。

9本を通して一貫しているのは、AIの出力をそのまま信じないという姿勢です。要件定義書も、実装も、AIが出したバグや脆弱性の指摘も、要所で人間が確かめます。その確かめ方を各記事で具体的に扱っています。

この記事で扱うのは、Anthropic社のAI開発ツール「Claude Code」です。自分でアプリや業務ツールを作ってみたい、AIコーディング初心者の方に向けて書きました。Claudeのチャットは使ったことがあるけれど、コマンド操作はこれから。そのくらいの状態を想定しています。

Claude Codeに頼んだら、思っていたのと違うものができた

Claude Codeに「こんなアプリを作って」と伝えるだけで、それらしいコードや画面がすぐ返ってきます。落とし穴は、そこです。

わたしが最初に作った備品管理ツールは、2回作り直しました。毎回「だいたいこんな感じで」としか伝えていません。出てくるたびに、前回とは違うものになりました。3回目でようやく、先に要件を書き出してから頼みました。あのとき最初から一問一答をやっていれば、2回分の作り直しは要りませんでした。わたしは、動くものを早く見たくて手順を飛ばす性格です。

心当たりがあるなら、みなさんの指示の出し方が下手なのではありません。「だいたいこんな感じで」で動くものが出てしまう、Claude Codeの速さの側に落とし穴があります。この記事は、その落とし穴を作る前にふさぐ手順です。

なぜ、思っていたのと違うものができるのか

Claude Codeで一番つまずきやすいのは、実はコードの部分ではありません。「何を作りたいかを、Claude Codeに伝わる形で言葉にする」工程、いわゆる「要件定義」です。

指示が曖昧なままだと、Claude Codeは足りない部分を推測で埋めてしまいます。結果として「思っていたのとは違うもの」ができあがったり、あとから機能を追加するたびに仕様がぶれたりします。

なぜ、違うものが出てくるまで気づけないのか。Claude Codeの性質を、先に押さえておきます。

Claude Codeは、日本語で指示を出すとプログラムのコードを書き、動かし、修正までしてくれるAnthropic社のツールです。

ChatGPTやチャット版のClaude（claude.aiのチャット画面）との違いは、パソコンの中のファイルを直接読み書きしながら作業を進める点にあります。プロジェクトのファイル一式を扱いながら対話できるため、要件定義から実装まで一つの流れで進めやすいという特徴があります。

便利なのは、ここです。同時に、落とし穴もここにあります。指示が曖昧でも、足りない部分を推測で埋めて、そのままファイルにします。気づくのは、動かしてみてからです。

「出てきたものを直してもらう」では追いつかない

違うものが出てきたとき、まず思いつくのは「ここを直して」と頼み続けることだと思います。これは途中で行き詰まります。土台になる前提が決まっていないので、直すたびに解釈が変わりうるからです。

もう1つの手は、最初に長い説明を書くことです。わたしの3回目がこれで、うまくいきました。ただし書けたのは、2回の作り直しで要件が固まっていたからです。最初からは書けません。自分の中で決まっていないことは、どれだけ長く書いても書けないからです。「誰が使うのか」「どこまで作るのか」は、聞かれて初めて決まることが多いです。

何を、誰のために、どこまで作るかを決めるのは、依然として人間の仕事です。この最初の工程を丁寧にやっておくかどうかで、その後の完成度もやり取りのスムーズさも大きく変わります。

だからこの記事では、作り直す代わりに、書く前に「聞かれて決める」工程を挟みます。それが壁打ちです。やり方は3つあり、導入のあとの「要件を固める3つのアプローチ」と「どれを選べばいいか」の2章で書きます。その前に、Claude Codeがまだ入っていない方は、導入だけ済ませてください。入っている方は「要件を固める3つのアプローチ」まで飛ばして大丈夫です。

導入は4段階です

利用には、パソコン(MacまたはWindows。Linuxも使えます)とインターネット接続、Anthropicアカウントが必要です。Claude Codeを使うには有料プランが必要で、目安はProプランの月額20ドル程度です。なお、Claude Codeにはターミナルを使わないデスクトップ版もありますが、この記事ではターミナル版を扱います。このシリーズのコマンドとプロンプトがそのまま使えるのが、ターミナル版だからです。

ここが、AIコーディング初心者にとって最初の関門です。逆に言えば、ここさえ越えれば残りは日本語で話すだけ。4段階に分けて、それぞれ「うまくいかないとき」まで書いておきます。

以前はNode.jsという土台を先に入れる手順が定番でしたが、いまは不要です。公式の推奨は、1行で済むインストーラに変わりました。古い記事の手順と混ざらないよう注意してください。

1. ターミナルを開く

ターミナルは、パソコンに文字でコマンドを打つ画面のことです。Macなら「ターミナル」、Windowsなら「PowerShell」という名前で最初から入っています。

Macは⌘＋スペースを押して「ターミナル」と打つと出てきます。Windowsはスタートメニューを開いて「PowerShell」と打ってください。黒い画面か青い画面が開けば、それで合っています。

うまくいかないときは、Windowsの検索窓に「Windows PowerShell」と正式名称で打ち直してみてください。

2. Claude Code本体を入れる

ターミナルに次の1行を貼り付けて、Enterを押します。

Macの場合：

curl -fsSL https://claude.ai/install.sh | bash

Windows（PowerShell）の場合：

irm https://claude.ai/install.ps1 | iex

文字がずらずら流れて、数十秒から数分で終わります。途中で止まったように見えても、待っていて大丈夫です。この方法で入れると、以降の更新は自動で行われます。

入ったかどうかは、ターミナルにclaude --versionと打って確かめます。2.1.211 (Claude Code)のような数字が返ってくれば成功。

うまくいかないときは、まずターミナルを一度閉じて開き直してください。入れた直後は、開いたままの画面に反映されないことがあります。それでもだめなら、エラーの行をそのままコピーして、チャット版のClaude（claude.ai）に「これはどういう意味で、どう直せばいいですか」と貼れば、手順が返ってきます。

3. アプリ用のフォルダを作って、そこへ移動する

この一手間が、あとで効いてきます。Claude Codeは「いま開いているフォルダ」を作業場所として動くからです。この記事で作る要件定義書のファイルも、このフォルダの中にできます。

ターミナルに次の2行を、1行ずつ打ちます。フォルダ名は半角英数にしておくと無難です（例は備品管理アプリの場合）。

mkdir bihin-app
cd bihin-app

mkdirがフォルダを作るコマンド、cdがそのフォルダへ移動するコマンドです。ターミナルを開いた直後は、自分のユーザー名のフォルダ（ホームフォルダ）にいます。bihin-appは、その中に作られます。次回以降も、Claude Codeを使うときはcd bihin-appでこのフォルダに移動してから起動してください。場所が変わると、前回作ったファイルが見つからなくなります。

うまくいかないときは、フォルダ名に日本語やスペースが入っていないかを確認してください。半角英数だけにすると、まず引っかかりません。

4. claudeと打って起動を確認する

最後に、ターミナルで次のように打ちます。

claude

初回はAnthropicアカウントでのログインを求められます。ログインの方法を聞かれたら、Pro／Maxで契約した人は「Claudeアカウント」のほう（Console／API課金ではないほう）を選びます。画面の案内どおりにブラウザで認証すれば、そのまま使えるようになります。「このフォルダを信頼しますか」と聞かれたら、Yesで構いません（画面の文言は変わることがあります）。挨拶を打って返事が返ってくれば、導入は完了です。

終わるときは/exitと打ちます。次に使うときは、ターミナルでcd bihin-appと打ってからclaudeです。この記事で「終了して立ち上げ直す」と書いてあるところは、すべてこの操作のことです。

うまくいかないときは、command not foundと出ていないか確認してください。出ていたら、手順2が最後まで終わっていないか、ターミナルを開き直していないかのどちらかです。まずターミナルを閉じて開き直し、それでもだめなら手順2をもう一度実行します。

なお、インストール手順は変わることがあります。ここで詰まったときは、公式のインストールガイドの最新版もあわせて確認してください。

要件を固める3つのアプローチ

要件定義でつまずかないために、この記事では3つのアプローチを紹介します。

1つ目は、Claude Codeの画面でそのまま「壁打ち」（相手に話しながら、考えを固めていくやり方のことです）をして要件を固め、最後にAIへ要件定義書としてまとめてもらうやり方です。追加のツールは一切不要で、今すぐ試せます。

2つ目は、「superpowers」という拡張機能(プラグイン)を使うやり方です。Claude Code向けに公開されているもので、その中のbrainstormingというスキルを使います。スキルとは、Claude Codeに後から追加できる、作業手順のパッケージのことです。/スキル名と打って呼び出せます。

要件が固まって人間が承認するまでは実際のコード作成に進んではいけない、というルールが仕組みとして組み込まれているのが特徴です。話の途中でAIが先走ってコードを書き始めてしまう失敗を、仕組みの側で防いでくれます。

3つ目は、アプリを作ったあとに機能を追加していく「継続開発」の場面向けです。使うのは、Claude Desktop(いつものチャットのClaudeのアプリ。導入で触れたClaude Codeのデスクトップ版とは別物です)の「プロジェクト」機能です。アプリの前提を毎回説明し直さずに、次の機能の壁打ちを始められます。

どれを選べばいいか

1つ目の方法は、追加の準備がいらず、Claude Codeを起動すればすぐ試せる手軽さが魅力です。ちょっとした業務改善ツールや、まず1つ試作してみたいときに向いています。

2つ目の方法は、準備にひと手間かかります。その分、要件が固まる前にコードを書き進めてしまうのを防ぐ「歯止め」が仕組みとして入っている点が強みです。複数の機能を持つ本格的なアプリを、段階を踏んで作りたい場合に向いています。

最初から二者択一で考える必要もありません。まずは1つ目の壁打ちで「作りたいものの輪郭」をつかみます。本格化してきたら、2つ目の仕組み化されたスキルへ移行。この段階的な進め方も現実的です。

参考までに、わたし自身が実際に使い分けている基準も紹介しておきます。

要件がまだ漠然としているときは、1つ目の壁打ちから始めることが多いです。「何を作りたいかはっきりしないけど、とりあえず話しながら考えたい」という状態ですね。

逆に、ある程度は自分の中で言葉にできているときは、2つ目のsuperpowersを使います。言葉にできている要件なら、そのまま承認ゲート付きの仕様書に落とすのが早いからです。

つまり「要件を自分の言葉にできているか」が、わたしにとっての一番の判断基準です。先ほどの「本格的なアプリは2つ目」という一般論も、突き詰めれば同じ方向です。本格的なアプリほど、仕様書に落とす価値が高いということです。

ここから先で手に入るもの

ここまでで共有できたのは、3つのアプローチの違いと、どれから始めるかの基準です。残るのは「では、最初に何と打てばいいのか」です。

有料エリアでは、3つのアプローチそれぞれの中身を出します。そのままコピーして使えるプロンプトの全文と、具体的な操作コマンドです。わたしが壁打ちを始めるときによく使う、書き出しの一文も載せました。

・方法①の壁打ちプロンプト全文──ステップ1〜4で1本ずつと、ステップ1の別パターン（先に方向性を3つ出してもらう）1本。ステップ4が、壁打ちの内容を要件定義書として一発でまとめてもらうプロンプトです ・要件定義書を仕様書ファイルとして書き出すプロンプトと、次回以降のセッションに引き継ぐプロンプト ・superpowersの導入コマンドと、/brainstormingスキルの流れ ・Claude Desktopのプロジェクトを作る手順3つと、機能を追加するときの壁打ち・まとめ・ナレッジ更新のプロンプト ・よくあるつまずき8つの対処法と、要件が固まったかを自分で確かめる3項目

3本以上読むなら、マガジンのほうが安く済みます

このシリーズは9本（6テーマ）とも有料で、各680円です。9本そろえると6,120円になります。前編・後編も1本ずつ680円です。

マガジン「AIコーディングの開発手法」は1,500円で、このシリーズをまとめてあります。今後追加する回も、追加料金なしで読めます。

3本以上読むつもりなら、マガジンのほうが安いです。この記事1本（680円）で足りるなら、そのまま下へ進んでください。読める中身は同じものです。