Dushiqi1987/codex-remote-Skill

选用指南

AI 根据 README 整理 · 2026/10/14 18:50:56 · 基于较早版本，请核对最新 README

适用场景

适用于在 AutoDL 等平台租用 GPU 服务器，但服务器网络无法连接 Codex 服务，而本地电脑有可用代理或直连网络的情况。

查看 README 依据

# 本地 Codex 连接服务器 Codex CLI **让 GPU 服务器上的 Codex CLI，通过 SSH 反向隧道共享本地电脑的网络出口。** Agent skill for sharing a local HTTP proxy or a directly reachable network with a remote Codex CLI over an SSH reverse tunnel. Python standard library only; Windows local machine + Linux GPU server. 大学生、研究生常在 AutoDL 等平台租用 GPU 训练模型。某些服务器的网络无法连接 Codex 服务，而自己的电脑具备可用的代理软件或网络。本项目把配置过程整理成可复用的 skill，附带端口转发、代理配置、验证和回滚脚本。 它共享的是网络出口。Codex CLI 仍然运行在服务器上，直接处理服务器上的代码、数据和训练任务；本地 Codex 和服务器 Codex 不会因此共享对话或账号登录状态。 ## 两种方案 | 本地条件 | 本地 HTTP 端口 | 是否运行 Python 转发器 | | --- | --- | --- |

目标用户

面向大学生、研究生等需要在 GPU 服务器上使用 Codex CLI 的用户。

查看 README 依据

# 本地 Codex 连接服务器 Codex CLI **让 GPU 服务器上的 Codex CLI，通过 SSH 反向隧道共享本地电脑的网络出口。** Agent skill for sharing a local HTTP proxy or a directly reachable network with a remote Codex CLI over an SSH reverse tunnel. Python standard library only; Windows local machine + Linux GPU server. 大学生、研究生常在 AutoDL 等平台租用 GPU 训练模型。某些服务器的网络无法连接 Codex 服务，而自己的电脑具备可用的代理软件或网络。本项目把配置过程整理成可复用的 skill，附带端口转发、代理配置、验证和回滚脚本。 它共享的是网络出口。Codex CLI 仍然运行在服务器上，直接处理服务器上的代码、数据和训练任务；本地 Codex 和服务器 Codex 不会因此共享对话或账号登录状态。 ## 两种方案 | 本地条件 | 本地 HTTP 端口 | 是否运行 Python 转发器 | | --- | --- | --- |

使用方式

通过 Skills CLI 安装到 Codex，或手动复制文件夹到 skill 目录；使用时向本地 Codex 发出指令，或手动执行脚本。

查看 README 依据

- 本地：Windows PowerShell、OpenSSH 客户端（`ssh -V`）、可访问目标服务的出口。直接网络方案还需要 Python 3.9+。 - 服务器：Linux、SSH 允许远程 TCP 转发、Python 3.9+（使用附带配置脚本时）、已安装 Codex CLI（`codex --version`）。 - 从租赁平台获得自己的 SSH 主机、SSH 连接端口、用户名。示例中的主机和端口都应替换为自己的参数。 - Codex 需要独立有效的登录或 API 凭据。网络通道不解决账号权限、额度和服务地区支持问题。 ## 安装这个 skill 使用 Skills CLI 一条命令安装到 Codex（需要 Node.js 18+ 和可访问 GitHub 的网络）： ```powershell npx skills add Dushiqi1987/codex-remote-bridge --skill codex-remote-bridge -g -a codex -y ``` 也可以克隆后手动安装： ```powershell git clone https://github.com/Dushiqi1987/codex-remote-bridge.git ```

克隆或下载此仓库后，将**整个文件夹**复制到 Codex 的 skill 目录；保持脚本和参考文档一起安装。 Windows 本地示例（在仓库的父目录执行；目标已存在时先检查，避免覆盖）： ```powershell Copy-Item -LiteralPath .\codex-remote-bridge -Destination "$env:USERPROFILE\.codex\skills\codex-remote-bridge" -Recurse ``` Linux 示例： ```bash mkdir -p ~/.codex/skills cp -R ./codex-remote-bridge ~/.codex/skills/ ``` 若你的客户端使用 `~/.agents/skills` 或自定义目录，将同一文件夹放到对应位置。新安装的 skill 在下一轮对话中可用；未显示时重新打开客户端。 可直接向本地 Codex 说： > 使用 $codex-remote-bridge 帮我连接服务器上的 Codex CLI。我的 SSH 命令是 ssh -p 你的端口 root@你的主机；本地代理软件的 HTTP 端口是 7890。 或者：

部署要求

本地需要 Windows PowerShell、OpenSSH 客户端；服务器需要 Linux、SSH 允许远程 TCP 转发、Python 3.9+ 和已安装 Codex CLI；Codex 需要独立有效的登录或 API 凭据。

查看 README 依据

- 本地：Windows PowerShell、OpenSSH 客户端（`ssh -V`）、可访问目标服务的出口。直接网络方案还需要 Python 3.9+。 - 服务器：Linux、SSH 允许远程 TCP 转发、Python 3.9+（使用附带配置脚本时）、已安装 Codex CLI（`codex --version`）。 - 从租赁平台获得自己的 SSH 主机、SSH 连接端口、用户名。示例中的主机和端口都应替换为自己的参数。 - Codex 需要独立有效的登录或 API 凭据。网络通道不解决账号权限、额度和服务地区支持问题。 ## 安装这个 skill 使用 Skills CLI 一条命令安装到 Codex（需要 Node.js 18+ 和可访问 GitHub 的网络）： ```powershell npx skills add Dushiqi1987/codex-remote-bridge --skill codex-remote-bridge -g -a codex -y ``` 也可以克隆后手动安装： ```powershell git clone https://github.com/Dushiqi1987/codex-remote-bridge.git ```

已知限制

本地电脑休眠、网络切换或 SSH 退出会导致连接中断；两端只绑定回环地址，但同一服务器上的其他用户仍可能访问回环端口。

查看 README 依据

测试使用本机回环上的测试服务，验证代理的请求体、CONNECT、分块流式响应、Upgrade 和配置备份；不需要账号或真实服务器。测试通过不代表已经在你的 GPU 服务器上完成端到端验收。 ## 故障排查与参考 详细排查见 [troubleshooting.md](references/troubleshooting.md)。本地电脑休眠、网络切换或 SSH 退出都会让服务器失去这个出口；重新启动监听和隧道即可恢复。 两端只绑定回环地址，但同一服务器上的其他用户仍可能访问回环端口。不要公开 `.env`、`auth.json`、API 密钥或 SSH 私钥。本项目不更改模型提供商、TLS 校验、Codex sandbox 或审批设置。 参考资料（核对日期：2026-10-12）： - [Codex 官方配置基础](https://learn.chatgpt.com/docs/config-file/config-basic)：持久设置使用 `config.toml`。 - [Codex 官方环境变量说明](https://learn.chatgpt.com/docs/config-file/environment-variables)：环境变量用于进程和 shell 配置；该页面未对所有版本的 `.env` 自动加载或通用 HTTP 代理行为给出保证。