CursorからClaude Codeへの移行ガイド — 設定の引き継ぎから「Tab補完がない」問題までの実務手順

はじめに

Cursorを日常的に使ってきた開発者がClaude Codeに移行するときに、何を引き継げて、何を作り直さないといけないのか。本記事では実務観点で5つの差分(対話形態 / 設定ファイル / 補完体験 / プラグイン / コスト)を整理し、移行手順を順序立てて示します。

完全な移行ではなく併用パターン(Cursorで対話的にコードを書きつつ、Claude CodeでCI / バッチ / リファクタを回す)も視野に入れて扱います。

5つの差分

詳細な機能比較はClaude Code vs Cursor vs Codex CLIで扱っています。

移行手順(7ステップ)

ステップ1: Claude Codeを入れる

Claude Code完全ガイドの手順で curl ベースの Native Install を入れます。

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash
 
# Windows(PowerShell)
irm https://claude.ai/install.ps1 | iex

Native Installを選ぶと自動更新が効くため、Cursorの自動更新と同等の運用が実現できます。

ステップ2: .cursorrules を CLAUDE.md に翻訳する

最も重要な作業です。Cursorの .cursorrules はClaude Codeでは CLAUDE.md に置き換わります。

最小手順:

# .cursorrules をコピーして CLAUDE.md にリネーム
cp .cursorrules CLAUDE.md
git add CLAUDE.md

これでClaude Codeはセッション開始時に自動的にCLAUDE.mdを読みます。.cursorrules 自体を削除する必要はない(Cursor併用時のため残しても問題ない)。

実用的な書き方はCLAUDE.md 10パターンを参照してください。

ステップ3: VS Code拡張をインストール(IDE連携を維持したい場合)

ターミナル中心の運用に完全移行するなら不要ですが、VS Codeを引き続き開いておきたい場合はClaude Code VS Code拡張をインストールします。

VS Code Marketplace で "Claude Code" を検索 → Install

拡張から Open Claude Code を呼び出すと、現在のプロジェクトをcwdとしてClaude Codeセッションが開きます。CursorのComposer / Chatペインに近い体験が、VS Code上のターミナルパネルで再現されます。

ステップ4: 「Tab補完がない」問題への向き合い方

Claude CodeにはCursorのようなインラインTab補完はありません。これが移行の最大のフリクションです。代わりに以下の組合せで補完体験を再構築します。

現実的な並走パターン:

• 「コードを書く」 → エディタ + Copilot or CursorのTab補完
• 「機能の追加 / リファクタ / バグ修正の連続作業」 → Claude Code(エージェント実行)
• 「CI / GitHub Actions」 → Claude Code(claude --bare -p)

Claude Codeは「エディタの代替」ではなく「AIに作業を任せる時間帯のための専用ターミナル」と位置付けると違和感が小さくなります。

ステップ5: Hooks / Skills / Sub-agents / MCPに乗り換える

CursorのRulesや プラグインで実現していた拡張は、Claude Codeでは機構が分かれています。

コマンド前後に処理を差し込む(lint / format)

Cursorの "Apply前にlintを走らせる" 等の自動化 → Claude CodeのHooksで書きます。

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit",
        "hooks": [
          { "type": "command", "command": "npm run lint" }
        ]
      }
    ]
  }
}

イベント名(PostToolUse 等)はオブジェクトのキーとして書き、matcher でツールを絞り込みます。ハンドラは hooks 配列内に type: "command" で記述する形式です。詳細はHooks入門と公式docsを参照してください。

定型作業のショートカット化

Cursorの "Slash Commands"(社内固有のもの)→ Claude CodeのSlash CommandsかSkillsに置き換えます。

# release-notes コマンド
直近のコミットを read して、ユーザー向けのリリースノートを下書きしてください。

これで /release-notes がセッション内で使えるようになります。Skillsの使い分けはSkills 5パターンを参照。

外部ツールへの接続

CursorのMCPプラグイン → Claude CodeのMCP(同じプロトコル)。.mcp.json を共有できる場合が多く、移行コストは低いです。詳細はMCP実用ガイドを参照。

ステップ6: コスト構造を再設計する

Cursorで「Pro $20/月の枠を使い切ってリクエスト制限に当たる」体験があった層は、Claude CodeのMaxプランに移行するとコスト予測が立てやすくなります。MaxはProの5倍 / 20倍の利用枠が定額で使えるため、ヘビーユーザー向けの心理ハードルが下がります。

