【VS Code】SSH接続が突然「EISDIR: illegal operation on a directory」で失敗した時の対処法

2026.09.10

この記事は約5分で読めます。

VS Codeをアップデートした直後、急にSSH（Remote – SSH）でサーバーに繋がらなくなって焦った経験はありませんか？
「さっきまで普通に使えていたのに、なぜか接続が切れて再接続できない…」
画面右下には 「”ホスト名” への接続を確立できません」 という無情なアラート。
出力ログ（Remote – SSH）を確認してみると、こんなエラーが吐かれていることがあります。

Plaintext

Failed to read SSH configuration file '/': Error: EISDIR: illegal operation on a directory, read

Failed to read SSH configuration file '/': Error: EISDIR: illegal operation on a directory, read

一見するとサーバー側の障害やネットワークトラブルを疑ってしまいますが、原因はVS Code本体の「設定ファイルの参照パス誤り」にあります。

この記事では、この EISDIR エラーが発生する原因と、5分で確実に復旧するための3つのステップ をわかりやすく解説します！

なぜ起きる？ EISDIR エラーの正体
【完全復旧】3ステップで解決する手順
まとめ

なぜ起きる？ EISDIR エラーの正体

EISDIR とは Node.js のエラー用語で 「Error: Is a Directory（指定されたパスがファイルではなくディレクトリです）」 を意味します。
つまり、VS Code が SSH の接続設定ファイル（config）を読み込もうとした際、「設定ファイルを探したら、ファイルではなく /（ルートディレクトリ）が指定されていた」 ために処理が停止してしまっているのが原因です。
VS Code の本体アップデートや設定同期（Settings Sync）の不具合により、Remote.SSH: Config File の項目に誤って / が入ってしまうことでこの現象が発生します。

【完全復旧】3ステップで解決する手順

復旧作業は非常に簡単です。以下の3ステップを順番にお試しください。

STEP 1： VS Code の configFile 設定を空欄にする

一番の根本原因である「設定ファイルの誤指定」を修正します。

VS Code で Ctrl + ,（Macは Cmd + ,）を押して 設定（Settings） を開く。
上部の検索窓に remote.SSH.configFile と入力。
Remote.SSH: Config File の入力欄に入っている / を削除して空欄 にする。

💡 補足:
ここを空欄にしておくと、VS Code はデフォルトの SSH 設定ファイル（Windows: C:\Users\<User_name>\.ssh\config / Mac・Linux: ~/.ssh/config）を自動的に参照してくれるようになります。

STEP 2：サーバー側のキャッシュを初期化する

設定を直しても接続がうまくいかない場合、サーバー側に残っている古い vscode-server のプロセスやキャッシュが干渉している可能性があります。
Tera Term、macOS標準ターミナル、または既存の別SSHクライアントからサーバーにログインし、以下のコマンドでキャッシュを更地にします。

Bash

# サーバー側の管理用隠しフォルダを削除
rm -rf ~/.vscode-server

# 残存プロセスを確実にキル
pkill -f vscode-server

# サーバー側の管理用隠しフォルダを削除
rm -rf ~/.vscode-server

# 残存プロセスを確実にキル
pkill -f vscode-server

Bash

# Remove the hidden VS Code management directory on the server
rm -rf ~/.vscode-server

# Forcefully terminate any remaining VS Code server processes
pkill -f vscode-server

# Remove the hidden VS Code management directory on the server
rm -rf ~/.vscode-server

# Forcefully terminate any remaining VS Code server processes
pkill -f vscode-server