CodexでSSH接続する4ステップ｜Windows初心者が迷ったポイントも解説

Codexは、SSHホスト上にあるプロジェクトへ接続して、リモート側のファイルを確認したり、変更を書き込んだり、コマンドを実行したりできます。

CodexでSSH接続する基本的な流れは、次の4ステップです。

1. SSH設定に接続先を登録する
2. WindowsからSSH接続できることを確認する
3. リモート側でCodexを使える状態にする
4. CodexからSSHホストを追加してプロジェクトを開く

手順だけを見ると難しそうですが、一つずつ確認していけば、どこで問題が起きているのか切り分けやすくなります。

私も自分用のアクセス解析ツールを作ったとき、WindowsのPowerShellからSSH接続してサーバー側の作業を進めました。SSHもPowerShellも慣れていなかったため、接続先や作業場所が分からなくなり、何度か確認し直した経験があります。

この記事では、2026年9月時点のOpenAI公式情報をもとに、CodexでSSH接続する流れを4ステップで整理します。あわせて、実際にSSHを使ってサーバー作業をしたときにWindows初心者として迷ったポイントも紹介します。

Codexを使い始めてから自作ツールが形になるまでの流れは、Codexを使ってみた｜5日間で自分用アクセス解析ツールができるまででまとめています。

CodexはSSH接続してリモート環境で作業できる

最初に知っておきたいのは、現在のCodexではSSHを利用したリモート環境での作業が公式に案内されていることです。

SSHホスト上のプロジェクトを扱える

OpenAI公式のリモート接続機能では、デスクトップアプリからSSHホスト上にあるプロジェクトを追加できます。

接続したリモートプロジェクトでは、ファイルを読み取るだけではなく、変更の保存やコマンドの実行も行えます。

つまり、Windowsパソコンの中だけでCodexを使うのではなく、SSHで接続できる別のコンピューターやサーバーまで作業範囲を広げられるということです。

OpenAI公式の「リモート接続」にも、SSHホストへの接続手順が掲載されています。

SSHそのものはCodex専用の仕組みではない

ここは最初に整理しておいた方が分かりやすいところです。

SSHはCodex専用の接続方法ではありません。離れた場所にあるコンピューターへ安全に接続して操作するために以前から使われている仕組みです。

私がアクセス解析ツールを作っていたときも、PowerShellからSSH接続してサーバー側を確認する場面が何度もありました。

「Codex SSH接続」と聞くと特殊な操作のように感じますが、基本になるのは通常のSSH接続です。そのSSH環境の上でCodexを利用すると考えると理解しやすくなります。

SSHはCodex以外のツールでも使います。実際に私がOpenClawをVPSで使ったときもSSH接続が必要になりました。別の利用例も見てみたい方は、OpenClawをVPSで使うときにつまずきやすいポイントをまとめた記事も参考になります。

CodexでSSH接続する前に確認しておきたいこと

4ステップへ進む前に、接続先のSSH情報を確認しておきます。

SSHで接続できる環境か確認する

まず確認したいのは、接続先がSSHに対応しているかどうかです。

接続には、ホスト名、ユーザー名、認証方法などの情報が必要になります。環境によっては通常とは異なるポート番号を指定する場合もあります。

Codexの設定を始める前に、必要な接続情報を整理しておくと後の作業が進めやすくなります。

接続先と作業フォルダを分けて考える

私が最初に戸惑ったのが、「どこへ接続するのか」と「接続後にどこで作業するのか」の違いでした。

ホスト名やユーザー名はサーバーへ接続するための情報です。一方、接続後に編集するファイルやフォルダはサーバー内の作業場所になります。

この2つを分けて整理しておくと、SSH接続後の操作も追いやすくなります。

CodexでSSH接続する4ステップ

準備ができたら、CodexでSSH接続する流れを4ステップで確認していきます。

ステップ1：SSH設定に接続先を登録する

最初に、Codexが接続先を認識できるようにSSH設定へホストを登録します。

OpenAI公式では、次のような形でSSH設定へ接続先を追加する方法が案内されています。

Host devbox
  HostName devbox.example.com
  User you
  IdentityFile ~/.ssh/id_ed25519

これは説明用の例なので、実際には利用しているサーバーの情報へ置き換えます。

Hostには自分が識別しやすい名前を付けておくと、複数の接続先を扱うようになったときにも区別しやすくなります。

