CursorでDevContainerを使いこなす！基本からトラブル対策まで

CursorでDevContainerを使うには？基本設定と導入の流れ

DevContainer対応の歴史と現状

テキトー教師DotAI 認定講師

CursorがDevContainerに対応したのは2024年1月のバージョン0.22.0からなんですよね。それ以降、独自の拡張機能（anysphere.remote-containers）でサポートを続けてきて、今では多くの開発者が使っています。

室谷代表取締役

チーム開発の標準環境をコンテナで統一できるのは大きいですよね。MYUUUでも導入検討中なんですが、VSCodeからの移行で互換性の話がちょっと出てるんですよね。

テキトー教師DotAI 認定講師

そうなんです。Cursor独自の拡張機能に切り替わったタイミングで一部設定が動かなくなったケースもありましたが、最新バージョンではおおむね解決しています。

必要な環境（Docker、拡張機能）

室谷代表取締役

まずDocker Desktopか、それに代わるランタイムが必要です。あとはCursorに標準で入ってる「Dev Containers」拡張機能（anysphere.remote-containers）を有効にするだけ。

テキトー教師DotAI 認定講師

現場で「拡張機能が表示されない」って相談を受けることがあるんですが、大抵はホスト側でしかインストールされてないケースですね。コンテナ内に入ると拡張機能のUIが消えて見えることもあるので、最初はホスト側で確認するといいです。

室谷代表取締役

そのあたり、VSCodeと違ってCursor独自実装なので、バージョンによって挙動が変わる可能性があります。公式フォーラムで最新情報を確認するのが確実です。

簡単なセットアップ手順（devcontainer.json作成から起動まで）

テキトー教師DotAI 認定講師

まずプロジェクトのルートに .devcontainer/devcontainer.json を作ります。中身は例えばこんな感じ。

{
    "name": "My Dev Container",
    "image": "mcr.microsoft.com/devcontainers/base:ubuntu",
    "customizations": {
        "vscode": {
            "extensions": []
        }
    }
}

室谷代表取締役

拡張機能の指定は customizations.vscode.extensions に書きます。ただ、以前のバージョンではここに - プレフィックスで削除指定を入れるとビルドが失敗するバグがあったので、今は大丈夫だと思いますが、もしエラーが出たら公式の更新を確認したほうがいいですね。

テキトー教師DotAI 認定講師

ファイルを用意したら、コマンドパレットから「Dev Containers: Reopen in Container」を選ぶか、右下に表示される「Reopen in Container」ボタンをクリック。初回はイメージのダウンロードとビルドが走るので、少し時間がかかります。

室谷代表取締役

慣れるまでは意外とスムーズにいきます。一度設定してしまえば、チーム全員が同じ環境で開発できるので、導入コスト以上のリターンは確実にあると思います。

「DevContainerが使えない」よくあるトラブルと解決策

UIアイコンが消えた？拡張機能がアクティブにならない

テキトー教師DotAI 認定講師

最初に戸惑うのが、拡張機能がインストールされてるのにUIアイコンが出ないケースです。フォーラムでもよく報告されてますね。

室谷代表取締役

あれ、結構あるんですよね。Anysphere Remote Containers拡張がローカルでは動いてるけど、コンテナ内ではUI要素が提供されない。

スコープの切り替えで直ることもありますが、根本的には認証周りが原因のことも。

テキトー教師DotAI 認定講師

そう、アカウント認証に失敗してるパターンですね。再ログインで治る場合もあるけど、設定ファイルでextensionKindを明示的にuiにしても効果なしって報告もありました。

室谷代表取締役

とりあえずは拡張機能のバージョンを最新にして、再読み込み。それでもダメなら、コンテナ外で一度開き直すといいかもしれないです。

devcontainer.jsonが見つからないエラー

室谷代表取締役

次は「No devcontainer.json files found」って出るパターン。ファイルは確かにあるのに見つからない。

