Codex Desktop安装配置教程：本地+远程服务器全攻略

下载安装Codex Desktop首先从官方渠道下载Codex Desktophttps://developers.openai.com/codex/quickstart根据自己的电脑系统下载对应的安装包按照安装向导完成安装。配置本地Codex环境Codex Desktop安装完成后 如果直接启动会弹出OpenAI登录界面如下图要求登录ChatGPT账号。国内用户网络访问困难且支付不便无法正常登录。因此我们需要提前在本地配置好API信息让Codex Desktop跳过登录界面1. 创建本地配置目录在Windows文件资源管理器中进入以下路径C:\Users\你的用户名\在该目录下新建一个文件夹命名为.codex完整路径为C:\Users\你的用户名.codex2. 配置API Key在刚创建的.codex文件夹中新建一个文件auth.json可用VSCode打开写入以下内容{ OPENAI_API_KEY: 你的API_KEY }将你的API_KEY替换为实际获取的API密钥API获取参考Codex基础使用教程3. 配置服务端点在.codex文件夹中再新建一个文件config.toml写入以下内容model_provider xiyou model gpt-5.4 model_reasoning_effort xhigh disable_response_storage true preferred_auth_method apikey [model_providers.xiyou] name xiyou base_url https://api.0daysci.com/v1/ wire_api responses完成上述配置后启动Codex Desktop。此时不会再弹出OpenAI登录界面可以直接进入主界面使用了。如果要使用CodexDesktop连接服务器则需要继续进行后续的SSH连接配置。SSH密钥登录前置准备如果你此前已根据VS Code连接服务器教程配置过SSH免密登录可跳过此步骤直接看连接服务器的部分。SSH 免密登录的核心原理是想登录哪个服务器就把当前电脑的SSH公钥复制到目标服务器的 authorized_keys文件中告诉该服务器允许这台电脑连接。1. 本地生成SSH密钥如果之前生成过就不要生成了以免覆盖以前的文件了文件生成的默认目录在用户目录的.ssh文件夹下。本地怎么生成SSH密钥使用CMD或者VS Code等IDE的本地终端都是可以的。ssh-keygen -t rsa2. 查看SSH公钥复制备用cat .\.ssh\id_rsa.pub在VS Code中的终端环境执行PowerShell命令行不会看的话找文件打开复制也是可以的3. 将公钥添加到服务器先登录上服务器编辑authorized_keys文件把上一步复制的公钥加到文件中。# 如果没有这个目录就创建一个 mkdir ~/.ssh vim ~/.ssh/authorized_keys连接服务器添加远程配置1. 进入连接设置点击左下角的设置然后点击连接再点击Add添加SSH连接2. 选择配置方式点击Add之后会看到已有配置Codex Desktop会自动关联VS Code已有的SSH连接信息可以直接选择之前配置过的服务器。手动添加也可以点击手动添加填写新的服务器信息主机名、用户名、端口等。3. 正确配置方法避免封禁IP⚠️ 注意事项此时如果直接输入信息尝试连接不会有输入密码的地方因此必须配置密钥连接。但仅配置常规密钥连接可能会被服务器的防御机制封禁IP怎么避免封禁呢接着往下看在SSH配置文件中通常位于C:\Users\你的用户名.ssh\config用VS Code打开也可添加以下内容Host 名称 HostName 主机域名 User 用户名 Port 公网端口 IdentityFile C:\Users\用户名\.ssh\id_rsa关键一行必须添加IdentityFile C:\Users\用户名.ssh\id_rsa指定密钥文件路径这样才能被服务器防御机制正确识别避免触发封禁。保存配置文件后重新在Codex Desktop中发起连接如果远程服务器上没有全局安装CodexCodex Desktop会自动提示安装点击即可自动完成安装无需手动操作安装完成后如果此前没有按照我们的教程Codex基础使用教程配置过环境会显示“登录Codex”而不是直接连接成功见下图Codex是OpenAI公司的产品因此对于国内服务器用户建议根据我们的教程Codex基础使用教程配置环境之后连接服务器使用Codex服务显示绿色即为连接成功