Claude Code × Cursor でローカル環境依存を捨てる｜クラウド開発への移行実践ガイド

はじめに：なぜ今「ローカル環境依存」を捨てるのか

「自分のMacでしか動かない」問題の正体

「私のMacでは動くんですが…」

この一言を何度口にし、何度聞いてきたでしょうか。Node.jsのバージョン違い、Pythonの仮想環境の混乱、Homebrewで入れたライブラリの依存関係の衝突——ローカル開発環境の属人化は、ソフトウェア開発が始まって以来ずっと付きまとう問題です。

そしてここにきて、その問題が新たな形で再燃しています。AI開発ツールの台頭がきっかけです。

AI開発ツールの普及が環境問題を再燃させた理由

Claude CodeやCursorといったAI開発ツールは、開発のスピードを劇的に引き上げます。しかしその恩恵を最大限に受けるためには、「エージェントを長時間走らせ続けられる環境」が必要です。ノートPCのバッテリーが気になる状況、スリープで接続が切れる状況、ローカルのメモリが逼迫する状況——これらはすべて、AI開発ツールの能力を半分以下に削いでしまいます。

この記事では、Claude CodeとCursorを組み合わせてリモートのクラウド環境で開発する構成を紹介します。環境構築にかかる時間を大幅に短縮し、チームのオンボーディングをスムーズにし、AIエージェントを安心して長時間稼働させられる——その具体的な手法と、実運用で分かったハマりどころを詳解します。

想定読者： フロントエンド・バックエンドを問わず、Claude CodeやCursorを日常的に使い始めている、あるいは導入を検討しているエンジニア。LinuxのコマンドラインとSSHの基礎知識があれば理解できます。

前提知識：Claude Code と Cursor はそれぞれ何が得意か

Claude Code：ターミナル常駐型のエージェント開発

Claude Codeは、ターミナルで動作するCLIベースのAIエージェントです。最大の特徴は「長時間の自律タスク実行」に向いていること。大規模なリファクタリング、テストの一括生成、複数ファイルにまたがる仕様変更——こうした「手数が多い作業」をバックグラウンドで走らせておくことができます。

CLIベースであることは、リモート実行との相性という観点で非常に重要です。SSHで繋いだリモートサーバー上でそのまま動かせるため、ローカルマシンの状態に左右されません。

Cursor：エディタ統合型のインタラクティブ編集

CursorはVSCodeをベースにしたAI統合エディタで、「手を動かしながら考える」場面で光ります。差分レビュー、タブ補完によるリアルタイムの提案、コンテキストを踏まえたチャット——これらはエディタに統合されているからこそ快適に使えます。

重要なのは、CursorがVSCodeのRemote SSH機能を継承している点です。ローカルのCursorウィンドウから、リモートサーバー上のファイルをシームレスに編集できます。

両者は競合ではなく役割分担である

Claude CodeとCursorはしばしば比較されますが、実際の開発現場では競合ではなく補完関係として機能します。

• Claude Code → 大きなタスクをバックグラウンドで処理する「重機」
• Cursor → リアルタイムに手を動かす「精密工具」

この役割分担を前提にすると、クラウド環境への移行アーキテクチャが自然と見えてきます。

従来のローカル開発環境が抱えていた課題

クラウドへの移行を決断した背景には、積み重なった課題があります。

環境構築コストとオンボーディングの遅さ： 新しいメンバーが加わるたびに、環境構築に半日〜1日を費やしていました。READMEを更新しても、OSのバージョン差異やパッケージの変更で必ず詰まる箇所が出ます。

マシンスペックとバッテリーの制約： Claude Codeに大きなタスクを投げると、ローカルのCPU・メモリが逼迫します。ノートPCなら電源接続が必須になり、外出先では使いものになりません。

「動く環境」の属人化： 「このブランチはAさんのMacでしかビルドできない」という状況が実際に発生していました。ドキュメントには残らない暗黙の設定が蓄積した結果です。

AIエージェントを長時間走らせられない問題： 最も痛かったのがこれです。Claude Codeで30分以上かかる大規模タスクを実行中にスリープしてしまい、途中でセッションが切れる——という経験を何度もしました。

クラウド開発環境への移行：全体アーキテクチャ

構成の全体像

移行後の構成は非常にシンプルです。

ローカルPC（Cursor）
    ↕ SSH