テキトー教師DotAI 認定講師

これはSSHリモート経由でDevContainerを使おうとしたときに起きやすいですね。拡張機能がリモートのファイルシステムを正しく認識できてない。

室谷代表取締役

フォーラムでは、anysphere.remote-containersのバージョン1.0.22で発生してる報告がありました。VSCodeでは動くのにCursorだけダメ、と。

テキトー教師DotAI 認定講師

解決策として、一度拡張機能を無効化して再有効化するか、Cursor自体を再起動すると認識することがあります。それでも直らなければ、拡張機能の更新を待つしかないかもしれません。

ビルド失敗やDocker接続の問題

室谷代表取締役

ビルドが途中でコケるケースも多い。特にdocker.sockが正しくリンクされてないと、外のDockerと通信できずにエラーになります。

テキトー教師DotAI 認定講師

そうそう、docker-outside-of-dockerフィーチャーが必要なケースがあります。devcontainer.jsonでfeaturesに追加するか、手動でdocker.sockをマウントする必要があります。

室谷代表取締役

あと、docker-composeを使った構成だと、古いバージョンの拡張機能でエラーが出てた時期もありました。エラーログに“failed to resolve source metadata”とか出たら、Dockerのキャッシュをクリアしてみるといいですよ。

テキトー教師DotAI 認定講師

現場でよく聞くのは、Docker Desktopのバージョンが古いとビルドに失敗するケース。まずはDockerを最新にアップデートしてみてください。

バージョンアップで動作しなくなった場合の対処

室谷代表取締役

Cursorのアップデート後にDevContainerが急に使えなくなる、あるあるですね。特に、Microsoftの拡張をブロックしてAnysphere独自のものに切り替えたタイミングでトラブルが多発しました。

テキトー教師DotAI 認定講師

あの時は、既存のdevcontainer.jsonのcustomizations.vscodeセクションが原因でビルドが失敗するバグがありました。拡張機能のバージョンを1.0.16以上に上げることで修正されました。

室谷代表取締役

アップデート後はまずanysphere.remote-containersのバージョンを確認。古ければ最新にして再ビルド。

それでもダメなら、Cursorのバージョンを一つ前に戻すのも手です。

テキトー教師DotAI 認定講師

とにかく、困ったときはフォーラムで検索。多くのバグはすぐに修正されているので、まずはバージョンアップを試すのが一番ですね。

Cursor独自のDevContainer拡張機能を使いこなす

Anysphere Remote Containers拡張の特徴

テキトー教師DotAI 認定講師

これ、意外と知られてないんですが、CursorのDevContainer機能ってMicrosoftの拡張じゃなくて、独自の「Anysphere Remote Containers」なんですよね。

室谷代表取締役

そうです。0.22.0から標準で入ってるんですけど、中身は結構違う。

OpenVSX経由で配布されてて、独自のUIや設定項目があるんです。

テキトー教師DotAI 認定講師

現場で「VS Codeでは動くのにCursorで動かない」って相談が来るんですが、たいていこの拡張の癖が原因ですね。

室谷代表取締役

まあでも、基本的なdevcontainer.jsonはそのまま使えるし、機能追加も進んでる。最新版では設定ファイルを自動検出して「Reopen in Container」のプロンプトが出るようになりました。

devcontainer.jsonのCursor固有設定

テキトー教師DotAI 認定講師

ただし、customizationsブロックでVS Code向けに書いた拡張機能リストがそのまま動かないケースがありました。特にプレフィックスに-で削除指定してるとエラーになる。

室谷代表取締役

あれは1.0.16で修正されたはず。ただ、どうしてもハマるならcustomizationsをcursor専用に分ける手もありますよ。

テキトー教師DotAI 認定講師

あと、ドットファイルの設定は~/.cursor/settings.jsonに書く必要があって、dotfiles.repositoryとかを直接指定するんです。昔はこれがうまく動かなくてバージョン1.0.16以降で直りました。

