Skip to main content

​
快速开始

ReCodex 有两种用法,共用同一个账号和同一份额度,按你的习惯选一个即可:
  • 桌面端(推荐):装一个应用,打开就能用,账号和额度直接显示在 Codex 界面里。
  • 命令行:习惯终端的话,recodex 提供登录、查额度、切网关、自检等命令。
两种方式都需要你的机器上已经装好官方 Codex 桌面客户端 —— ReCodex 是在它之上工作的,不是替代品。官方下载页在部分地区打不开,recodex.dev/download 的第 1 步就是它: Windows 和 macOS 都能点一下直接下载(我们镜像的官方原包,附 sha256)。

​
方式一:桌面端(推荐)

1

下载安装包

到 recodex.dev/download 下载对应系统的安装包:
  • Windows:ReCodex-<版本>-windows-x64-setup.exe
  • macOS(Apple Silicon):ReCodex-<版本>-macos-arm64.dmg
页面会自动把你当前系统的那个放在最前面。
2

安装并打开

Windows 安装到 %LOCALAPPDATA%\Programs\ReCodex,会创建桌面和开始菜单快捷方式。 打开后它会自动找到你已安装的 Codex 客户端并接管界面。macOS 上把 ReCodex 拖进「应用程序」即可。首次打开如果提示无法验证开发者, 在访达里右键点它选「打开」,或执行:
我们目前还没有 Apple 开发者账号做公证,所以浏览器下载的包会带隔离属性。
3

登录 ReCodex

点右下角的 Rx 按钮打开面板,在「账号」页点登录 ReCodex。 面板会显示一个授权码,点「打开授权页」在浏览器里确认即可。
4

重启一次

登录成功后侧边栏会立刻换成你的账号。但官方 Codex 进程是在你登录之前启动的, 读不到新写入的配置,所以要重启一次 —— 面板上直接点立即重启生效就行。
登录完成后,你会在官方界面左下角的账号菜单里看到自己的邮箱、套餐和 7 天用量。

​
方式二:命令行

​
1. 安装

脚本会按平台选二进制、校验 sha256、装到 PATH 上。校验不通过会直接中止,不会装上去。 验证:

​
2. 登录

终端会显示授权码和验证地址,并尝试打开浏览器。在浏览器里批准当前设备即可。

​
3. 自检

它会逐项检查:Codex 客户端是否装好、托管配置是否就位、是否已登录、凭据是否可见、网关是否可达、订阅是否有效且 Codex 真的可用。全部通过才算配置正确。
Windows 上 recodex login 写入的环境变量,当前终端读不到 —— 需要新开一个终端窗口。 如果你在 IDE 扩展或桌面客户端里用,也要重启它们。

​
常见的第一个问题

每个账号最多同时授权 3 台设备。到 设备管理 撤销一台不用的即可 —— 撤销之后不用重新登录,客户端的轮询会自己走通。
先确认官方 Codex 桌面客户端已经装好。命令行下可以用 recodex install check 检查 —— 它也能识别从应用商店(MSIX)安装的版本。
额度是从服务端取的快照。手动点一次「刷新额度」会立刻更新; 平时数据超过 5 分钟没更新时,客户端也会在后台自动补一次。

​
下一步

工作原理

了解登录、托管配置和网关是怎么串起来的。

命令参考

全部命令行指令、参数与环境变量。