ステップ7: claude を毎日のルーチンに組み込む

最初の1〜2週間で抑えるコマンド:

claude              # 対話セッションを開始
claude -c           # 直前のセッションを継続(continue)
claude -r           # セッションをリストから選んで再開(resume)
claude -p "<query>" # ヘッドレスで 1 ショット実行(CI 用)

セッション内のコマンド:

/cost      # 現在のコスト使用量
/model     # モデル切り替え(opus / sonnet / haiku)
/doctor    # 環境診断
/compact   # 履歴を要約してコンテキストを圧縮

CLIフラグも併用するとよく使います:

claude --effort high              # 思考の深さを high で起動
claude --permission-mode plan     # Plan モードで起動(編集前に計画を提示)
claude --model opus               # モデルを指定して起動

スラッシュコマンドの全体像はClaude Codeスラッシュコマンド実用集を参照。

よくあるつまずき

1. 「CursorのComposerのように複数ファイルを一度に書き換えたい」

Claude Codeはデフォルトで複数ファイル編集できます。指示の仕方を変えるだけでComposer相当の動作になります。

• ❌ 「app/login.tsx を直して」(1ファイル指定)
• ⭕ 「ログインフォームに2FAを追加して。app/login.tsx lib/auth.ts tests/login.test.ts を関連付けて修正して」(複数ファイル明示)

Planモードを使うと、編集前に変更計画を提示してくれるため、ComposerのApply前確認に近い体験になります。Planモードは Shift+Tab でpermissionモードを切り替えるか、claude --permission-mode plan で起動できます。

2. 「CursorでAppleScript風のキーバインドが効かない」

Claude Codeはターミナルベースなので、Cursor固有のキーバインドは引き継げません。Claude Code側のキー操作は本体・利用するターミナルで挙動が変わるため、起動後の ? ヘルプかClaude Codeスラッシュコマンド実用集で実機の対応を確認するのが堅実です。「Cmd+Kでインライン指示」「⌥+Enterで改行」のようなターミナル固有のキーバインドはアプリの設定に依存します。

3. 「Tab補完がなくてコード書きが遅くなった」

これが最大の体感差です。書く時間帯と任せる時間帯を分ける運用に変えると馴染みます。

• 9:00-12:00: コード書き(エディタ + Copilot or Cursor)
• 13:00-15:00: 機能追加 / リファクタ(Claude Codeに任せる時間)
• 15:00-: レビュー / 仕上げ(エディタに戻る)

「常時Claude Code」ではなく「集中して任せる時間を作る」が現実的なリズムです。

4. 「.cursorignore相当が見当たらない」

Claude Codeは .gitignore を尊重するため、まずは .gitignore の整備で除外したいパスをコミットから外す運用が出発点になります。追加で「Claudeには絶対に触らせたくない」パスがある場合は、.claude/settings.json の permissions.deny で個別に拒否ルールを書く方法が公式の経路です。詳しい設定キーの一覧はClaude Code設定完全ガイドを参照してください。

5. 「並列に複数のセッションを動かすとどうなる?」

問題なく動きますが、/cost 表示やモデル切替がセッション同士で混ざらないように、--name で名前を付けて起動するのがおすすめです。

claude --name=refactor    # ターミナル A
claude --name=tests       # ターミナル B

Cursorを残す / 完全移行する判断基準

完全移行する場合と、併用する場合の判断ポイントを並べると次の通りです。

完全移行を急ぐ必要はありません。1つのリポジトリで2週間併用して、自分のリズムに馴染む方を主軸に据えるのが現実的です。

まとめ

• .cursorrules → CLAUDE.md: 中身はそのままコピー、ファイル名を変えるだけ
• Tab補完がない問題: エディタ + Claude Codeの時間帯分けで運用
• Hooks / Skills / Sub-agents / MCPに乗り換え: 拡張機構の概念は近いが、配置と書き方が違う
• コスト構造をMaxで再設計: Proでリクエスト制限に当たる層にはMaxが現実的
• 2週間併用してから判断: 完全移行を急がず、自分の作業リズムに馴染む方を選ぶ

Claude CodeはCursorの代替ではなく、「AIに作業を任せる時間帯のための専用環境」として並走させると最も価値が出ます。Cursorが手元のエディタ体験を最大化するのに対し、Claude Codeはターミナル / CI / 長時間セッションでの自律実行を最大化する設計です。両ツールを目的別に使い分ける運用が、2026年現在の最も生産性の高い構成と言えます。