0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Claude Code × Cursor × Notion、結局どう使い分ける? ― 3ツール併用で開発速度が2倍になった構成図を公開

0
Posted at

結論:「全部Claude Codeでよくない?」は半分正しく、半分間違い

『全部Claude Codeでよくない?』と思っていた時期が私にもありました。3ツールを併用して初めて見えた最適解を共有します。

結論から言うと、3ツールにはそれぞれ明確な「最も輝くフェーズ」があります。 適材適所で使い分けた結果、PRマージまでの平均時間が 4.2時間 → 2.1時間 に短縮されました。

この記事では、以下がわかります。

  • Claude Code / Cursor / Notion それぞれの得意領域
  • 開発フェーズごとの具体的な使い分けフロー
  • MCPサーバーで3ツールを接続する実践的な方法
  • 併用前後の実測データ比較
  • よくある間違いパターンとチートシート

環境・前提条件

項目 バージョン / プラン
Claude Code 最新版(Claude MAX プラン)
Cursor Pro プラン
Notion チームプラン
MCP サーバー Notion MCP / GitHub MCP
主な開発言語 TypeScript / Python
チーム規模 3〜5名

1. 3ツールの得意領域マッピング

まず、各ツールがどこで最も力を発揮するかを整理します。

Claude Code:大規模変更・自律的タスク実行

  • リポジトリ全体を把握した上でのリファクタリング
  • 複数ファイルにまたがる機能追加・削除
  • テストの一括生成、CI修正
  • Git操作を含むワークフロー全体の自動化
  • 強み:ターミナルで完結する「手放し運転」

Cursor:局所編集・コード探索・対話的開発

  • 特定ファイルのピンポイント修正
  • コードリーディング(定義ジャンプ + AI質問のコンボ)
  • Tab補完による高速コーディング
  • エディタ上でリアルタイムに差分を確認しながらの微調整
  • 強み:人間が「見ながら・触りながら」進める作業

Notion:設計・ドキュメント・ナレッジ管理

  • 要件定義ドキュメントの作成・共有
  • 設計判断ログ(ADR)の蓄積
  • スプリント管理・タスクボード
  • API仕様書・ER図の管理
  • 強み:「コード以外のすべて」の中央管理

2. 開発フェーズ別の使い分けフロー

「いつ・どのツールを使うか」を開発フェーズで切り分けると、迷いがなくなります。

各フェーズの具体的な使い方

① 要件定義(Notion メイン)

Notionでテンプレートを用意し、PRD(Product Requirements Document)を作成します。ここはチームとの合意形成が重要なので、共同編集が得意なNotionが最適です。

② 設計(Notion + Cursor)

Notionで設計判断を記録しつつ、Cursorで既存コードを探索します。「この関数どこから呼ばれてる?」系の調査は、定義ジャンプ+AI質問ができるCursorが圧倒的に速いです。

③ 実装(Claude Code メイン + Cursor サブ)

ここが最大のポイントです。

# Claude Codeで大枠を一気に実装
claude "NotionのPRDに基づいて、ユーザー認証機能を実装して。
対象ファイル: src/auth/ 配下
テストも一緒に書いて"

Claude Codeが生成したコードの微調整はCursorに切り替えます。変数名の修正、エッジケースの追加など「人間の目で見ながら」の作業はCursorが得意です。

④ テスト(Claude Code メイン)

claude "テストを実行して、失敗したものを修正して"

テスト→修正→再テストのサイクルは、ターミナルで完結するClaude Codeが最も効率的です。

⑤ レビュー(Cursor + Claude Code)

PRの差分確認はCursorのエディタ上で行い、レビュー指摘への対応はClaude Codeで一括処理します。

⑥ ドキュメント(Notion + Claude Code)

Claude CodeでREADMEやCHANGELOGを生成し、設計上の判断記録はNotionに蓄積します。

3. MCPサーバーで3ツールを接続する方法

3ツール併用の真の威力は、MCPサーバーで接続したときに発揮されます。

Notion MCP の設定

Claude Codeの設定ファイル(~/.claude/claude_code_config.json または プロジェクトの .mcp.json)に以下を追加します。

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_xxxxx\", \"Notion-Version\": \"2022-06-28\"}"
      }
    }
  }
}

