できない.dev

ターミナルから code コマンドで VSCode を起動できない

code: command not found は VSCode の CLI が PATH に登録されていないのが原因。
macOS はコマンドパレットから「Shell Command: Install 'code' command in PATH」を実行、Windows はインストーラーの PATH 追加とターミナル再起動で解決する。

#vscode#cli#path#command-not-found#terminal

公開:

要約

ターミナルで code . を実行して code: command not found(Windows では「'code' は、内部コマンドまたは外部コマンド…として認識されていません」)になるのは、VSCode の CLI が PATH に登録されていないためです。
macOS はアプリ本体を入れただけでは code コマンドが使えず、コマンドパレットからの登録操作が必要です(macOS のセットアップ手順)。
Windows はインストーラーが PATH を更新しますが、既に開いているターミナルには反映されません。

よくある原因

  1. macOS で登録操作をしていない: /Applications に VS Code.app を置いただけでは PATH に何も追加されない。
  2. Windows でターミナルを再起動していない: インストーラーは PATH を更新するが、起動済みのターミナルは古い PATH を持ち続ける(Windows のセットアップ手順)。
  3. PATH 追加オプションを外した: インストール時に「PATH への追加」のチェックを外すと code コマンドは登録されない。
  4. zip / portable 版: 展開しただけでは PATH に入らないため、手動設定が必要。
  5. 実行環境の取り違え: ホストに入れた VSCode は、SSH 接続先やコンテナ内のシェルからはそのままでは見えない。

解決策

1. macOS: Shell Command を実行する

VSCode でコマンドパレット(Cmd+Shift+P)を開き、shell command と入力して Shell Command: Install 'code' command in PATH を実行します。
その後ターミナルを開き直せば code が使えます。

2. Windows: ターミナルを再起動する

code --version

インストール直後に上記が失敗する場合は、まずターミナルを閉じて開き直します。
それでも見つからない場合は一度サインアウトまたは再起動して環境変数を再読み込みします。

3. 手動で PATH に追加する

ユーザーインストールの既定では %LOCALAPPDATA%\Programs\Microsoft VS Code\bin に CLI 用のスクリプトがあります。
このディレクトリを環境変数 PATH に追加すれば code コマンドが使えるようになります(macOS の zip 版は /Applications/Visual Studio Code.app/Contents/Resources/app/bin)。

4. WSL では初回に自動セットアップさせる

Windows 側に VSCode をインストールした状態で、WSL のシェルから code . を実行すると、必要なサーバーコンポーネントが自動で導入され、以後 WSL 内からも起動できます。

この記事は役立ちましたか?