Codex App SSH 远程开发教程:本地连接远程服务器项目

Codex App SSH 远程开发教程:本地连接远程服务器项目
推荐试用以下开源项目更快速便捷地做 Codex App SSH 多服务器群远程开发https://jurio.blog.csdn.net/article/details/162584556项目地址https://github.com/Jurio0304/CodexHubRelease 下载https://github.com/Jurio0304/CodexHub/releases如果你的代码、数据、Conda 环境或 GPU 都在远程 Linux 服务器上而你希望在本地 Windows / macOS 上使用 Codex App 直接开发远程项目可以使用 Codex App 的 SSH 远程连接功能。简单来说它的作用是本地 Codex App ↓ 读取本机 SSH 配置 ↓ 连接远程服务器 ↓ 在远程项目目录中读写代码、运行命令也就是说Codex App 的界面运行在本地但实际项目文件、命令执行和环境调用都发生在远程服务器上。一、适用场景Codex App SSH 远程开发适合以下情况本地电脑性能有限远程服务器有 GPU项目代码和数据都在服务器上希望 Codex 直接修改远程代码、运行测试、排查环境问题远程服务器已经配置好 Conda、CUDA、PyTorch、数据库等环境希望通过一个本地 Codex App 管理多个远程项目。二、准备条件开始前需要准备项目说明本地电脑Windows 或 macOS已安装 Codex App远程服务器Linux 服务器可通过 SSH 登录SSH 密钥推荐使用 ed25519 密钥SSH config本机~/.ssh/config中配置具体 Host远程 Codex CLI远程服务器上可以运行codex命令Codex 认证远程服务器上的 Codex 已登录三、本地配置 SSH1. 检查 OpenSSHWindows PowerShell 或 macOS 终端中执行ssh-V如果能看到 OpenSSH 版本信息说明已经安装。2. 生成 SSH 密钥Windows PowerShellmkdir$HOME\.ssh-Force ssh-keygen-t ed25519-Ccodex-appmacOS / Linuxmkdir-p~/.sshchmod700~/.ssh ssh-keygen-ted25519-Ccodex-app默认会生成~/.ssh/id_ed25519 ~/.ssh/id_ed25519.pub其中id_ed25519是私钥不要泄露id_ed25519.pub是公钥可以添加到远程服务器。四、把公钥添加到远程服务器假设服务器信息如下远程用户your_user 服务器地址your.server.com SSH 端口22Windows PowerShelltype$HOME\.ssh\id_ed25519.pub|ssh your_useryour.server.commkdir -p ~/.ssh chmod 700 ~/.ssh cat ~/.ssh/authorized_keys chmod 600 ~/.ssh/authorized_keysmacOS / Linuxcat~/.ssh/id_ed25519.pub|sshyour_useryour.server.commkdir -p ~/.ssh chmod 700 ~/.ssh cat ~/.ssh/authorized_keys chmod 600 ~/.ssh/authorized_keys第一次连接时如果出现Are you sure you want to continue connecting (yes/no/[fingerprint])?确认服务器无误后输入yes五、配置本机 SSH configCodex App 会读取本机~/.ssh/config中的 Host 别名因此需要先配置 SSH Host。Windows 路径C:\Users\你的用户名\.ssh\config可用 PowerShell 打开notepad$HOME\.ssh\configmacOS / Linux 路径~/.ssh/config可用终端编辑nano~/.ssh/config写入如下内容Host remote-dev HostName your.server.com User your_user Port 22 IdentityFile ~/.ssh/id_ed25519 IdentitiesOnly yes字段说明字段说明Host本地 SSH 别名也是 Codex App 识别的名称HostName服务器 IP 或域名User远程用户名PortSSH 端口IdentityFile本地私钥路径IdentitiesOnly只使用指定私钥Windows 下注意文件名必须是config不要保存成config.txt。六、测试 SSH 连接在本地终端执行sshremote-dev如果能成功进入远程服务器说明 SSH 配置基本正确。继续测试非交互命令sshremote-devpwd whoami hostnameWindows PowerShellssh remote-devpwd whoami hostname如果这一步失败Codex App 中也无法正常连接该远程服务器。七、在远程服务器安装 Codex CLI登录远程服务器sshremote-dev安装 Codex CLIcurl-fsSLhttps://chatgpt.com/codex/install.sh|sh安装后检查whichcodex codex--version如果能看到codex的路径和版本号说明安装成功。八、远程服务器登录 Codex在远程服务器执行codex login如果远程服务器没有浏览器可以尝试codex login --device-auth如果仍然不方便登录也可以在安全前提下复制本地认证文件到远程服务器sshremote-devmkdir -p ~/.codexscp~/.codex/auth.json remote-dev:~/.codex/auth.json注意auth.json包含访问凭证应当像密码一样保护不要提交到 Git也不要发给他人。九、确保远程 shell 能找到 codex这一步非常关键。不要只在远程终端中手动运行codex --version还要从本地测试sshremote-devcommand -v codex codex --version如果输出了codex路径和版本说明 Codex App 通过 SSH 启动远程服务时也大概率可以找到它。如果报错codex: command not found说明远程 shell 的 PATH 没有包含 Codex 所在目录。可以在远程服务器执行echoexport PATH$HOME/.local/bin:$PATH~/.profileechoexport PATH$HOME/.local/bin:$PATH~/.bashrc然后重新测试sshremote-devcommand -v codex codex --version十、在 Codex App 中添加 SSH 连接完成前面的配置后打开本地 Codex App进入Settings → Connections → SSH / Remote connections → Add or enable SSH host → 选择 remote-dev → 选择远程项目目录远程项目目录可以是/home/your_user/project_name /home/your_user/workspace/project_name进入项目后建议先发送一个安全测试请先不要修改任何文件。请依次执行 pwd、hostname、whoami、git status 和 ls -la然后总结当前项目目录、Git 状态和运行环境。如果返回的是远程服务器路径说明 Codex App 已经成功进入远程项目。十一、常见问题排查1. Codex App 看不到 SSH Host检查cat~/.ssh/configsshremote-devWindows PowerShellTest-Path$HOME\.ssh\configGet-Content$HOME\.ssh\config ssh remote-dev常见原因config文件不存在Windows 下误保存成了config.txtHost没有写成具体别名修改 SSH config 后没有重启 Codex App。推荐写法Host remote-dev HostName your.server.com User your_user2. SSH 提示 Permission denied常见原因公钥没有添加到远程服务器IdentityFile指向了错误私钥远程用户名写错.ssh权限不正确。远程服务器权限建议chmod700~/.sshchmod600~/.ssh/authorized_keysmacOS / Linux 本地私钥权限建议chmod600~/.ssh/id_ed255193. Codex App 报 codex command not found本地执行sshremote-devcommand -v codex codex --version如果失败远程服务器上补充 PATHechoexport PATH$HOME/.local/bin:$PATH~/.profileechoexport PATH$HOME/.local/bin:$PATH~/.bashrc4. Conda 环境不可用如果 Codex 运行命令时报conda: command not found可以在远程服务器执行conda initbash也可以在任务中明确告诉 Codex运行项目前请先执行 source ~/miniconda3/etc/profile.d/conda.sh conda activate your_env_name 然后再运行测试命令。十二、安全建议Codex App SSH 远程开发会让 Codex 在远程服务器上读写文件和执行命令因此建议不要使用 root 用户运行 Codex不要把~/.codex/auth.json提交到 Git不要把 Codex 相关服务端口直接暴露到公网优先通过 SSH、VPN、内网或 Tailscale 等方式访问远程服务器让 Codex 修改代码前先确认当前 Git 状态。推荐每次开始前先执行gitstatus必要时提前创建新分支gitcheckout-bcodex/remote-task十三、最终检查清单在 Codex App 中连接远程项目之前建议依次检查sshremote-devsshremote-devpwd whoami hostnamesshremote-devcommand -v codex codex --versionsshremote-devls -la /home/your_user/project_namesshremote-devcd /home/your_user/project_name git status如果以上命令都正常再打开 Codex AppSettings → Connections → SSH → remote-dev → 选择远程项目目录总结Codex App SSH 远程开发的关键链路是本机 SSH config 配置正确 ↓ 本地 ssh remote-dev 可以连接服务器 ↓ 远程服务器已安装并登录 Codex ↓ 本地可以通过 SSH 找到远程 codex 命令 ↓ Codex App 识别 SSH Host ↓ 选择远程项目目录开始开发其中最重要的测试命令是sshremote-devcommand -v codex codex --version只要这一步能成功Codex App 的 SSH 远程开发通常就已经完成了大部分准备工作。推荐试用以下开源项目更快速便捷地做 Codex App SSH 多服务器群远程开发https://jurio.blog.csdn.net/article/details/162584556项目地址https://github.com/Jurio0304/CodexHubRelease 下载https://github.com/Jurio0304/CodexHub/releases