Codex 客户端怎么接入？桌面端和 CLI 两条路都行
2026年9月13日
桌面端点两下就能用，CLI 一条命令登录。额度、网关加速、自检、多组织切换全都有，Codex 配置一行不用改。附完整命令表。
接入 ReCodex 有两条路，用哪条都行，共用同一个账号和同一份额度：不想碰命令行就用桌面端，点两下完事；习惯终端就用 CLI，一条 recodex login 搞定。
两条路都有一个共同前提，也是最省事的地方：跑 Codex 的仍然是官方客户端，你的 Codex 配置一行都不用改。
桌面端：点两下就能用
装好登录之后，这些全在客户端里，不用碰任何配置文件：
| 功能 | 你得到什么 |
|---|---|
| 额度随时看 | 当前账号和 7 天用量直接在侧边栏 |
| 网关加速 | 一键选最快线路，不用自己测 |
| 自动更新 | 客户端内更新，替换前校验哈希 |
| 十几项界面改进 | 删除会话、导出 Markdown、界面居中等等 |
| 微信遥控 | 用微信发消息在自己机器上跑 Codex，带白名单 |
| 菜单汉化 | 官方界面的中文化 |
第一次启动会依次经过四个状态，卡在哪一个、各自怎么处理，写在第一次安装 ReCodex：从下载到跑通。
CLI：一条命令登录
CLI 不是桌面端的简化版——所有的自检能力都在 CLI 这边，排查问题它最好使。
登录就这一条：
recodex login
它会打开浏览器让你确认设备和套餐。有两个细节记一下，能省掉最常见的两次返工：
- 确认码大约 10 分钟有效，过期了再跑一次就行；
- 授权完成后要完全重启终端 / IDE / Codex 桌面端。凭据是写给新启动进程的，老窗口读不到——「装好了但 Codex 报凭据错误」几乎都是这一条。
完整命令表
| 命令 | 做什么 |
|---|---|
recodex login | 浏览器设备授权登录，写入托管配置与凭据 |
recodex status | 登录状态、下发时间、当前网关、额度 |
recodex account | 账号邮箱、类型（独享 / 拼车）、套餐 |
recodex usage --refresh | 刷新并打印可用额度、用量、5 小时 / 7 天窗口 |
recodex doctor | 全面检查：安装、配置、登录、凭据、订阅、Codex 可用性、各网关可达性 |
recodex doctor --fix | 先自动修（重新拉配置；网关不可达就切到最快的可用网关），再复检 |
recodex doctor --json | 同上但输出 JSON，给客服和脚本用 |
recodex refresh | 不重新登录，只重新拉一次托管配置 |
recodex logs --limit 50 | 最近 N 条脱敏记录：命令、结果、版本、系统；不含任何密钥 |
recodex install check | 只读的安装前置检查，不改动任何东西 |
recodex update | 检查并安装带签名的更新 |
recodex logout | 撤销这台设备，把 Codex 配置还原回登录前 |
遇到问题的顺序建议：recodex doctor 看结论 → recodex doctor --fix 让它自己修一遍 → 还不行就把 recodex doctor --json 发给我们。那份数据能直接定位到是网关、是凭据还是本机环境，比来回描述现象快得多。
网关加速：一条命令选最快线路
网关是我们放在多个地区的接入点，请求先到网关再到官方。选哪个直接影响延迟——这也是「国内直连还很快」的原因。
recodex gateways list # 所有网关：延迟、状态、当前选中的
recodex gateways test # 重新测一遍延迟
recodex gateways auto # 自动选最快的健康网关（推荐）
recodex gateways use jp # 切到指定网关
懒人版：直接 recodex gateways auto，它会自己挑。桌面端里是同一个功能，一个按钮。
一个人几台电脑？各选各的
每台设备占一个名额，名额数由你的套餐决定。设备可以自己管：后台「我的设备」里把不用的下线，名额立即释放——换电脑不用找客服。
注意它按设备算，不是按客户端算：同一台机器上桌面端和 CLI 共用一个账号、一份额度、一个名额，不会互相顶掉。
多个组织时，每台设备各选各的
如果你同时属于不止一个组织（比如个人组织和公司团队），每台设备各自选一个——台式机用团队组织、笔记本用个人组织，完全没问题。
recodex org # 列出可用组织，* 是这台设备正在用的
recodex org use <名字或 id>
切完要重开终端——凭据放在环境变量里，只对新启动的进程生效。桌面端那边在 ReCodex 面板的「组织」里点切换，立即生效不用重启；只属于一个组织时这一块是隐藏的。
一个限制要知道：没有生效订阅的组织不能选。组织的额度来自它自己的订阅，没订阅的会列出来但不可选——切过去等于没额度。这种情况找那个组织的管理员。
装在哪些系统上
Windows、macOS、Linux 全都支持。
装 ReCodex 之前要先装官方 ChatGPT 客户端，我们是在它之上工作的。Windows 的官方版本只在 Microsoft Store 里有，没有独立安装包；macOS 是官方 dmg。
官方下载页在国内不一定打得开，所以下载页上放了镜像，点击直接下载——安装包来自官方源，我们只做搬运：不解包、不修改、不重新签名。网络允许的话，走官方源也一样。
接下来
- 还没开通 → 先看ReCodex 是什么
- 想知道额度怎么分 → Codex 拼车额度怎么算
- 封号、退款、设备数 → 开通前最常问的六件事
近期文章
