開発/設計

Cursorのバグで考え直した——Claude CodeとCursorをブレンドした最強AIコーディング環境の作り方2026

Cursorを使い続けてきた私が、2026年3月のあるバグ報告を見て「これは考え直す必要があるな」と感じた話をします。

Cursorのバグで考え直した——Claude CodeとCursorをブレンドした最強AIコーディング環境の作り方2026
目次

Cursor(カーソル)を使い続けてきた私が、2026年3月のあるバグ報告を見て「これは考え直す必要があるな」と感じた話をします。

「変更が無音で元に戻るバグ(silent revert)」——これが3月に入ってからCursorフォーラムに多数報告されました。「4ヶ月分の作業がこのバグで消えた」という投稿まで出ています。3月21日にはサービス品質低下の公式アナウンスもありました。

かといって乗り換えようとは思っていません。Cursorは今も最高のIDEのひとつです。ただ「1つのツールに全部依存するのはリスクだな」と気づいた。そこで考え始めたのが「ブレンド(使い分け)」という発想でした。

ちょうど同じタイミングで、Claude(クロード) Code(クロードコード)が開発者の「最愛評価(Most Loved)」で1位を取ったニュースも出ました。46%がClaude Codeを支持し、Cursorは19%、GitHub Copilot(ギットハブコパイロット)は9%という調査結果です。

「じゃあ両方うまく使えばいいんじゃないか?」——この記事では、その答えを実践ベースで書きます。CS出身からエンジニアに戻ってきた私が、実際に試してたどり着いた「90:10ルール」と「2ファイル戦略」をまとめました。


Cursorのバグが教えてくれた「1ツール依存」の怖さ

2026年3月、Cursorユーザーの間で大きな問題が起きました。「silent revert(サイレントリバート)」——コードを変更したはずなのに、気づかないうちに元の状態に戻っているバグです。

forum.cursor.comのスレッド「Revert Changes Broken with New Updates」には多数の報告が集まりました。中でも衝撃だったのは「4ヶ月分の作業がこのバグで失われた」というコメントです。3月21日にはCursor公式が”service degradation”(サービス品質低下)を認め、解決済みとアナウンスしましたが、印象は悪い。

Cursorの年間収益(ARR)は5億ドル超と言われる、市場リーダーのツールです。それでもこういう問題は起きる。バージョンアップの速度が速ければ速いほど、バグが混入するリスクは上がります。

これは「Cursorが悪い」という話ではありません。「AIコーディングツールをひとつに絞り切ることのリスク」という話です。

じゃあどうすればいいのか

答えはシンプルです。「得意なところに任せる」という発想で、複数のツールを役割分担させればいい。そのための指針が「90:10ルール」です。

日常開発の90%をCursor(IDE内の速い操作)、残りの10%をClaude Code(計画・推論・複雑なタスク)に任せる。このブレンドなら、どちらかがダウンしても即座に補完できます。

ハマったポイント先に言っときますね。「ブレンド」というと複雑そうに聞こえますが、実際は「いつもCursorで書いて、詰まったときやアーキテクチャを考えるときだけClaude Codeを使う」という感覚です。最初から両方起動する必要もありません。


2ツールの本質的な違い——「Editor AI」と「Execution AI」

ブレンドを理解するには、まず2ツールの根本的な設計思想の違いを押さえる必要があります。

英語のAI開発コミュニティでは、このふたつをこう呼んでいます。

  • Editor AI(エディタAI): Cursor
  • Execution AI(エクスキューション AI = 実行型AI): Claude Code

Editor AI(Cursor)とExecution AI(Claude Code)の役割分担を示す図解。左側にIDEインターフェース、右側にターミナル。矢印でタスクの種類別に振り分けを表示

Cursor(Editor AI)の強み

CursorはVS Codeをフォークして作られたIDEです(統合開発環境:コードを書くためのソフトウェア)。エディタとAIが深く統合されているので、コードを書きながらリアルタイムでAIの提案を受けられます。

  • コンテキストの即時性: 開いているファイルをそのままAIに渡せる
  • インライン編集: カーソル位置でAIがコードを直接書き換える
  • UXの成熟度: 2〜3年の開発で磨き抜かれた操作感
  • マルチファイル対応: 関連するファイルを横断して編集できる

ただし、コンテキスト量には注意点もある——表記上は200Kだが、実際には70K〜120K程度に内部で切り詰められているという報告が多数ある(Truncation問題)。大規模なコードベース(ファイルやコードの総体)を扱うと、この制約が顔を出すことがある。