室谷代表取締役

なるほど。それと、remote.extensionKindで拡張の動作場所を制御しようとしても、Anysphere独自拡張には効かないケースがあるので注意ですね。

拡張機能の更新とトラブルシュート

室谷代表取締役

この拡張、結構頻繁に更新されるんですよ。フォーラム見てると「UIが消えた」「コンテナ内で拡張が効かない」って報告がよく上がってます。

テキトー教師DotAI 認定講師

そうですね。特にリモートSSH経由でDevContainerを使う時に、拡張がアクティブにならない問題。

GlassモードではそもそもDevContainerが未対応なので、クラシックモードで開く必要があります。

室谷代表取締役

更新は自動ですけど、もし挙動がおかしくなったら一度拡張を無効にして再有効化するか、cursor --classicで起動し直すと直ったりします。

テキトー教師DotAI 認定講師

それでもダメなら、フォーラムでanysphere.remote-containersのバージョンを確認して、既知のバグがないか調べるといいですよ。最新版で大抵直ってますから。

DevContainer内でCursor AI機能（Composer/Agent）をフル活用する

コンテナ内でAIが動作する仕組み

室谷代表取締役

CursorのDevContainer対応、内部構造がかなり洗練されてるんですよ。基本的にはコンテナ内にCursorサーバーが立ち上がって、ホストのエディタと通信する形。

AI機能もそのサーバー経由で動くから、ローカルと同じComposerやAgentがそのまま使えるんです。

テキトー教師DotAI 認定講師

たしかに。でも最初に「ちゃんとAI動くの？」って不安に思う人、結構います。

実際には拡張機能さえ正しくインストールされていれば、コード補完もAgentも問題なく動くんですね。

室谷代表取締役

そうです。Anysphere Remote Containers拡張がその役割を担ってて、コンテナ内の環境を自動でセットアップしてくれる。

パフォーマンスと制限事項

テキトー教師DotAI 認定講師

ただ、コンテナ内だとファイルシステムが隔離されてるので、巨大なnode_modulesなんかをインデックスしようとすると少しもたつくことがあります。

室谷代表取締役

そこはワークスペースの設定で除外パターンを指定するのが定石ですね。MYUUUでもdevcontainer.jsonのsettingsに"search.exclude"や"files.watcherExclude"を追加してます。

ROI効かせるなら、この一手間でAgentのレスポンスが体感で変わる。

テキトー教師DotAI 認定講師

あとは、拡張機能のインストールに失敗するケースも報告されてます。devcontainer.jsonのcustomizationsブロックに書いたvscode用の拡張リストが、Anysphere独自の実装だと認識されないことがあったみたいで。

セキュリティとベストプラクティス

室谷代表取締役

セキュリティ面では、コンテナの隔離性がそのままAI機能にも適用されるのがメリットです。Agentが外部にアクセスする範囲も限定できる。

テキトー教師DotAI 認定講師

ベストプラクティスとしては、devcontainer.jsonに"remote.extensionKind": {"anysphere.remote-containers": ["ui"]}を明示しておくと、UI系の拡張がコンテナ内で正しく動くようになる、というフォーラムの情報もあります。

室谷代表取締役

そうそう。あとドットファイルの同期は、Cursor独自実装だと1.0.16以降で安定してる。

シェルの設定やSSH鍵をコンテナ内に反映したい人はバージョンを最新に保っておくといいですね。

既存のdevcontainer.jsonとの互換性 – VSCodeから移行するには

customizationsブロックの互換性問題

室谷代表取締役

VSCodeから移行して最初にハマるのがこのcustomizationsブロックですね。Anysphereの拡張機能に切り替わった初期バージョンだと、"customizations": {"vscode": {...}} が原因でコンテナ起動に失敗するケースがあったんですよ。

テキトー教師DotAI 認定講師

たしかに。拡張機能のインストール指定が空になってエラーが出るパターンですね。