クラウドVM（Claude Code + リポジトリ + ランタイム一式）

ローカルマシンは「入力装置」 に徹します。Cursorでコードを読み書きし、ターミナルでコマンドを打つ。実際の実行はすべてクラウドVM側で行います。

選択肢の比較

ベストプラクティスとして、小〜中規模チームにはクラウドVM（特にAWS EC2またはGCP Compute Engine）が最もバランスが取れています。必要なときだけ起動し、不要なときは停止できるため、コストを抑えられます。

実践手順：Claude Code と Cursor をクラウドに載せる

ステップ1：リモート開発ホストの用意

インスタンスサイズの目安は、一人あたり 4vCPU / 8GB RAM から始めることをおすすめします。Claude Codeを常時稼働させる場合は 8vCPU / 16GB RAM 以上が快適です。

月額コストの目安（AWS東京リージョン、m6i.xlargeの場合）：

• オンデマンド: 約220ドル/月（常時起動）
• スケジュール停止あり（平日9〜22時のみ）: 約80ドル/月

停止・起動の自動化はAWS Lambda + EventBridgeで10分程度で実装できます。これだけでコストを60%以上削減できます。

ステップ2：Cursor から Remote 接続する

~/.ssh/config に以下を追記します。

Host dev-server
  HostName <インスタンスのIP or Elastic IP>
  User ubuntu
  IdentityFile ~/.ssh/dev_key.pem
  ServerAliveInterval 60
  ServerAliveCountMax 10

ServerAliveInterval と ServerAliveCountMax の設定は必須です。これを入れないと、少しの非操作でSSH接続が切れます。

Cursorでの接続はVSCodeと同様、コマンドパレットから Remote-SSH: Connect to Host を選択するだけです。初回接続時にリモート側へVSCode Serverが自動インストールされます。拡張機能の同期も Settings Sync をオンにしておけば自動で行われます。

ステップ3：リモート側に Claude Code を導入する

# Node.js の導入（nvm 経由を推奨）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install --lts

# Claude Code のインストール
npm install -g @anthropic-ai/claude-code

# 認証
claude

認証情報（APIキー）はサーバーの環境変数に持たせます。.bashrc や .zshrc に直書きするのではなく、AWS Secrets Manager や Parameter Store から起動時に読み込む仕組みにしておくと安全です。

セッションを切っても走り続けさせる設定（tmux）:

# tmux セッションを作成して Claude Code を起動
tmux new-session -d -s claude 'claude'

# セッションへのアタッチ
tmux attach -t claude

tmux を使えば、SSH接続を切った後もClaudeのセッションは継続します。翌朝確認したら長時間タスクが完了していた——という体験は、ローカル環境では絶対に得られないものです。

ステップ4：リポジトリと認証情報の一元管理

GitリポジトリはリモートVM上にクローンします。GitHub/GitLabへのアクセスはSSHキー（デプロイキー）で行い、パスワードやPATはキーチェーンに残しません。

ステップ5：ローカルに戻さない運用ルールを決める

最初の1週間は「ローカルでやってもいいか」という誘惑に勝てないことがあります。チームで導入する場合は「実行はリモートで行う」というルールを明文化し、.devcontainer や CONTRIBUTING.md に記載しておくことが有効です。

実運用で分かった注意点とハマりどころ

ネットワーク遅延がUXを壊すライン

実測値として、往復遅延（RTT）が50ms以下であれば快適に使えます。東京リージョンを使う限り、国内からの接続は通常10〜20ms程度で問題になりません。海外出張時は品質が落ちるため、TailscaleなどのメッシュVPNで最寄りのエンドポイントを経由させると改善します。

AIエージェントの暴走を止める仕組み

Claude Codeに大きな権限を与えてリモートで長時間動かすのは便利ですが、リスクもあります。ベストプラクティスとして：

• 実行ユーザーを分離する： claude ユーザーを別途作成し、本番リポジトリへの書き込み権限を持たせない
• CLAUDE.md でスコープを制限： 実行できるコマンドを明示し、インターネット接続を必要最小限に留める
• 定期的なセッション確認： tmux list-sessions で何が動いているかを把握する習慣を持つ

コストが跳ねるパターンと抑え方