Claude Code(Execution AI)の強み

Claude CodeはAnthropic(アンソロピック)が開発したターミナル・CLI型のAIコーディングツールです(CLIとはコマンドラインインターフェース。黒い画面でコマンドを打って操作するもの)。IDE内に統合するのではなく、ターミナルから直接使います。

  • コンテキストウィンドウの実効値: 200K(Opus 4.6では1Mトークンベータ版)。表記と実際がほぼ一致する
  • トークン効率: 独立テスト(Ian Nuttall氏による検証)でClaude Codeは33,000トークン、Cursorは188,000トークンで同等タスクを完了。5.5倍の差があります(出典: builder.io 比較テスト)
  • エージェントモードの成熟度: 複数のClaudeを並列で動かす「Agent Teams」機能あり
  • 深い推論: アーキテクチャ設計や複雑なバグ調査に特に強い

トークン効率が5.5倍違うということは、同じ月額料金でできる仕事量が5.5倍になる可能性があるということです。これはコスト面でかなり大きな差です。


90:10ルール——タスクをどう振り分けるか

理論はわかった。では実際にどう使い分けるのか。私が試行錯誤して落ち着いたのが「90:10ルール」です。

日常コーディングの90%はCursorで完結させる。残り10%の「重い仕事」はClaude Codeに任せる。この比率が今の業界のコンセンサスにもなっています。

90:10ルールのタスク振り分けチャート。縦軸にタスクの複雑度、横軸にコンテキストの量を置き、Cursor担当エリアとClaude Code担当エリアを色で区分する

Cursor(90%)に任せるタスク

タスク理由
コード補完・提案インライン表示でテンポが崩れない
小規模なリファクタリングファイル単位の変更なら十分
エラーの即時修正その場で直せる速度感が重要
テストコードの生成既存コードを参照しながら書ける
コメント・ドキュメントの追加軽いタスクはEditorで十分

Claude Code(10%)に任せるタスク

タスク理由
アーキテクチャ設計の相談大きなコンテキストが必要
大規模リファクタリング複数ファイルをまたぐ一貫した変更
バグの根本原因調査コードベース全体を把握した上での診断
新機能のspec作成spec.md(仕様書)を書いてもらう
並列エージェントでの処理Agent Teamsで複数タスクを同時進行

振り分けの基準は「1ファイル完結かどうか」と「コンテキストの量」です。1ファイル内で完結するならCursor、プロジェクト全体を理解した上で判断が必要ならClaude Code、という切り分けが直感的で使いやすいです。

実際の1日のワークフロー

# 午前: 通常の開発はCursorで進める
# (Cursorを開いてコードを書く日常)

# 新機能を追加するとき、まずClaude Codeで仕様を整理
claude "この決済機能に3Dセキュア対応を追加したい。
現在のコードベースを確認して、
どこに何を追加すべきか設計案をspec.mdに書いてほしい"

# Claude CodeがREADME、既存コード、設定ファイルを読み込んで
# docs/spec.md に設計書を生成する

# 設計書を確認したら、Cursorで実装を進める
# 詰まったらまたClaude Codeに相談する、というサイクル

この流れで動かすと、Cursorの速度感を維持しながら、Claude Codeの深い推論を「ここぞ」というタイミングで使えます。

コストの目安——月いくらでブレンド環境を作れるか

「2つのツールを使う=コストが2倍」とは限りません。トークン効率の差を踏まえると、実はかなりコスパが良くなります。

プラン月額Claude CodeCursor
ミニマム約$40(約5,800円)Pro $20Pro $20
スタンダード約$120(約17,400円)Max 5× $100Pro $20
ヘビー約$220(約31,900円)Max 20× $200Pro $20

※ 1ドル145円換算

私がおすすめするのはスタンダードプランです。Claude Code Maxは月5倍の使用量が付いてきます。前述のトークン効率5.5倍という数字を思い出してください。Cursor Ultraの$200/月分の仕事をClaude Code Max $100/月でまかなえる計算になります。

副業や個人開発なら、最初はClaude Code Pro $20 + Cursor Pro $20の合計$40/月から始めるのが現実的です。「Claude Codeを使いすぎてプランの上限に達した」と感じてきたら、そのときMaxにアップグレードすれば無駄がありません。

コスト削減のコツも共有しておきます。

# Claude Codeでコンテキストを渡す際はファイルを絞る
# NGパターン(不要なファイルまで全部渡す)
claude "src/以下を全部読んで、バグを探して"