特に拡張機能名の先頭に"-"を付けて削除指定してると、その文字列をそのままオプション解釈してしまって、変なエラーが起きるっていう。

室谷代表取締役

はい。あと、devcontainer-feature.jsonのカスタマイズに拡張機能を書いてる場合も、最初は無視されてた。

今は修正されてますけど、古いテンプレートをそのまま使うと要注意です。

テキトー教師DotAI 認定講師

移行時はまず拡張機能の指定をdevcontainer.jsonの直下に書いてテストするのが安全ですね。features側のcustomizationsは後で追加で。

拡張機能のインストールが失敗する場合

テキトー教師DotAI 認定講師

拡張機能のインストール失敗でよく聞くのは、featuresの中に書いたextensionリストが効かないってパターン。あれ、extensionのバージョン1.0.14以降で修正されたんですよね。

室谷代表取締役

そうです。featuresのcustomizationsブロックは後から追加された仕組みなので、拡張機能側の更新が先行してた感じです。

もし古い環境で再現するなら、featuresを使わずに直接extensionsを書くのが確実。

テキトー教師DotAI 認定講師

もう一つ、拡張機能を削除指定する"-"プレフィックスも要注意。VSCodeでは普通に使えるけど、Cursorの拡張機能だとエラーになるケースがあった。

今は直ってるはずだけど、移行時は一度リストから外して確認した方がいい。

室谷代表取締役

そうですね。拡張機能の互換性リストを全部移行する前に、最小構成で動かすのが吉です。

dotfiles設定の移行ポイント

室谷代表取締役

dotfilesの設定も、VSCodeと同じ感覚でやると引っかかります。Cursorでは設定画面にdotfilesの項目がないので、手動でsettings.jsonに書く必要がある。

テキトー教師DotAI 認定講師

具体的には、~/.cursor/settings.json に "dotfiles.repository" や "dotfiles.installCommand" を書くんですが、バージョンによってはその設定が無視されてインストールが走らないことがありました。

室谷代表取締役

あれ、拡張機能のバージョン1.0.16で修正されてます。Gitの設定やSSH認証ソケットの設定後に初期化スクリプトを実行するように順番が変わったとか。

テキトー教師DotAI 認定講師

つまり、dotfilesを移行するなら拡張機能を最新にアップデートしてから、settings.jsonに書けば大丈夫。VSCodeから丸ごと持ってきてそのまま使えるかというと、やっぱり一度動作確認は必要ですね。

SSHやリモート環境でのDevContainer使用 – 注意点と回避策

Cursor Glassでの制限

テキトー教師DotAI 認定講師

Cursor Glass、あの新しいインターフェースですけど、DevContainerが使えないって話をよく聞くんですよ。

室谷代表取締役

そうなんですよね。Glass Alphaでは既知の制限で、DevContainerやWSLがまだサポートされてない。

SSH接続自体は動くんですが、その先でDevContainerを起動しようとするとループする。

テキトー教師DotAI 認定講師

回避策としては、cursor --classic で従来モードで起動するか、Glass内の「Open Editor Window」コマンドを使ってクラシックウィンドウを開く方法があるみたいです。

室谷代表取締役

チーム全体でGlassに移行しようと考えてる企業は、この制限を把握しておいたほうがいいですね。リモート開発がメインだと現状Glassは厳しい。

SSH接続が切れる問題

テキトー教師DotAI 認定講師

SSHでリモートにつないでいるときに、突然接続が切れてしまうことがあるんですよ。「Connection reset by peer」ってエラーが出て。

室谷代表取締役

うちの現場でもありました。CursorのAnysphere Remote-SSH拡張が独自にサーバーをインストールしようとして失敗するパターンですね。

VS Codeでは問題ないのに。

テキトー教師DotAI 認定講師

フォーラムでは、CursorマーケットからRemote-SSH拡張を一度削除して再インストールすると直ることがあるそうです。