ステップ2：WindowsからSSH接続できることを確認する

次に、Codexを使う前にWindows側から通常のSSH接続を確認します。

先ほどdevboxという名前で登録した場合は、PowerShellなどから次のように実行します。

ssh devbox

ここで接続できれば、少なくともWindowsからSSHホストまでの接続はできています。

反対に、この段階で接続できなければ、Codexの設定を変更する前にSSH設定を見直した方が原因を切り分けやすくなります。

ステップ3：リモート側でCodexを使える状態にする

SSH接続を確認できたら、接続先でもCodexを使えるように準備します。

OpenAI公式では、リモートホストにもCodexをインストールして認証し、ログインシェルからcodexコマンドを実行できるようにしておく手順が案内されています。

ここで確認したいのがPATHです。

難しく感じる言葉ですが、この場面では「接続先の環境からcodexというコマンドを見つけて実行できる状態か」と考えると分かりやすくなります。

Codex CLIのインストールや認証については、OpenAI公式のCodex CLIも確認してください。

ステップ4：CodexからSSHホストを追加してプロジェクトを開く

リモート側の準備が終わったら、CodexのデスクトップアプリからSSHホストを追加します。

設定から接続先を選び、作業したいリモート側のプロジェクトフォルダを開きます。

ここまで完了すれば、SSHホスト上にあるファイルを確認したり、コードを変更したり、必要なコマンドを実行したりできるようになります。

4ステップをまとめると、「接続先を登録する→通常のSSH接続を確認する→リモート側にCodexを準備する→Codexからプロジェクトを開く」という流れです。

実際にSSHを使ったサーバー作業で迷ったこと

ここからは、OpenAI公式のRemote SSH機能そのものではなく、私がアクセス解析ツールを作ったときにPowerShellからSSH接続して感じたことです。

最初はPowerShellの画面だけでも難しく感じた

私は今回の開発を始めるまで、PowerShellを日常的に使っていたわけではありません。

黒い画面にコマンドを入力し、文字だけで結果が返ってくるため、最初は「今どこを操作しているのか」が分かりにくく感じました。

特にSSHでサーバーへ入った後は、手元のWindowsを操作しているのか、接続先のサーバーを操作しているのかを意識する必要があります。

慣れるまでは、コマンドを続けて入力するより、現在地や表示された結果を一つずつ確認した方が安全でした。

接続情報と作業場所を分けて考えると整理しやすかった

SSHでは、ホスト名、ユーザー名、認証情報などの「接続するための情報」と、接続した後に操作するフォルダやファイルがあります。

初心者のうちは、この2つを一緒に考えてしまいがちです。

私の場合も、「どこへ接続しているのか」と「接続後にどのファイルを触っているのか」を分けて確認するようにしてから、作業内容を追いやすくなりました。

分からない表示はそのまま進めない方がよかった

SSH接続やサーバー作業では、普段見ない確認メッセージや警告が表示されることがあります。

内容が分からないまま操作を続けるより、表示された内容を確認し、何を許可しようとしているのか理解してから進める方が安全です。

今回の開発では、CodexやChatGPTに状況を伝えながら一つずつ確認することで、操作の意味を理解しやすくなりました。

CodexのSSH接続でうまくいかないときの確認ポイント

SSH接続でエラーが出た場合は、一度に設定を変更するより、接続までの流れを順番に切り分けた方が原因を見つけやすくなります。

通常のSSH接続には問題がなく、Codex側で起動・認証・権限・通信などのエラーが出ている場合は、Codexがエラーで動かない原因9つと対処法もあわせて確認してください。

まず通常のSSH接続を確認する

最初に確認したいのは、Codexを使わない状態でもSSH接続できるかどうかです。

通常のSSH接続ができていなければ、Codex側の設定を変更しても解決しない可能性があります。

反対に、通常のSSH接続が正常なら、次はCodexのインストール状態や認証、PATH、デスクトップアプリ側の接続設定を確認できます。

リモート側でcodexコマンドが使えるか確認する

OpenAI公式では、リモートユーザーのログインシェルからcodexコマンドを利用できる必要があるとされています。

Codexをインストールしたつもりでも、リモート環境からコマンドを見つけられなければ正常に起動できません。

接続はできるのにCodex側で進めない場合は、この部分も確認対象になります。

