Claude Cowork とClaude Code 企画がCoworkで起票しエンジニアがCodeで実装する流れ(概念)

この記事をシェア:
目次 クリックで開く

プロダクト開発において、企画者が作成した要件定義書と、エンジニアが書くコードの間に「乖離(ギャップ)」が生じるのは永遠の課題でした。ドキュメントは古くなり、コードの意図を読み解くのに時間がかかる。この摩擦をゼロに近づける回答が、Anthropic が提供する Claude CoworkClaude Code の組み合わせです。

本記事では、企画者が Claude Cowork で起票し、エンジニアが Claude Code(CLI)を用いてリポジトリ上で実装・検証・デプロイ準備までを完結させる、次世代の「AI ネイティブな開発運用」について、実務レベルの具体策を徹底解説します。

1. Claude Cowork × Claude Code が変える開発の「重力」

これまでの開発フローは、Slack での相談、Jira での起票、そして IDE での実装というように、ツール間を人間が「翻訳」しながら行き来するものでした。しかし、Anthropic のエコシステムはこの境界線をなくします。

企画から実装へ:なぜこの組み合わせが最強なのか

Claude Cowork は、チーム全体のナレッジを共有し、プロジェクトの「意思(何を作るか)」を管理する場所です。対して Claude Code は、ローカルのリポジトリに直接アクセスし、プロジェクトの「実体(どう作るか)」を操作する CLI ツールです。

この両者を繋ぐことで、「ドキュメントの指示をそのままコードに変換し、コードの修正結果をそのままドキュメント(Cowork)へフィードバックする」という、双方向の同期が可能になります。これは単なるコード生成を超えた、自律的なエージェントワークフローの構築を意味します。

2. 役割定義:企画者の Cowork、エンジニアの Code

効率的な運用の第一歩は、両ツールの責務を明確に分けることです。

Claude Cowork:共有コンテキストとマイルストーンの管理

Claude Cowork は、非エンジニア(PdM や経営層)とエンジニアが対話する「コックピット」です。ここでは、ビジネスロジックの整理や、開発の優先順位付けを行います。Cowork 内にリポジトリのドキュメントや過去の設計思想をインデックスさせることで、AI は常に「背景」を理解した状態で提案が可能になります。

Claude Code:リポジトリ直結型のコーディングエージェント

エンジニアがターミナルから起動する Claude Code は、ファイル操作、ビルド、テスト実行、git 操作までをこなす強力な CLI です。Cowork で決まった「仕様」をコンテキストとして受け取り、既存のディレクトリ構造やコード規約を守りながら、実際の差分(diff)を作成します。

【比較表】Claude Cowork と Claude Code の機能・責務の違い

機能・特徴 Claude Cowork Claude Code (CLI)
主なユーザー層 PdM、企画、全メンバー エンジニア、実務担当者
インターフェース Web ブラウザ UI ターミナル (CLI)
主な役割 要件定義、タスク起票、合意形成 コード修正、テスト実行、PR作成
リポジトリ操作 不可(ドキュメントベース) 可能(直接編集・実行)
料金体系 月額サブスクリプション(組織) API トークン従量課金

企業の DX 推進においては、企画段階で高額なツールを導入する前に、まず現行プロセスの負債を整理することが重要です。例えば、経理業務の自動化を検討する場合も、ツールの選定以前に「業務の設計図」が必要です。関連記事:楽楽精算×freee会計の「CSV手作業」を滅ぼす。経理の完全自動化とアーキテクチャ では、業務フローの再設計による効率化を解説していますが、Claude Cowork もまさにこの「設計」の場として機能します。

3. Claude Code のセットアップとリポジトリ制御

Claude Code を実務で使いこなすには、単にツールをインストールするだけでなく、エージェントに「このプロジェクトのルール」を教え込む必要があります。

CLI のインストールと認証

まずは Node.js 環境(v18以上推奨)で以下のコマンドを実行します。

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

ログイン後、プロジェクトのルートディレクトリで claude コマンドを叩けば、エージェントとの対話が始まります。

プロジェクトの憲法:CLAUDE.md と AGENTS.md

Claude Code は、ディレクトリ内に特定の Markdown ファイルが存在すると、それを「命令セット」として読み込みます。これが、AI の振る舞いを制御する鍵です。

  • CLAUDE.md: プロジェクトの技術スタック、コーディング規約、テストの実行コマンド、デプロイフローなどを記述します。Claude Code はコードを書く前に必ずこのファイルを参照します。
  • AGENTS.md: より詳細な「役割(Role)」や「サブエージェント」への指示を記述します。例えば「セキュリティ担当エージェント」としての振る舞いや、「UI/UX 担当」としてのチェックリストを定義できます。