室谷代表取締役

根本的には拡張側のバグっぽいので、アップデートを待つか、VS Codeの拡張が併用できる環境ならそちらに切り替える判断もありだと思います。

リモートサーバーでのDocker設定

テキトー教師DotAI 認定講師

SSHでリモートのLinuxサーバーに接続して、そこでDevContainerを開こうとすると、devcontainer.jsonが見つからないってエラーになるケースがあります。

室谷代表取締役

それ、WindowsからSSHでLinuxに入ってる環境でよく報告されてますね。拡張がリモート側のファイルシステムを正しく認識できてないみたいで。

テキトー教師DotAI 認定講師

解決策として、Anysphere Remote Containers拡張を最新版にアップデートする、docker.sock が正しくマウントされているか確認する、remote.extensionKind の設定を見直す、といった対策があります。

室谷代表取締役

リモート環境では docker-outside-of-docker フィーチャーをdevcontainer.jsonに追加しておくと、Dockerデーモンとの連携が安定しやすいですね。事前にチェックリストを作っておくといいです。

開発現場でDevContainerを導入する戦略 – 経営者・リーダー視点

チームの開発環境統一によるメリット

室谷代表取締役

チーム全員が同じ環境で開発できるメリットは計り知れないですね。オンボーディングの時間が劇的に減ります。

MYUUUの現場でも、新メンバーが来るたびに環境構築で半日かかっていたのが、DevContainer導入後は10分で済むようになりました。

テキトー教師DotAI 認定講師

現場でよく聞く「自分の環境では動いたのに」問題がなくなるんですよね。CursorのDevContainer対応が安定してから、導入が一気に進んだ印象です。

Visual Studio Codeから移ってきたチームも、devcontainer.jsonをそのまま使えるので抵抗が少ない。

室谷代表取締役

Cursorのようなエディタはアップデートが頻繁なので、環境差異がバグの温床になりがちです。統一環境はリスク管理の面でも効果的。

テキトー教師DotAI 認定講師

ただ、既存のプロジェクトに後付けで導入するときは、Dockerfile周りの整理に少し工数がかかります。そこは一度やってしまえば、以降のメンテナンスコストは下がりますけどね。

Cursorのエンタープライズ機能との連携

室谷代表取締役

Cursorはエンタープライズ向けのプランも用意しています。DevContainerによる環境標準化と組み合わせると、チーム全体の開発基盤を統制しやすくなる。

海外の企業では、テンプレートをリポジトリに含めて全員が同じコンテナを使う運用が当たり前になってきています。

テキトー教師DotAI 認定講師

現場レベルだと「各々の好みでカスタマイズしたい」という声も出ますが、ベース環境を揃えておけばトラブルシュートが楽になる。Anysphere Remote Containers拡張に切り替わってから、互換性の問題もだいぶ解消されてきています。

室谷代表取締役

ただし、Cursor Glassのような新しいUIとDevContainerの相性には注意が必要です。Glass内では現時点でDevContainerが完全にサポートされていないケースもあるので、Classicモードで使うなど切り分けが必要です。

テキトー教師DotAI 認定講師

そのあたりはフォーラムでもよく話題になっていますね。とはいえ、チーム標準としてDevContainerを導入する価値は十分にあると思います。

導入コストとROI

室谷代表取締役

コスト面で言うと、DevContainer自体は無料です。devcontainer.jsonを書く初期工数だけ。

時給換算すれば、数回の環境構築削減でペイします。Cursor Proの月額料金も、効率化で十分回収できる計算です。

テキトー教師DotAI 認定講師

初期投資としては、Dockerの知識がある人が1〜2日程度でテンプレートを作れます。チームが大きいほど効果は大きい。

特に複数プロジェクトを抱える組織だと、共通のベースイメージを作っておくだけで後々の工数削減につながります。

室谷代表取締役