Codex CLI自体の基本操作がまだ分からない場合は、先にCodex CLIの使い方をPowerShell初心者向けに8ステップで解説した記事を確認しておくと、ローカル側とリモート側の違いも整理しやすくなります。

認証で止まった場合は公式の認証方法を確認する

ブラウザを直接開きにくいリモート環境では、通常のログイン方法が使いにくい場合があります。

OpenAI公式では、リモートマシンやヘッドレス環境向けにデバイスコードを使った認証方法なども案内されています。

認証方法を自己流で変更するより、利用している環境に合った公式手順を確認して進める方が安全です。

CodexでSSH接続するときに気をつけたいこと

SSHでリモート環境を操作できるようになると便利ですが、ローカル環境より慎重に扱いたい場面も増えます。

本番サーバーでは変更前に対象を確認する

サーバー側では、間違ったファイルを変更した場合の影響がローカル環境より大きくなることがあります。

そのため、コマンドや変更内容を確認せずに続けて実行するのではなく、「どの環境の、どのファイルを変更するのか」を確認してから進める方が安全です。

Codexに作業を依頼する場合も、対象範囲を明確にしておくと意図しない変更を避けやすくなります。

必要以上の権限で接続しない

OpenAI公式でも、SSHホストでは信頼できる鍵と最小権限のアカウントを使うことが案内されています。

何でも変更できる大きな権限を最初から与えるのではなく、必要な作業に合わせて権限を考える方が安全です。

Codex App Serverをそのままインターネットへ公開しない

OpenAIは、Codex App Serverの通信を共有ネットワークやパブリックネットワークへ直接公開しないよう案内しています。

現在のネットワーク外からリモート環境へ接続する場合には、App Serverを直接インターネットへ公開するのではなく、VPNやメッシュネットワークを利用する方法が案内されています。

「接続できればいい」ではなく、どの経路で接続しているのかまで確認しておきたいところです。

初心者がCodexとSSHを使うなら一つずつ確認した方が進めやすい

SSHは、最初から仕組みをすべて理解しようとすると難しく感じます。私の場合も、実際の作業を一つずつ進める中で少しずつ役割が分かってきました。

Codexに全部任せるのではなく結果を確認する

Codexを使うと、コマンドの確認やコード変更をかなり進めやすくなります。

ただし、サーバー作業では「Codexが実行してくれるから大丈夫」と考えるのではなく、実行対象と結果を自分でも確認する方が安心です。

特に本番環境に関係する作業では、一つ変更したら結果を確認して次へ進むくらいのペースでも遅くありません。

ローカルとリモートを分けて考える

SSHを使い始めて特に重要だと感じたのが、ローカル環境とリモート環境を分けて考えることです。

自分のWindowsパソコンにあるファイルなのか、SSH接続先にあるファイルなのか。

現在どちらでコマンドを実行しているのか。

ここが曖昧になると、作業そのものが合っていても不安になります。

画面上の現在地や対象ファイルを確認しながら進めるだけでも、かなり整理しやすくなりました。

作業記録を残しておくと再開しやすい

SSHを使う作業では、接続確認、ファイル確認、変更、反映確認など複数の工程が続きます。

途中で作業を止める場合は、「どこまで終わったのか」「次に何を確認するのか」を残しておくと再開しやすくなります。

私がCodexを使って自分用ツールを作ったときも、作業を細かく分けて進めたことで、途中からでも再開しやすくなりました。全体の制作過程は、Codexを使ってみた｜5日間で自分用アクセス解析ツールができるまででも紹介しています。

まとめ

CodexはSSHホスト上のプロジェクトへ接続し、リモート環境のファイル確認や変更、コマンド実行まで行えます。

OpenAI公式の基本的な流れは、SSH設定へのホスト登録、通常のSSH接続確認、リモート側へのCodexのインストールと認証、デスクトップアプリでのSSHホスト追加です。

私自身、アクセス解析ツールの開発で初めてPowerShellからSSHを使ったときは、接続先やコマンドの意味が分からず迷う場面がありました。

それでも、「今どこへ接続しているのか」「どのファイルを操作するのか」「実行後に何が変わったのか」を一つずつ確認していけば、SSHも少しずつ扱いやすくなります。

CodexとSSHを組み合わせると作業できる範囲は広がりますが、本番サーバーでは特に、Codexへすべて任せるのではなく、変更内容と権限を確認しながら進めることが重要です。