.claudeignore によるスキャン範囲の最適化

Claude Code はリポジトリ全体を把握しようとしますが、node_modules や巨大なバイナリ、ログファイルなどはインデックスに含めるべきではありません。.gitignore と同様に .claudeignore を設定し、読み取り範囲を絞り込むことで、トークン消費(コスト)を抑え、レスポンスの精度を高めることができます。

4. 実務ワークフロー:企画を起票し、Code で実装する 5 ステップ

それでは、具体的な運用の流れを見ていきましょう。今回は「既存のデータ基盤に新しい連携 API を追加する」というシナリオを想定します。

Step 1:Cowork で要件定義と Task の作成

PdM は Claude Cowork 上で、実装したい機能の概要を伝えます。「LINE のリッチメニューを動的に切り替える API を実装したい。認証は既存の Cognito を使い、データは BigQuery から取得する」といった具合です。Claude Cowork はこれを受け、必要な Task 一覧や、システム構成のドラフトを作成します。

Step 2:Task 詳細を Markdown 出力しリポジトリへ配置

ここが連携の肝です。Cowork で合意された仕様を docs/requirements/new-feature.md のようにリポジトリ内にファイルとして保存します。これにより、ローカルで動く Claude Code がその「最新の正解」を直接読み取れるようになります。

Step 3:Claude Code による既存コードの読み取りと編集

エンジニアはターミナルで Claude Code を起動し、指示を出します。

「docs/requirements/new-feature.md を読んで、既存の API エンドポイントを参考に新しいコントローラーを作成して。認証ロジックは src/auth にあるものを再利用すること」

Claude Code はリポジトリ内を検索(Grep)し、既存のコードパターンを学習した上で、新しいファイルを生成・編集します。

データ基盤との連携においては、特にアーキテクチャの整合性が問われます。関連記事:LINE データ基盤から直接駆動する「動的リッチメニューとキャンペーンモジュール」のアーキテクチャ で触れているような高度な連携ロジックも、Claude Code に既存のディレクトリ構造を読み込ませることで、一貫性を保ったまま実装可能です。

Step 4:テスト実行とスクリプト生成による自動検証

Claude Code はコードを書くだけではありません。CLAUDE.md に記述されたテストコマンドを理解し、自らテストを実行します。

  • npm test を実行し、エラーが出ればその内容を解析。
  • 不足しているテストケースがあれば、テストコード自体を生成。
  • 必要に応じて、データ移行用のスクリプトやダミーデータ生成スクリプトも作成します。

Step 5:プルリクエストの作成と非エンジニアによる確認

実装が完了したら、Claude Code に git 操作を依頼します。

claude "修正内容を git commit し、PRを作成して。タイトルと概要は Cowork の仕様に基づいて分かりやすく書いて"

作成された PR へのリンクを Claude Cowork に共有すれば、企画者はブラウザ上で進捗を確認できます。ここで「実際の挙動がイメージと違う」となれば、再び Cowork で議論し、その修正指示をエンジニアが Code に伝えるというサイクルが回ります。

5. 非エンジニアとエンジニアの境界線を溶かす「共通言語」運用

この運用の最大のメリットは、「非エンジニアが AI を通じてリポジトリのルールを間接的にコントロールできる」点にあります。

Skills / サブエージェントを活用したドキュメント自動更新

Claude Code には「Skills」という拡張機能的な概念があります。例えば、コードの変更に合わせて自動的に Swagger(APIドキュメント)を更新したり、ER図の Mermaid 記述を書き換えたりするスキルを AGENTS.md で定義しておけば、ドキュメントの形骸化を完全に防ぐことができます。

業務システムの全体設計においても、この「ドキュメントと実体の同期」は極めて重要です。関連記事:【図解】SFA・CRM・MA・Webの違いを解説。高額ツールに依存しない『データ連携の全体設計図』 で示すような複雑なシステム相関図も、Claude Code に現状のコードから最新の状態を抽出させることで、常に正確な「設計図」を維持できます。

6. 導入時の注意点とセキュリティ管理

強力なツールゆえに、運用上のガードレールが必要です。

ローカル実行における承認フロー

