初心者向け・ステップバイステップ解説
このガイドでは、VS Code というエディタを使って、リモートサーバー上で Claude Code(AI コーディングアシスタント)を利用する方法を解説します。
1 VS Code をインストール
2 Remote SSH 拡張機能を追加
3 サーバーに SSH 接続
4 Claude Code 拡張機能を追加
5 Claude Code を使い始める
| 必要なもの | 説明 |
|---|---|
| パソコン | Windows / Mac / Linux いずれでもOK |
| インターネット接続 | 安定した回線を推奨 |
| サーバー接続情報 | 管理者から以下の情報を受け取ってください: ・サーバーのIPアドレス ・ユーザー名 ・パスワード(またはSSH鍵) |
1 ブラウザで以下のURLにアクセスします:
https://code.visualstudio.com/
2 お使いのOS(Windows / Mac / Linux)に合ったボタンをクリックしてダウンロードします。
3 ダウンロードしたファイルを開いて、画面の指示に従ってインストールします。
VS Code からリモートサーバーに接続するための拡張機能をインストールします。
1 VS Code を起動します
2 左側のサイドバーにある 拡張機能アイコン(四角が4つ並んだマーク)をクリックします。
または、キーボードで以下を押します:
Ctrl + Shift + XCmd + Shift + X3 検索バーに Remote - SSH と入力します
4 「Remote - SSH」(Microsoft 提供)が表示されるので、「Install」ボタンをクリックします
いよいよサーバーに接続します。管理者から受け取った接続情報を手元に用意してください。
1 VS Code の左下にある 緑色のアイコン「><」をクリックします
2 表示されたメニューから 「Connect to Host...」 を選択します
3 「+ Add New SSH Host...」 を選択します
4 以下の形式で入力します:
ssh ユーザー名@サーバーのIPアドレス
例:
ssh member1@123.456.78.90
5 SSH 設定ファイルの保存先を聞かれたら、最初の選択肢(デフォルト)を選びます
6 再度、左下の緑色アイコンをクリック → 「Connect to Host...」 → 先ほど追加したサーバーを選択
7 初回接続時に以下が表示されます:
1 メニューから 「File」→「Open Folder...」 を選択
2 管理者から指定されたフォルダのパスを入力して 「OK」 をクリック
例: /home/member1/project-a
1 拡張機能アイコン(四角が4つ)をクリック、または:
Ctrl + Shift + XCmd + Shift + X2 検索バーに Claude Code と入力します
3 「Claude Code」(Anthropic 提供)の 「Install in SSH: ...」 ボタンをクリックします
※「Install」ではなく「Install in SSH: ...」を選んでください。これによりサーバー側にインストールされます。
4 インストール完了後、左側のサイドバーに Claude Code のアイコンが表示されます
1 左側のサイドバーにある Claude Code アイコンをクリック
または、キーボードで:
Ctrl + Shift + P → 「Claude Code: Open」と入力Cmd + Shift + P → 「Claude Code: Open」と入力チャット欄に日本語で指示を入力するだけでOKです。
| やりたいこと | 入力例 |
|---|---|
| コードの説明を聞く | 「この関数が何をしているか説明して」 |
| バグの修正 | 「このエラーを修正して」 |
| 新しい機能を作る | 「ユーザー一覧を表示するAPIを作って」 |
| テストを書く | 「この関数のテストを書いて」 |
| コードレビュー | 「このファイルをレビューして」 |
| 症状 | 原因 | 対処法 |
|---|---|---|
| SSH接続できない | IP・ユーザー名・パスワードの間違い | 接続情報を管理者に再確認してください |
| 「Connection timed out」と出る | ネットワークの問題 / サーバーが停止中 | インターネット接続を確認し、管理者にサーバーの状態を確認してください |
| Claude Code が表示されない | ローカルにインストールしてしまった | 「Install in SSH: ...」でリモート側に再インストールしてください |
| Claude Code が応答しない | レートリミットに達した | しばらく待ってから再試行してください(チーム全体で共有しているため) |
| ファイルが保存できない | 権限がない | 管理者に書き込み権限の付与を依頼してください |
| 接続が頻繁に切れる | ネットワークが不安定 | Wi-Fi を安定した回線に切り替えてください。VS Code は自動再接続します |
git pull