【事例型】企画がClaude Coworkで要件メモを整えCodeに渡した型（匿名・概念）

AI 技術の進化により、企画者が作成した「要件メモ」をそのままコードへ変換するハードルは劇的に下がりました。しかし、ブラウザ上のチャット AI にコードを書いてもらい、それを手動でコピペしてファイルを作る運用には、限界が見え始めています。特に、既存のファイル群との整合性や、依存関係の解決、そして継続的なメンテナンスにおいて、従来の「コピペ開発」はすぐに破綻します。

そこで注目されているのが、Anthropic が提供するコーディングエージェント Claude Code です。本記事では、企画者が Web 版の Claude で要件を整え、そのメモを Claude Code に渡してリポジトリ上で直接開発を進める「実務直結型」のワークフローを詳解します。

Claude Code が変える企画・開発の境界線

これまで、企画者（非エンジニア）と開発者の間には「仕様書」という名の巨大な壁が存在していました。Claude Code の登場は、この壁を「リポジトリ」という共通言語で取り払う可能性を秘めています。

Web版 Claude と CLI版 Claude Code の決定的な違い

まず整理すべきは、私たちが普段使っているブラウザ版の Claude（Claude.ai）と、ターミナルで動く Claude Code の役割の違いです。

• Web版 Claude (Claude.ai): アイデアの壁打ち、要件の構造化、プロトタイプの検討に最適。ユーザーインターフェースが優れており、思考の整理に向いています。
• Claude Code (CLI): 実際のリポジトリに対して「実行」権限を持つエージェント。ファイルの読み書き、ターミナルコマンドの実行、テストの実施、Git コミット、プルリクエストの作成までを自律的に行います。

企画者が Claude.ai で「こんなツールが欲しい」という要件を Markdown 形式のメモにまとめ、それを Claude Code が読み取ってコードを生成・修正する。この連携こそが、現代的な AI 駆動開発のスタンダードです。

「要件メモ」をリポジトリにコミットする新常識

Claude Code を運用する上で最も重要なのは、企画者が書いた要件メモ（requirements.md など）を、ソースコードと同じリポジトリ内に配置することです。Claude Code はリポジトリ全体をインデックスし、コンテキストとして理解する能力を持っています。メモがリポジトリ内にあることで、「この仕様に基づいて、このファイルを修正して」という指示が極めて正確に通るようになります。

Claude Code 導入のステップバイステップ

Claude Code は、Anthropic が提供する公式の CLI ツールです。利用には Google Cloud や AWS の環境は不要で、Anthropic の API キーがあれば開始できます。

インストールと認証

Node.js 環境（v18以上推奨）がインストールされているターミナルで、以下のコマンドを実行します。

npm install -g @anthropic-ai/claude-code
claude auth login

ブラウザが立ち上がり、Anthropic アカウントでの認証を求められます。認証が完了すれば、あなたのターミナルは「Claude の脳」と直結した開発環境に変わります。

プロジェクト初期化と CLAUDE.md の役割

プロジェクトのルートディレクトリで claude コマンドを叩くと、エージェントが起動します。ここで最初に行うべきは、プロジェクト固有のルールを定義する CLAUDE.md の作成です。

Claude Code は、ディレクトリ内に CLAUDE.md というファイルを見つけると、それを「最優先の指示書」として読み込みます。ここに使用するライブラリ、命名規則、テストの実行コマンドなどを記述しておくことで、エージェントの迷いをなくし、精度の高いアウトプットを引き出すことが可能です。

例えば、経理業務の自動化を検討している場合、楽楽精算×freee会計の「CSV手作業」を滅ぼすアーキテクチャのような、既存のデータ構造やフローに関するドキュメントを docs/ フォルダに入れ、その参照ルールを CLAUDE.md に書いておけば、Claude Code はそれらを前提としたコードを生成します。

【実践】企画メモを Claude Code で「動くツール」に変える運用フロー

それでは、具体的な運用フローを見ていきましょう。ここでは「企画者が新しいデータ変換スクリプトを提案し、Claude Code が実装する」シーンを想定します。

Step 1：企画者が Claude.ai で要件を構造化する

企画担当者は、まずブラウザ版の Claude を使って、やりたいことを整理します。「この CSV の A 列と B 列を結合して、特定の日付フォーマットに変換する Python スクリプトが欲しい」といった曖昧な要望を、Claude との対話を通じて、入出力仕様、エラーハンドリング、バリデーションルールを含む「要件メモ」へと昇華させます。

Step 2：Markdown ファイルとしてリポジトリに配置する