そう。長期的に見ればROIは間違いなくプラス。

Cursorのエンタープライズプランと併用すれば、ユーザー管理やライセンス管理も一元化できるので、総合的に見て導入しない理由はないですね。

テキトー教師DotAI 認定講師

導入初期に「なぜ動かない」というトラブルに遭遇することはありますが、フォーラムやドキュメントで情報を集めながら進めれば問題ないでしょう。

よくある質問

Q1. DevContainerとWSL2の違いは？結局どっちを使えばいい？

室谷代表取締役

WSL2はWindows上でLinuxを動かす仕組みで、DevContainerはその上に開発環境をコンテナで閉じ込める仕組みです。目的が違うので併用が前提ですね。

テキトー教師DotAI 認定講師

そうそう。WSL2でLinuxカーネルを動かして、その中でDockerを起動し、DevContainerで開発環境を統一するのがスムーズです。

「WSL2かDevContainerか」ではなく「WSL2＋DevContainer」が安定します。

Q2. DevContainerを使うとき、CursorのProプランは必須ですか？

室谷代表取締役

必須ではないですよ。基本機能はFreeでも使えます。

ただ、エージェントモードや大量のコンテキストを扱うならProの方が快適。コンテナ内でAIがコード生成する時、応答速度に差が出ます。

テキトー教師DotAI 認定講師

現場感覚で言うと、初めての人はFreeで十分。慣れてきて「もっとAIにがっつり作業させたい」となったらProにアップグレードする流れが無駄ないです。

Q3. DevContainer内で日本語入力がうまく動かないんだけど…

テキトー教師DotAI 認定講師

これはハマる人多いですね。コンテナのロケール設定が原因です。

devcontainer.jsonで"containerEnv": {"LANG": "ja_JP.UTF-8"}と追記すると改善します。

室谷代表取締役

あと、ホスト側のIMEがコンテナ内に正しくフォーカスされないケースもあります。その場合はCursorの設定で"terminal.integrated.gpuAcceleration": "off"にすると直ることがありますよ。

Q4. リモートSSH経由でDevContainerを使うと遅い。何か対策は？

室谷代表取締役

SSHのKeepAlive設定や、圧縮オプションを有効にすると体感変わります。~/.ssh/configでServerAliveInterval 60とCompression yesを入れてみてください。

テキトー教師DotAI 認定講師

あと、エクステンションの同期をオフにするのも手です。リモート側で無駄な拡張機能が動くと遅くなるので、最低限のものだけに絞る。

Q5. チームでDevContainerの設定を共有するときのベストプラクティスは？

テキトー教師DotAI 認定講師

devcontainer.jsonとDockerfileをリポジトリに含めて、全員が同じ.devcontainerフォルダを参照する形がシンプルです。あとは.envファイルで個人差を吸収すると衝突しません。

室谷代表取締役

うちの現場では、さらに.devcontainer/devcontainer.jsonに"extensions"で推奨拡張を指定してます。新規メンバーが入っても、開くだけで環境が揃うのでオンボーディングコストが半減しました。

まとめ

室谷代表取締役

DevContainerとCursorの組み合わせ、本当に開発体験が変わりますよね。環境構築に時間を取られず、コードに集中できるのが最大のメリットです。

テキトー教師DotAI 認定講師

最初の設定さえ乗り越えれば、あとは快適そのもの。トラブルも今回の話でほぼ解決できるはずです。

室谷代表取締役

経営目線で言うと、開発者一人当たりのセットアップ時間が減るので、ROIはすぐに出ます。チームで導入するなら、まずはパイロットプロジェクトで試すのが現実的ですね。

テキトー教師DotAI 認定講師

そうですね。一度使うと戻れなくなりますよ。

まずは簡単なプロジェクトで試してみてください。

室谷代表取締役

では、今日の話を参考に、ぜひDevContainer環境を整えてみてください。質問があればコミュニティで聞くのも手です。

それでは。