Claude Code はデフォルトでユーザーに許可を求めますが、--dangerous フラグを使用すると、確認なしでコマンドを実行できてしまいます。企業のセキュリティポリシーに応じて、以下の運用を徹底してください。

  • –readonly モードの活用: コードの分析や読み取りだけを行いたい場合は、読み取り専用で起動する。
  • 本番環境キーの隔離: .env ファイルなどは .claudeignore に含め、AI が直接本番のクレデンシャルに触れないようにする。

API コストの管理とトークン節約術

Claude Code は Anthropic の API を直接消費します。大規模なプロジェクトで claude "プロジェクト全体をリファクタリングして" といった曖昧かつ広範囲な指示を出すと、一気にトークンを消費します。指示は常に具体的かつ小分けにし、コンテキスト窓を無駄に広げない工夫(不要なファイルを読み込ませない)が必要です。

7. まとめ:AI ネイティブな開発文化への移行

Claude Cowork と Claude Code の連携は、単なるツールの導入ではなく、開発プロセスのパラダイムシフトです。企画者が「起票」した瞬間に、実装への道筋が AI によって舗装され、エンジニアは「CLI との対話」を通じて、より本質的な設計や問題解決に集中できるようになります。

このフローを自社の開発プロセスに組み込むことで、ドキュメント作成のオーバーヘッドを削減し、コードの品質とデプロイ速度を劇的に向上させることが可能です。まずは小さな社内ツールや、特定のサブモジュールから Claude Code による開発を試してみることをお勧めします。

より詳細な技術仕様や最新のアップデートについては、Anthropic 公式ドキュメントを随時確認してください。AI と人間がシームレスに共創する未来は、すでにあなたのターミナルから始まっています。

導入前に押さえておきたい実務上のチェックリスト

Claude Cowork と Claude Code を実務に投入する際、多くのチームが直面する「運用コスト」と「権限設計」のギャップを埋めるための補足事項をまとめました。

1. 料金体系とコスト管理の「落とし穴」

既存の本文でも触れた通り、Claude Cowork は組織単位の月額サブスクリプションですが、Claude Code は Anthropic API(主に Claude 3.5 Sonnet)の従量課金で動いています。大規模なリポジトリで不用意に「全体を修正して」といった広範な指示を出すと、1回のリクエストで数ドルのコストが発生する場合もあります。初期導入時は、以下の設定を強く推奨します。

  • 予算アラートの設定:Anthropic Console(https://console.anthropic.com/)にて、月間の利用上限額を設定する。
  • .claudeignore の徹底:不要な画像、バイナリ、ビルド成果物を除外し、AIが読み取るトークン量を最小化する。

2. 権限管理とセキュリティの役割分担

Claude Cowork は Web UI 上でナレッジを共有するため、機密情報のインデックス範囲に注意が必要です。一方、Claude Code は「実行者のローカル権限」を引き継ぎます。以下の比較表を参考に、責務の境界線を設定してください。

管理項目 Claude Cowork(組織) Claude Code(ローカル)
ソースコード参照 同期したドキュメント/スニペットのみ リポジトリ全体(ローカル環境)
DB・外部API実行 不可 可能(開発者の権限範囲内)
認証情報の保護 サービス側で管理 .env 等の除外設定が必要(要確認)

3. AIネイティブなデータ活用への拡張

この開発フローが定着すると、次は「AIが参照するデータの鮮度」が課題となります。例えば、MAツールの代わりとしてデータ基盤を構築する場合、AIエージェントが最新の顧客行動ログを参照できる状態が理想です。関連記事:高額なCDPは不要?BigQuery・dbt・リバースETLで構築する「モダンデータスタック」ツール選定と公式事例 で解説しているような「dbtによるデータモデリング」は、Claude Code がビジネスロジックを理解するための「構造化された辞書」としても機能します。

公式リソースとコミュニティ

実装上のトラブルシューティングや最新のコマンド仕様については、Anthropic公式の GitHub リポジトリや Discussions を確認するのが最も確実です。

ご相談・お問い合わせ

本記事の内容を自社の状況に当てはめたい場合や、導入・運用の設計を一緒に整理したい場合は、当社までお気軽にご相談ください。担当より折り返しご連絡いたします。

お問い合わせフォームへ

AT
aurant technologies 編集

上場企業からスタートアップまで、数多くのデータ分析基盤構築・AI導入プロジェクトを主導。単なる技術提供にとどまらず、MA/CRM(Salesforce, Hubspot, kintone, LINE)導入によるマーケティング最適化やバックオフィス業務の自動化など、常に「事業数値(売上・利益)」に直結する改善実績多数。

この記事が役に立ったらシェア: