命令参考
用法
账号与状态
status 显示的「登录」一行以服务端答复为准:设备在服务端被注销后会显示「凭据已失效」, 而不是照本地文件说「是」。网络不通时不会误判成凭据失效。网关
安装与诊断
维护
recodex update 只接受带有效签名的发布清单。签名验不过就直接拒绝更新, 不会退而求其次装一个来源不明的二进制。命令行
命令参考
ReCodex 命令行的全部命令、参数和环境变量。
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
ReCodex 命令行的全部命令、参数和环境变量。
recodex [--lang zh|en] [--api URL] <命令>
| 命令 | 作用 |
|---|---|
recodex login | 浏览器完成设备授权后登录,并写入托管配置与凭据 |
recodex status | 登录状态、签发时间、当前网关、配置是否托管、网关可达性,并附上额度 |
recodex account [--json] | 账号邮箱、账号类型(独享/共享)与套餐名 |
recodex usage [--refresh] [--json] | 可用额度、已用量、数据时间,以及 5 小时 / 7 天两个窗口 |
recodex logout | 注销此设备并还原登录前的 Codex 配置 |
status 显示的「登录」一行以服务端答复为准:设备在服务端被注销后会显示「凭据已失效」, 而不是照本地文件说「是」。网络不通时不会误判成凭据失效。| 命令 | 作用 |
|---|---|
recodex gateways [list] | 列出全部网关:延迟、健康状态,并标出当前选中的 |
recodex gateways test | 重新测一遍各网关延迟 |
recodex gateways use <id> | 切到指定网关,例如 recodex gateways use jp |
recodex gateways auto | 自动选延迟最低的健康网关 |
$ recodex gateways
jp 日本直连 53ms healthy
sg 新加坡直连 31ms healthy selected
jpcf 日本CF 63ms healthy
sgcf 新加坡CF 45ms healthy
| 命令 | 作用 |
|---|---|
recodex install check | 检查安装前提;能识别从应用商店(MSIX)安装的 Codex |
recodex install repair | 修复托管的 Codex 配置 |
recodex doctor | 逐项体检:客户端安装、托管配置、登录、凭据、网关、订阅与 Codex 可用性 |
recodex doctor --fix | 先自动修复能安全修的项,再重新体检 |
recodex doctor --json | 同上但输出 JSON(schema_version / ok / checks),便于脚本判断或贴给客服 |
recodex refresh | 重新拉取托管配置,不用重新登录 |
recodex logs [--limit N] | 最近 N 条脱敏诊断日志,默认 50 |
| 命令 | 作用 |
|---|---|
recodex update | 从签名发布清单安全更新当前程序 |
recodex version | 显示客户端版本 |
recodex uninstall | 注销、还原配置,然后删除全部 ReCodex 客户端数据 |
recodex update 只接受带有效签名的发布清单。签名验不过就直接拒绝更新, 不会退而求其次装一个来源不明的二进制。# 首次登录
recodex login
# 看状态和额度
recodex status
# 出问题先自检,能自动修的它会修
recodex doctor --fix
# 换个更快的网关
recodex gateways auto
# 退出并还原原配置
recodex logout
--lang zh|enrecodex --lang en status
--api URL| 变量 | 作用 |
|---|---|
RECODEX_LANG | 默认输出语言:zh 或 en |
RECODEX_API | 覆盖 API 根地址;普通用户保持默认 |
RECODEX_KEY | 登录时由客户端写入,Codex 用它访问网关。不要手动改 |
recodex login 写入的 RECODEX_KEY 对已经打开的终端不可见 —— 需要新开一个终端窗口。这也是为什么登录后 doctor 可能提示凭据问题,而新终端里一切正常。recodex logs --limit 50
{"time":"2026-08-20T09:11:24Z","event":"command_finished","command":"doctor","result":"success","version":"1.2.55","os":"windows"}