これにより、Claude Codeから以下のようなことが可能になります。

# NotionのPRDを読み取って実装する
claude "Notion の「ユーザー認証機能 PRD」ページを読んで、その仕様通りに実装して"

# 実装完了後、Notionのタスクステータスを更新する
claude "Notion のタスクボードで「認証機能実装」を完了に変更して"

GitHub MCP の設定

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxx"
      }
    }
  }
}

GitHub MCPを使うと、Claude CodeからIssueの内容を読み取り→実装→PR作成まで一気通貫で実行できます。

3ツール連携の実践フロー

  1. Notion にPRDを書く
  2. Claude Code がNotion MCPでPRDを読み取り、実装+テスト+PR作成
  3. Cursor でPRの差分を確認・微調整
  4. Claude Code がGitHub MCPでレビューコメントを読み取り、修正を反映
  5. Notion のタスクボードを自動更新

この流れが確立すると、コンテキストの手動コピペがゼロになります。これが速度向上の最大の要因です。

4. 実測データ:併用前後のPRマージまでの時間比較

私のチーム(3名)で2週間ずつ計測した結果です。

指標 併用前(Claude Code単体) 併用後(3ツール) 改善率
PRマージまでの平均時間 4.2時間 2.1時間 50%短縮
手戻り回数(PR修正コミット数) 3.8回 1.4回 63%減少
設計ドキュメント作成時間 45分 20分 56%短縮
コンテキスト切替によるロス 約30分/日 約10分/日 67%減少

なぜ速くなったか?

最大の要因は「手戻りの減少」です。

Claude Code単体だと、大規模変更を投げた後に「ここはこうしたかった」という微調整が発生し、再度Claude Codeに長いプロンプトを書く必要がありました。

3ツール併用では:

  • 大枠はClaude Codeが一発で仕上げる
  • 微調整はCursorでサッと直す
  • 設計意図がNotionに残っているのでブレない

この粒度の使い分けが、手戻りを大幅に減らしました。

5. 使い分け判断チートシート

迷ったときはこのチートシートを参照してください。

こんなとき 使うツール 理由
5ファイル以上にまたがる変更 Claude Code 全体把握 + 自律実行
1〜2ファイルの修正 Cursor エディタ上で差分確認が速い
「この関数の呼び出し元は?」 Cursor 定義ジャンプ + AI質問
テスト生成・一括実行 Claude Code ターミナル完結
チームへの設計共有 Notion 共同編集・コメント
PR作成・Issue対応 Claude Code GitHub MCP連携
コードレビューの差分確認 Cursor ビジュアルdiff
レビュー指摘の一括修正 Claude Code 複数箇所の同時修正
議事録・ADR Notion 長期保存・検索性
README・CHANGELOG生成 Claude Code リポジトリ情報を自動収集

よくある間違いパターン

❌ 間違い1:全部Claude Codeでやろうとする

1行の変数名修正にClaude Codeを起動するのはオーバーキルです。Cursorで直接編集した方が10倍速いです。

❌ 間違い2:Cursorで大規模リファクタリング

Cursorのチャットで「全ファイルのimportパスを変更して」と頼むと、コンテキストウィンドウの制約でファイルの取りこぼしが発生しがちです。これはClaude Codeの得意領域です。

❌ 間違い3:設計判断をコード内コメントだけで管理

「なぜこの設計にしたか」はNotionに書きましょう。コード内コメントは「何をしているか」、Notionは「なぜそうしたか」です。この分離が後々効いてきます。

❌ 間違い4:MCPを設定せずにコピペで連携

NotionのPRDをコピーしてClaude Codeに貼り付ける作業を毎回していませんか? MCP設定に30分かければ、以後のコピペ時間がゼロになります。

まとめ

  • Claude Code = 大規模・自律的タスクCursor = 局所編集・探索Notion = 設計・ドキュメントの3層で使い分けることで、手戻りが63%減少し、PRマージ時間が半分になった
  • MCPサーバーが3ツールを接続する要であり、Notion MCP / GitHub MCPの設定により、コンテキストの手動コピペをゼロにできる
  • **判断基準は「変更の規模」と「作業の性質」**の2軸。迷ったらチートシートを見て、30秒以内にツールを選ぶ習慣をつける

参考リンク

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?