Codex CLI 云服务器部署：安装、配置与后台运行
Codex CLI 能装在 QCode 云服务器上：用 tmux 或 systemd 放到后台，断开 SSH 后继续跑。一键脚本默认只写配置，服务器上要选 Codex CLI。
更新于 2026-10-19
把这个工具接到 QCode 端点：一把 key 调 Claude、GPT 与国产模型。
- 按 token 计费，实时单价见 /models
- 支付宝、微信支付、信用卡、加密货币均可付款
- 充值后自助开通、立刻生效
四个要点：配置、密钥、协议、非交互
顶层键 + provider 表
顶层是 model_provider、model、model_reasoning_effort 三个键；base_url、wire_api、requires_openai_auth 属于 [model_providers.qcode] 表内，两个层级不能混写。
二选一
requires_openai_auth = true 时密钥读自 ~/.codex/auth.json 的 OPENAI_API_KEY；改用环境变量就把这一行换成 env_key = "QCODE_API_KEY" 并 export 它。OpenAI 官方文档写明：requires_openai_auth = true 时 Codex 会忽略 env_key。
协议字段不能换
Codex 走 Responses 协议，wire_api 设为 responses，OpenAI 官方的 Codex 配置参考写明这个字段目前只支持 responses，缺省时也按 responses 处理。
非交互运行
codex exec --sandbox workspace-write 可以在服务器上跑批任务：非交互运行，结果输出到标准输出，修改限制在工作区内。
Codex CLI 能不能放在云服务器上跑
截至 2026-10-19，可以。QCode 云服务器是一台你自己管理的机器，含 1 个独立公网 IPv4、KVM 与完整 root 权限，通常几分钟内开通，控制台目前提供中文和英文界面；装好 Codex CLI 之后，模型调用走 QCode 的接入端点，用你的 QCode Key。云服务器和 AI 服务各自独立售卖，不必为了开一台服务器先买个人套餐；Codex 调用模型用的是 QCode 控制台里的 Key，Key 要先在 QCode 账号里选好方案。
官方文档与工具现况（2026-10-19 核对）
截至 2026-10-19，docs.qcode.cc 的《Codex 快速上手》给出的是 Responses 路径，密钥以 cr_ 开头，写进 ~/.codex/auth.json 的 OPENAI_API_KEY。
三条时间线
GPT-6 Sol 更新版（gpt-6.1-sol）发布日；QCode 的《Codex 快速上手》把它列为推荐默认模型。
Codex CLI 最新稳定版 v0.162.1 发布；QCode 的《Codex 完整教程》记录了版本号与发布日期。
QCode 的《Codex 完整教程》在这一天更新，重新核对了 config 配置项、审批与沙箱参数和安装方式；这是文档的修订日期，不是 Codex 的版本发布。
已确认 vs 未公布
已确认（原文可核）
与 Codex 直接相关的这几条可以在原文里核到：① 接入地址、密钥写法与配置层级的细节见上文《在服务器上把 Codex 跑起来》；② 推荐模型是 gpt-6.1-sol，推理强度可写 model_reasoning_effort = "high"；③ codex exec --sandbox workspace-write 可以非交互运行，结果输出到标准输出，修改限制在工作区内。云服务器的试用、退款、续费规则见 qcode.cc/cloud。
官方未公布 / 尚未确认
qcode.cc/cloud 没有公布线路的带宽数值和延迟数据，各线路起价随补货和配置变化，以线路对照表为准；目前不能在线更换线路或升级配置，之后是否开放，官方页面没有说明。
本地跑 vs 服务器后台运行
配置跟着人走
config.toml 与密钥都在你自己的电脑上，关机或换机器时，Codex 就停在那里。适合短任务和交互式改代码。
机器在你手上，进程由你保活
用 tmux 或 systemd 把 Codex 放到后台之后，笔记本关机也不影响它继续跑（做法见常见问题）；控制台里能查看状态、开关机、重启和续费。适合长时间任务和后台作业。
在服务器上把 Codex 跑起来
① 在 qcode.cc/cloud 选地区、线路、时长和配置，起价见线路对照表；② 下单后按控制台里的连接信息登录：ssh root@ 后面接服务器 IP，用下单时设置的 root 密码；③ 在服务器上跑一键安装命令 curl -fsSL https://qcode.cc/install/codex.sh | bash：脚本会对 api/asia/us 三个接入域测速并推荐最快的、提示你粘贴 cr_ 开头的 Key、写入 ~/.codex 配置并做连通验证；它会先问装在桌面 App 还是 CLI，默认的桌面 App 只写配置、不装 Node.js 与 CLI，服务器上请选 Codex CLI（或加 --target cli）；④ 想手动配置时，在 ~/.codex/config.toml 顶层写 model_provider = "qcode"、model = "gpt-6.1-sol"、model_reasoning_effort = "high"，再写 [model_providers.qcode] 表，表内是 name = "qcode"、base_url = "https://api.qcode.cc/openai"、wire_api = "responses"、requires_openai_auth = true（provider 名可自定，只要与表名一致，docs 示例用 qcode）；⑤ 把 cr_ 开头的密钥写进 ~/.codex/auth.json 的 OPENAI_API_KEY，密钥在 QCode 控制台获取；想改用环境变量，就把表里的 requires_openai_auth = true 换成 env_key = "QCODE_API_KEY" 并 export 这个变量，两种写法只能选一种；⑥ 验证：codex --version，再跑 codex "输出 hello world"。
在 QCode 上怎么接
服务器上的 Codex 接的是 QCode 的接入端点，完整配置见上文《在服务器上把 Codex 跑起来》。通过 QCode 可用的 GPT 型号有 gpt-6.1-sol、gpt-6-sol、gpt-6-astra、gpt-5.6-sol、gpt-5.6-terra。调用按 token 计费，各模型单价见 /models；云服务器与 AI 服务共用同一个账户余额。不想包月？按量包 ¥25 起买一笔额度，7–90 天内用完为止（人民币充值 ¥100 起）。
常见问题
服务器上的 Codex 怎么非交互运行？
用 codex exec：它非交互运行，结果输出到标准输出（加 --json 输出 JSONL），例：codex exec --sandbox workspace-write。沙箱限制在工作区内，不会影响工作区外的系统；适合 CI/CD 集成与批量任务。
怎么付款、怎么开通？
付款方式有支付宝、微信、银行卡和加密货币。选好地区、线路、时长和配置后下单，通常几分钟内开通；若开通失败或下单后 2 小时内仍未交付，费用会自动全额退回余额。禁止垃圾邮件、DDoS、扫描、挖矿和违法内容，违规会立即停机，已付费用不予退款。
服务器上用哪个模型？
docs 推荐的默认模型是 gpt-6.1-sol（GPT-6 Sol 更新版），也可以用 codex --model gpt-6.1-sol 临时换一个。通过 QCode 可用的 GPT 型号还有 gpt-6-sol、gpt-6-astra、gpt-5.6-sol、gpt-5.6-terra，完整清单见 qcode.cc/models。
试用怎么算？开通后能退款吗？
试用是收费的：1 天（24 小时），价格随配置不同；到期后服务器自动删除、数据不保留；试用期内可以在面板转为正式（选 1、3、6 或 12 个月），每个账号同时只能有 1 台试用服务器。开通后不支持退款。
一键脚本和手写 config.toml 是什么关系？
脚本默认只写配置：运行时它先问装在桌面 App 还是 CLI，选 Codex CLI 才会按需安装 Node.js 与 CLI。已有 ~/.codex/config.toml 时，脚本只更新 model_provider、model、review_model、model_reasoning_effort 这几项和 provider 表，你原有的 MCP server、profile、approval_policy 原样保留，写前把原文件备份成同目录的 .bak.时间戳；只有原文件格式有误、无法安全合并时才整体覆盖并明确提示。
服务器上的 Codex 怎么在断开 SSH 后继续跑？
断开 SSH 后让进程继续跑，常用做法是把 Codex 放进 tmux 会话，或写成 systemd 服务；这是通用的 Linux 做法，不是 QCode 或 OpenAI 的功能。机器状态可以在控制台查看，也能开关机、重启和续费。
一手来源
QCode 云服务器页（qcode.cc/cloud，2026-10-19 抓取核对）：地区与线路、IPv4 与完整管理权限、试用与时长、退款规则、控制台功能、禁止用途、付款方式与一键安装命令。docs.qcode.cc《Codex 快速上手》（2026-10-19 抓取核对）：config.toml 的 provider、env_key、auth.json、可用模型与沙箱参数。docs.qcode.cc《Codex 完整教程》（2026-10-19 抓取核对）：Codex CLI 版本与发布日期、配置项、审批与沙箱参数。docs.qcode.cc《一键配置脚本》（2026-10-19 抓取核对）：脚本的接入域测速、桌面 App 与 CLI 两种目标、写入与备份行为。OpenAI 官方 Codex 文档的认证页与配置参考页（2026-10-19 抓取核对）：密钥读法与环境变量的关系、协议字段的取值范围。
现在开一台
一台自己管理的机器，Codex CLI 用 QCode 的接入端点调用 gpt-6.1-sol 等 GPT 型号，模型调用按 token 计费。
相关页面
按量包
不包月，一次买一笔额度，7–90 天内用完为止。
Codex CLI 完全指南
从安装到多模型与代理设置，一次看完 Codex CLI 的完整配置。
Codex CLI 接第三方 API 配置指南
本地接第三方 API 的 config.toml 写法与常见报错。
加密货币充值指南
9 种币、56 条网络，0 平台手续费购买 AI 编程 API 额度。
本文内容核对于 2026-10-19，以 qcode.cc/cloud 与 docs.qcode.cc 的线上页面为准；这些页面更新后内容可能随之变化，恕不另行通知。模型可用性以 /models 为准。