# OKパターン(関連ファイルだけ絞る)
claude --file src/api/payment.ts --file src/types/payment.d.ts \
  "決済処理のバグを調査して"

# spec.mdを先に作ることで実装ループを減らす
claude "この機能のspec.mdをまず作って。実装は次のセッションで"

無駄にトークンを消費しないようにするだけで、月のコストを30〜40%削減できた経験があります。「必要なものだけ渡す」習慣をつけることが大事です。


CLAUDE.md + AGENTS.md の「2ファイル戦略」

ブレンド環境で最も重要なのが、設定の一元管理です。CursorとClaude Codeで別々のルールを管理していると、いずれ矛盾が生じます。そこで役立つのが「2ファイル戦略」です。

  • CLAUDE.md: Claude Code専用のルールファイル(コーディングスタイル、禁止パターン、サブエージェント定義)
  • AGENTS.md: Claude Code・Cursor・Windsurfなど複数IDEが読める「オープンスタンダード」の設定ファイル

AGENTS.mdは特定のツールに依存しない共通設定ファイルです。CursorもWindsurfも「このファイルがあれば読む」という業界標準になりつつあります。

CLAUDE.mdとAGENTS.mdの関係図。2ファイルがClaude Code・Cursor・Windsurfの各ツールに読み込まれる様子を矢印で表現

CLAUDE.md の基本テンプレート

# プロジェクトルール(Claude Code用)

## コーディングスタイル
- TypeScriptを使用(型定義を省略しない)
- 関数は純粋関数を優先する
- コメントは日本語で書く
- console.logをコミットしない

## 禁止パターン
- anyの使用を避ける(理由を書いた上でanyが必要な場合のみ例外)
- 直接DOMを操作しない(Reactのstateを経由する)
- ハードコードされた文字列をソースに含めない(定数ファイルへ)

## 使用ライブラリ
- 状態管理: Zustand
- データフェッチ: TanStack Query
- スタイル: Tailwind CSS

## サブエージェントの使い方
- セキュリティレビューが必要なファイルは .claude/agents/security-reviewer.md を使う
- テスト生成は .claude/agents/test-generator.md に任せる

## 注意事項
- 本番データベースへの直接接続は禁止
- .envファイルの内容をログに出力しない

AGENTS.md の基本テンプレート

# Agent Instructions(複数IDE共通)

## プロジェクト概要
- Node.js + TypeScript + React のWebアプリ
- バックエンドはFastify
- データベースはPostgreSQL

## 共通ルール
- コードを変更する前に必ず既存の実装を確認する
- テストを壊すコードを書かない
- PRを作る前にlintとtypeチェックを通す

## ディレクトリ構造
- src/components/ — Reactコンポーネント
- src/api/ — APIハンドラー
- src/db/ — データベースクエリ
- src/utils/ — ユーティリティ関数

サブエージェントの定義例

サブエージェント(subagent)とは、特定の専門タスクに特化したAIエージェントのことです。Claude Code内で独立したコンテキストを持ち、セキュリティやテストなど「専門家が見るべき部分」だけを担当させられます。

# .claude/agents/ ディレクトリを作成
mkdir -p .claude/agents

# セキュリティレビュー専用エージェントを定義
cat > .claude/agents/security-reviewer.md << 'EOF'
# Security Reviewer Agent

あなたはセキュリティの専門家です。
以下の観点でコードをレビューしてください。

## チェック項目
- SQLインジェクション(悪意のあるSQLコードを埋め込む攻撃)の可能性
- XSS(クロスサイトスクリプティング)の脆弱性
- 認証・認可のバイパス可能性
- 機密情報のログ出力
- 不適切なCORS設定

## 出力形式
- 問題が見つかった場合: 行番号・問題の説明・修正例をセットで報告
- 問題がない場合: 「セキュリティ上の問題なし」と明記
EOF

これを使う際はClaude Codeから--agent security-reviewerオプションで呼び出せます。


ハマりやすいポイントと対処法

「ブレンド環境、試してみたけどうまくいかない」という状況に陥りやすいパターンを先に共有します。あらかじめ知っておくと回避できる4つのポイントです。

① Agent Drift(エージェントドリフト)

Agent Driftとは、AIエージェントが長いセッションの中で当初の指示からじわじわとずれていく現象のことです。「最初は正しいコードを出していたのに、途中から全然違う方向に進み始めた」という体験をした人は多いはずです。

対処法: セッションの冒頭に必ずCLAUDE.mdを参照させます。

# セッション開始時のアンカー(錨)コマンド
claude "まずCLAUDE.mdとAGENTS.mdを読んで、
このプロジェクトのルールを確認してから始めて"

これだけでAgent Driftを大幅に減らせます。毎回やるのが面倒なら、CLAUDE.md冒頭に「セッション開始時に自分を読ませること」と書いておく方法もあります。

② Cursorの内部Truncation問題

CursorはUI上では「200Kトークン対応」と表示されますが、実際には70K〜120K程度に内部で切り詰め(truncation)が発生するという報告が多数あります。Truncationとは、長いテキストを処理できる量に切り詰める処理のことです。

大規模なコードベースで「Cursorが途中のコードを無視しているような気がする」と感じたら、それがこの現象かもしれません。

対処法: 大きなコンテキストが必要な作業はClaude Codeに移行します。これが90:10ルールの「10%」を使うべきシーンです。

③ CLAUDE.mdとAGENTS.mdの同期忘れ

CLAUDE.md(Claude Code用)とAGENTS.md(複数IDE共通)の内容が食い違ってくると、どちらのルールに従えばいいかAIが混乱します。

対処法: 変更のルールを決めておきます。

  • 常に両方に反映する共通ルール → AGENTS.mdに書く
  • Claude Code固有の設定(サブエージェント定義など)→ CLAUDE.mdにだけ書く
  • 定期的に2ファイルの差分を確認する
# 2ファイルの差分確認コマンド
diff CLAUDE.md AGENTS.md

④ 「どっちに頼めばいいかわからない」迷い

最初のうちは「このタスクはCursorかClaude Codeか」という判断で時間を取られることがあります。これが一番もったいない。

シンプルな判断基準を持っておくと解消できます。

  • 迷ったら先にCursorで試す。Cursorで解決しなかったらClaude Codeに相談する
  • 「1分以内に解決できる問題」はCursor、「5分以上悩む問題」はClaude Codeというラインも使いやすいです

まとめ——このブレンド環境は「誰に」おすすめか

Claude CodeとCursorのブレンド環境について、実践で得た知見をまとめてきました。最後に「誰がどのプランから始めるか」を整理します。

こんな人に強くおすすめします

Cursorヘビーユーザーで、最近限界を感じてきた人 コンテキストが詰まる、大規模リファクタが苦手、という課題があるなら、Claude Code Proを月$20で追加してみてください。最初は週に1〜2回使うだけでも変化を感じられます。

バイブコーディング(AIと一緒にコードを書くスタイル)を始めたばかりの人 最初から高機能なツールを全部使おうとするより、Cursorで慣れてから90:10ルールで徐々にClaude Codeを取り入れるのがスムーズです。焦らなくていい。なお「コードを書いたことがない」という段階から始めたい方には、非エンジニア向けの入門記事もあります(Claude Codeのバイブコーディング入門)。

副業エンジニアや個人開発者 ミニマムプランの$40/月から始めて、使いすぎてきたと感じたらアップグレードする段階的な移行がおすすめです。いきなりMax $100は不要です。

こんな人にはまだ早いかも

環境構築に慣れていない初心者の場合、まずはCursorかClaude Code単体をしっかり使いこなすことを優先してください。ブレンドは「どちらかひとつである程度できる」状態になってから考えるのが現実的です。

最後に

2026年3月のCursorバグ問題は、「1ツールに全依存するリスク」を改めて気づかせてくれました。これは批判ではなく、どのツールにも起こりうることです。

Claude Code首位奪取のニュースも含め、今はまさに「どのツールを使うか」より「どう使い分けるか」を考えるタイミングが来ています。

まずはCLAUDE.mdを1枚作ることから始めてみてください。それだけで開発体験がぐっと変わります。とりあえず動くもん作りましょう! 設定ファイルなんて10行あれば始められます。


参考情報


本記事は2026年3月時点の情報をもとに執筆しています。各ツールの価格・機能は変更される場合があります。

ゲン
Written byゲンCS × Vibe Coder

正直、一度エンジニアは諦めました。新卒で入った開発会社でバケモノみたいに優秀な人たちに囲まれて、「あ、私はこっち側じゃないな」って悟ったんです。その後はカスタマーサクセスに転向して10年。でもCursorとClaude Codeに出会って、全部変わりました。完璧なコードじゃなくていい。自分の仕事を自分で楽にするコードが書ければ、それでいいんですよ。週末はサウナで整いながら次に作るツールのこと考えてます。