CLAUDEでソフトウェアを構築する

2026年にClaudeをプライマリエンジニアリングコラボレーターとしてソフトウェアを構築することは、コスト曲線とチーム構成を変えるが、根本的なスキルセットは変わらない。ソフトウェアの判断力が必要な部分（何を構築するか、なぜ構築するのか、障害時の動作方法）には依然として人間の注意が必要である。実行部分（コード作成、リファクタリング、ボイラープレート生成、マイグレーション実行）は劇的に圧縮される。どちらなのかを認識することが、2026年における全スキルである。

このガイドは、Seahawk Mediaでカスタム製品を出荷し、HostList.io、gautamkhorana.com、Deluxe Astrologyなどのパーソナルプロジェクトで使用している実際のワークフローである。Claudeのチュートリアルではなく、プロンプトエンジニアリングマニュアルでもない。Claudeをロードベアリングエンジニアとして出荷可能なソフトウェアを生産するプロセス訓練。

ステージ1：構造化ブレーンストーム

コードを書く前に、私はClaudeを使った体系的なブレインストーミングを実施します。プロンプトはこうです：問題を平文で説明する、その答えが設計を変えるような5つの質問をClaudeに表面化させる、それに答える、その後Claudeに得られたプロダクトスペックを200語で要約するよう依頼する。このステージは30分から60分かかり、その後の作業の基礎となる書き出されたスペックを生成します。

ステージ2：技術的決定

スペックを手に、下流での影響が最も大きいアーキテクチャの選択をClaudeに特定させます。データベースの構造、API表面、レンダリング戦略、デプロイメントモデル。各々について、Claudeは2～3つのオプションとそのトレードオフを提案します。私が選びます。決定は同じドキュメントに記録されるため、ビルドフェーズは単一の情報源を持ちます。

ステージ3：スペック駆動実装

コード生成は最後のステージで、スペックが既に完成しているため最も高速です。Claudeはスキーマ、クエリ、コンポーネント、ルート、テストを、大体その順番で書きます。私はすべてのコミットをレビューします。ほとんどのレビューでは小さなリファクタリングまたは見落とされたエッジケースが浮かび上がります。スペックが明確だった場合、全面的な書き直しはめったにありません。

得意な領域

よく知られたパターンでのグリーンフィールドコード：REST API、CRUD管理パネル、認証フロー、ブログエンジン、マーケティングサイト。ターゲットの形が明確に述べられている既存コードのリファクタリング。入出力が明確なコードのテスト生成。スキーマの差分が曖昧でない場合のマイグレーションスクリプト作成。ドキュメント作成のドラフト。症状が再現可能で、トレースがコンテキスト内にあるコードのデバッグ。

得意でない領域

不慣れなドメインでのアーキテクチャの意思決定。サードパーティのAPIドキュメントが不十分である、または最近変更されたインテグレーションコード。ボトルネックが明白でないパフォーマンス最適化。訓練データが限定的な不可解な言語またはフレームワークでのコード生成。要件があいまいで、LLMがあなたの特定のケースにとって間違っている、もっともらしく聞こえるデフォルト値を埋めてしまう何でも。

判断力のギャップ

Claudeは次の行のコードを書く際、中央値のエンジニアより一貫して優れている。次の行のコードが存在すべきかどうかを判断する際、シニアエンジニアより一貫して劣っている。シニアの判断層はあなたがもたらすもの。実行速度はClaudeがもたらすもの。両者の組み合わせはどちらか一方を上回る。

プライマリサーフェスとしてのClaude Code

Claude CodeはAI支援開発のIDEである。プロジェクトコンテキストを一度ロード、ターミナルアクセス、ファイルシステムアクセス、MCPツール統合。2025年にスタックに追加した単一の最高レバレッジツール。ほとんどのエンジニアリング作業は、VS CodeやCursorで直接行うのではなく、Claude Codeで行われるようになった。

直接的なエディタ内編集用のCursor

Cursorは単一ファイルのAI並行作業における最高のエディタ体験。タブ補完、インライン編集、サイドバイサイド差分表示。作業が1～2ファイルに集中している時はCursorを使う。作業がプロジェクト全体に広がる時はClaude Codeに切り替える。

バッチ作業用のAPI経由Claude Sonnet

数百ページのコンテンツをプログラムで生成または書き直す必要がある場合（自動ブログパイプライン、コンテンツ人間化、スキーマ生成）、Claude APIをSonnet経由で直接呼び出す。チャットサーフェスより低遅延、予測可能なコスト、スクリプト可能。特にコンテンツパイプライン向けの適切なツール。

プロンプトエンジニアリング用のOpenAI GPT-4o

2025年末の私の発見は、Kimi、Minimax、またはその他のエージェント向けのプロンプトは、手書きではなく、ClaudeやGPTで作成するのが最適だということでした。目標を説明し、GPT-4oにプロンプトを作成するよう依頼してから、そのプロンプトをエグゼキューターに対して実行します。出力品質は、手動でプロンプトされた同等品よりも著しく優れています。

Kimi ResearcherおよびMinimax Agent

それぞれ、詳細なリサーチと完全なアプリ設計モックアップ。/blog/kimi-minimax-deep-research-design-mockups/ のポストでワークフロー全体をカバーしています。Seahawkでのクライアントリサーチと迅速なプロトタイピングにおける重要なツールです。

小さいコミット、説明的なメッセージ

AI支援開発は大きなdiffを生成する傾向があります。生成されたコード800行を1つのコミットで簡単に配信できるからです。小さなコミットを心がけて自分を律してください。何が変わったのか、そしてなぜ変わったのかを述べるコミットメッセージは、将来のあなたがリグレッションをデバッグするために持つ唯一の成果物です。読みやすくしてください。

コントラクトとしてのテスト

Claudeはコンパイルして実行されるコードを書くことができますが、仕様に暗黙的に含まれていた制約を静かに違反することがあります。これらの制約を実行可能なコントラクトとしてエンコードするテストが、違反を検出します。テストファースト規律は、人間がすべての行を書いていた時代よりも、AI支援時代の方がより重要です。

コードレビューは現在のところ人間のみ

Claudeに自分自身のプルリクエストを承認させません。レビューゲートは人間に残された最も重要な品質管理であり、コードを書いたのと同じモデルにそれを外注すると、目的を打ち消してしまいます。Anthropic SDKおよびClaude Codeワークフローは、AI支援レビューを容易にしますが、最終的な承認は私のものです。

バージョン管理された依存関係とロックファイル

すべての依存関係をピン留めする。ロックファイルを使用する。すべてのビルドで npm audit を実行する。サプライチェーン攻撃の脅威は実在し、AI支援開発は人間が書いたコードより多くの依存関係を追加する傾向にある。パッケージを追加するのは速いからだ。ロックファイルの規律により、その脅威を監査可能な状態に保つ。

Claudeが不適切な5つの決定カテゴリー

そもそも何を構築するか。製品判断は判断力を要する。Claudeが持たないユーザーコンテキストに依存する。あらゆる製品で最も重大な決定だ。ファウンダーとPMがこれを所有する。AIは最大限サポートする立場に過ぎない。

何をローンチするか、何をカットするか。構築中のスコープ決定は常にモデルが見えない制約に帰着する。時間的プレッシャー、チームのモラル、パートナー関係、マーケティングポジショニング。人間として決定する。理由を記録する。その後、決定されたスコープを実行するよう Claudeに依頼する。

失敗モード設計。物事がうまくいかないときにシステムがどう動作すべきかは、事前に仕様化されることはめったにない。本番環境のインシデントのほとんどがここから生じる。失敗モードに不相応な時間をかける。自動的には幸せなパスのコード生成からは浮かび上がらない。

倫理層。構築するものには影響がある。プライバシー、データレジデンシー、アクセシビリティ、環境コスト。これらは人間の決定であり、最適化の出力ではない。設計時に明示的に問う。

長期的な保守性。将来の自分が、将来の Claude が、現在の Claude のコードを読む。これが技術的負債の最深版だ。現在のコードを最適化する際は、人間が読みやすいことを第一に。AI第二に。

ここ12ヶ月間のSeahawkおよび個人的なプロジェクトからの具体例：

HostList.io（Next.js + Supabase上の28,000個のプログラマティックページ）：Claude Codeで5日間にわたってスキャフォルディング、Tavily研究統合を含むコンテンツパイプラインをClaudeで執筆、FALでヒーロー画像生成、スキーママークアップの自動生成。実装に要した時間は3年前の見積もりのおおよそ3分の1。

gautamkhorana.com（このサイト、Astro + Supabase上）：24時間の週末で再構築、Claude Codeが主要な協力者として機能。サイトエディタインターフェース、ブログシステム、スキーマレイヤー、i18nのすべてを生成・レビュー・リファクタリング。このクオリティのパーソナルサイト構築コストが集中した週末のみに低減。

Deluxe Astrologyの自動ブログおよび翻訳パイプライン：Tavily調査からClaudeドラフトからWinstonチェックからFALヒーロー生成からSupabase発行までのループが91,000ページ以上の30言語で毎日実行。パイプライン自体はClaudeが約12時間の集中作業で執筆したおおよそ800行のコード、その大部分は人間のみのチームで1週間かかったであろう。

Seahawkの内部管理ダッシュボード：Minimax Agentが6行の説明から最初のプロトタイプを生成、Claudeが洗練化、1時間で本番展開可能な状態に。「内部ツールが必要」から「内部ツールを使用している」までの時間が数日から1営業日未満に短縮。

2026年のカスタムソフトウェア構築は、実装スピードにおいて1桁の圧縮を実現した一方で、判断の複雑さはほぼ一定のままの職人技である。適応するチームは、より多くの判断（よりよい仕様、よりよいアーキテクチャ選択、よりよい障害モード設計）をもたらし、実装をより多くAIに委譲するチームである。適応しないチームは競争力のあるスピードでソフトウェアを生産するが品質で失う、またはその逆である。

このガイドのすべてのツールを使う必要はない。どの決定が自分のものでどの決定をAIに委譲できるかを知る必要がある。スキルは、ツールチェーンではなく、その境界である。

このコスト曲線でカスタムソフトウェアプロジェクトをシップするのに支援が必要な場合、Seahawk Mediaでプロダクトビルドを実施している。相談は無料、プロジェクト価格は2018年の時給現実ではなくAI支援コスト現実を反映している。