最も注意が必要なのは インスタンスの停止忘れ です。週末に止め忘れると、2日間で数千円のコストが発生します。自動停止スクリプトをcronで登録することを強く推奨します。

# crontab -e で追加（平日22時に自動停止）
0 22 * * 1-5 /usr/local/bin/notify-and-shutdown.sh

セキュリティ：ソースコードと認証情報をどこに置くか

• ソースコード： リモートVM上のプライベートリポジトリ（問題なし）
• APIキー： 環境変数 or シークレットマネージャー（絶対にリポジトリにコミットしない）
• SSHキー： ローカルにのみ保持。VM間の移動には使い回さない

GUI・ブラウザ検証が必要な場面の逃げ道

フロントエンド開発でブラウザで動作確認したい場合は、SSHポートフォワードが有効です。

ssh -L 3000:localhost:3000 dev-server

これでローカルの localhost:3000 にアクセスすると、リモートで動くdevサーバーの画面がそのまま見えます。

オフライン時のリスク

インターネット接続がない環境では完全に手が止まります。この点は正直に言うと移行のデメリットです。飛行機や地下鉄でのオフライン作業が多いチームには、部分的なローカル環境の維持を推奨します。

導入後に変わったこと（ビフォー・アフター）

特に大きかったのは、Claude Codeを夜間バッチのように使えるようになった ことです。帰宅前に大きなリファクタリングタスクを投げ、翌朝確認する——という開発サイクルが実現しました。

逆に「ローカルのままで良かった」領域もあります。デザイン確認や軽微なテキスト修正、ドキュメント執筆などはローカルでやった方が速いケースがあります。

こんなチーム・こんな人には向かない

以下に当てはまる場合は、フルクラウド移行よりもハイブリッド構成を検討してください。

• オフライン環境での作業が多い（交通機関内でのコーディングが日常）
• GUIや実機確認が開発フローの中心（モバイルアプリ、デザイン系）
• クラウドの月額コストを正当化できる収益規模にない個人開発
• セキュリティポリシー上、外部クラウドにコードを置けない

段階的に移行するなら、まず Claude Code だけをリモートで動かす ところから始めることをおすすめします。Cursorはローカルのまま、Claude Codeの長時間タスクだけクラウドに逃がすだけでも、日常の開発体験は大きく変わります。

まとめ：AI開発ツール時代の開発環境の考え方

クラウド開発への移行を経て、開発環境に対する考え方が根本から変わりました。それを一言で表すなら——

「環境は使い捨て、資産はリポジトリと設定に」

VMはいつ壊れても再構築できる。コードと設定とドキュメントさえリポジトリに入っていれば、環境は何度でも復元できる。AI開発ツールが普及した今、この思想はより一層重要になっています。

Claude CodeもCursorも、「ローカルで動かす前提」で設計されてはいません。クラウドで動かすことを意識してアーキテクチャを組むことで、その能力を最大限に引き出せます。

最小構成で試したい方へ：

1. AWS/GCPで最小インスタンスを立てる（t3.medium / e2-medium 程度）
2. SSH接続してCursorのRemote SSHで繋いでみる
3. Claude Codeをインストールして tmux の中で走らせてみる

この3ステップだけで、クラウド開発の感触はつかめます。まず1週間、この構成でいつもの作業をしてみてください。戻れなくなる実感がきっとあるはずです。

よくある質問（FAQ）

Q. Claude Code と Cursor は併用してコストが二重にならないか？

A. Claude Codeの費用はAnthropicのAPI従量課金、CursorはCursorの月額サブスクリプションと、費用体系が別です。Claude Codeを大量に使う場合はAPI費用が増えますが、Cursorの費用には影響しません。Claude Codeを使う頻度に応じてUsage Capを設定しておくと、予期せぬ高額請求を防げます。

Q. リモート環境でAIエージェントを常時稼働させても安全か？

A. 適切な権限分離とCLAUDE.mdでのスコープ制限を設定すれば、実用上問題はありません。最低限、「削除コマンドの自動実行を禁止する」「本番データベースへのアクセスを持たせない」という2点は必ず設定してください。

Q. ローカル環境は完全に捨てるべきか？

A. 完全に捨てる必要はありません。「実行環境はクラウド、エディタとブラウザはローカル」というハイブリッド構成が現実的です。チームの作業スタイルに合わせて、どこまでをクラウドに移すか段階的に判断することをおすすめします。