解决vscode连接服务器后连不上codex和reconnect问题的完整教程

本文主要介绍在 VS Code Remote SSH 场景中，如何让远程服务器上的 VS Code 插件使用本地已配置好的网络代理服务，从而解决远程扩展无法正常访问网络的问题。

一、适用场景

很多人在本地使用 VS Code 通过 Remote SSH 连接服务器后，可能会遇到以下情况：

• 本地网络访问正常；

• 本地 Codex 插件或相关接口可以正常使用；

• 但远程服务器中的 VS Code 插件无法正常联网。

这是因为在 Remote SSH 模式 下，VS Code 插件实际运行在远程服务器上，而不是本地电脑上。因此，插件默认使用的是服务器的网络环境，而不是本机的网络环境。

解决思路如下：

二、前置条件

开始前请确认以下几点：

• 你已经可以通过 VS Code Remote SSH 正常连接服务器；

• 你的本地电脑已经配置好可用的 HTTP 代理服务；

• 你知道本地 HTTP 代理的端口号；

• 你的 VS Code 中已经安装好 Codex 插件。

本文示例端口为：

7897

实际使用时，请根据你本机代理工具中的 HTTP 端口号进行替换。

三、Step 1：修改 SSH 配置

首先打开本地 VS Code 的 SSH 配置文件，在对应服务器的 Host 配置下添加端口转发规则。

示例配置如下：

Host your-server
HostName xxx.xxx.xxx.xxx
User root
RemoteForward 7897 127.0.0.1:7897

其中：

RemoteForward 7897 127.0.0.1:7897

表示将远程服务器上的 7897 端口转发到本地电脑的 127.0.0.1:7897。

这里的 7897 需要替换成你本地 HTTP 代理服务的实际端口号。

注意事项

• 端口号需要和本地 HTTP 代理端口保持一致；

• 修改 SSH 配置后，建议断开并重新连接远程服务器；

• 如果你配置了多个远程主机，需要确认修改的是当前正在连接的那个 Host；

• 如果端口已经被占用，可以更换为其他未占用端口，但前后配置必须保持一致。

四、Step 2：让远程 VS Code 插件使用代理

确认已经连接到远程服务器后，打开 VS Code 命令面板：

Ctrl + Shift + P

输入并选择：

Preferences: Open Remote Settings (JSON)

注意：这里一定要打开 Remote Settings，也就是远程服务器环境下的设置，而不是本地 VS Code 的用户设置。

在打开的 settings.json 中添加如下内容：

{
"http.proxy": "http://127.0.0.1:7897",
"https.proxy": "http://127.0.0.1:7897"
}

如果你的本地 HTTP 代理端口不是 7897，请替换为自己的实际端口。

配置完成后，可以重新加载 VS Code 窗口，或者断开后重新连接远程服务器。

五、Step 3：配置 Codex 插件

进入远程服务器用户目录下的 .codex 文件夹。

一般路径类似于：

~/.codex

如果该目录不存在，可以手动创建：

mkdir -p ~/.codex

在该目录下通常需要配置以下两个文件：

config.toml
auth.json

方式一：使用 API 配置

如果你使用的是 API 方式登录，可以根据自己的服务配置填写 config.toml，并配置对应的认证信息。

示例结构如下：

model_provider = "OpenAI"
model = "your-model-name"

[model_providers.OpenAI]
name = "OpenAI"
base_url = "your-api-base-url"
wire_api = "responses"
requires_openai_auth = true

具体字段需要根据你自己的 API 服务说明进行填写。

方式二：使用账号登录配置

如果你使用的是账号登录方式，建议先在本地电脑中完成登录并确认插件可以正常使用。

然后将本地 .codex 目录中的配置文件复制到远程服务器对应目录下：

~/.codex/config.toml
~/.codex/auth.json

复制完成后，重新连接远程服务器，或重启 VS Code 中的 Codex 插件即可。

六、常见问题

1. 为什么本地能用，远程插件不能用？

因为 Remote SSH 模式下，插件运行在远程服务器上。远程插件默认使用服务器网络，而不是本地网络。

2. 修改配置后仍然无法连接怎么办？

可以依次检查：

• SSH 配置是否已经保存；

• 是否重新连接了远程服务器；

• RemoteForward 端口是否写对；

• VS Code 打开的是否是 Remote Settings；

• http.proxy 和 https.proxy 的端口是否一致；

• 本地 HTTP 代理服务是否正在运行。

3. 多台服务器都需要配置吗？

如果你有多台远程服务器，每个 Host 都需要根据实际情况添加对应的 RemoteForward 配置。

示例：

Host server-a
HostName xxx.xxx.xxx.xxx
User root
RemoteForward 7897 127.0.0.1:7897

Host server-b
HostName yyy.yyy.yyy.yyy
User root
RemoteForward 7897 127.0.0.1:7897

七、总结

在 VS Code Remote SSH 场景下，远程插件默认运行在服务器环境中，因此可能出现本地可用、远程插件不可用的情况。

通过以下三步即可完成配置：

完成后，远程服务器中的 VS Code 插件就可以按照指定的网络代理配置进行访问，更适合远程开发和服务器调试场景。