整った要件を docs/requirements/2026-04-feature-A.md のような名前で保存し、Git リポジトリにプッシュ（またはローカルで配置）します。この際、複雑な技術用語は不要です。「期待する動作」が箇条書きになっていれば十分です。

Step 3：Claude Code への「丸投げ」コマンド

エンジニア、あるいは CLI 操作に慣れた実務担当者が Claude Code を起動し、以下のように指示します。

/ask docs/requirements/2026-04-feature-A.md を読み込んで、これに適合するスクリプトを src/scripts/ 内部に作成してください。既存のユーティリティ関数があれば再利用して。

Claude Code はリポジトリ内を検索し、既存のコードスタイルを学習した上で、新しいファイルを作成します。作成後、エージェントは自ら「実行コマンド」を提案し、テストまで行おうとします。

Step 4：Skills 機能を用いた整合性チェック

Claude Code には、特定のタスク（例：複雑なデータ加工や外部 API 連携）をこなすための「Skills」という概念があります。また、既存のドキュメントを読み取らせる能力も非常に高いです。

例えば、Google Workspace × AppSheet の業務 DX ガイドで紹介されているような、スプレッドシート連携の仕様がドキュメント化されていれば、Claude Code は「AppSheet の API 仕様に沿っているか？」をリポジトリ内のドキュメントから自動で判断し、修正案を提示します。

主要 AI ツール比較表：エンジニアリング・エージェント編

Claude Code が他のツールと比較してどこに強みがあるのか、以下の表にまとめました。

※料金の詳細は各公式サイト（Anthropic Claude Code）をご確認ください。

開発効率を最大化する「CLAUDE.md」と「AGENTS.md」の設計

Claude Code を単なる「便利なチャット」で終わらせないためには、設定ファイルの作り込みが不可欠です。

非エンジニアでも書けるプロジェクト・ガイドラインの秘訣

CLAUDE.md は、エンジニアだけのものではありません。ここには「このプロジェクトでは何を成功と見なすか」というビジネスロジックの優先順位を記述できます。

• 「処理速度よりも、エラーログの正確さを優先する」
• 「すべての出力は UTF-8 で統一し、BOM は付けない」
• 「新しい API を作る際は、必ず docs/api/ に Swagger 形式の定義ファイルも更新する」

このような指示を CLAUDE.md に入れておくだけで、Claude Code が生成するコードの品質は劇的に安定します。

複数エージェントを制御するコンテキストの持たせ方

大規模なプロジェクトでは、AGENTS.md というファイルを活用するケースも増えています。これは、Claude Code に対して「あなたは今、セキュリティ監査役として振る舞ってほしい」「あなたはフロントエンドの実装担当だ」といった役割（ペルソナ）を切り替えるための指示書です。複数のエージェントがリポジトリを触るような高度な運用において、役割の衝突を防ぐ重要な役割を果たします。

運用の注意点とセキュリティ対策

Claude Code は強力な権限を持つため、適切なガードレールが必要です。

.claudeignore による読み取り制限

Git における .gitignore と同様に、Claude Code にも見せたくないファイルを指定する .claudeignore を設定しましょう。顧客情報のサンプルデータ、機密性の高い環境変数、巨大すぎるログファイルなどは除外対象です。これにより、意図しないデータ流出を防ぐだけでなく、トークン消費（コスト）の節約にも繋がります。

特に、CAPI と BigQuery を用いたデータアーキテクチャのような、機密性の高いマーケティングデータを扱うリポジトリでは、この設定は必須と言えます。

コスト管理：トークン消費を抑える

Claude Code はリポジトリの構造を把握するために大量のトークンを消費することがあります。不要なディレクトリを読み込ませないよう、指示を出す際は /ask コマンドで対象ファイルを絞り込むか、/compact コマンドで対話履歴を整理する習慣をつけましょう。

まとめ：AI エージェントを「部下」としてリポジトリに迎える

Claude Code の真価は、単にコードを書くことではなく、「リポジトリという文脈を理解し、自律的に動くチームメンバー」になれる点にあります。企画者が Claude.ai で練り上げた構想を、Markdown という橋渡し役を通じて Claude Code に託す。このワークフローを確立することで、開発のスピード感は数倍に跳ね上がります。

まずは小さなスクリプト作成や、既存ドキュメントの整理から Claude Code を導入してみてください。ターミナルの中で AI があなたの指示に従ってファイルを次々と書き換えていく様子を目の当たりにすれば、これまでの開発・企画運用がいかに「摩擦」の多いものだったかに気づくはずです。