5-minute quickstart

Activate a subscription and wait for an accountCopy Anchor Link

Sign up at recodex.cc (only QQ Mail addresses, @qq.com, are accepted for now; you'll need an email verification code; an invitation code and a redemption code are optional), or sign in and redeem your code under Plans & Billing → Redeem a code.

A new subscription waits for an administrator to assign an account, and the timer does not run until then. Wait for the Account assigned message before step 3: until then the subscription shows Timer paused on the authorization page and can't be selected. See subscription status.

Install gcodexCopy Anchor Link

Run the command for your system in a terminal. The installer adds gcodex to your PATH; to upgrade later, run the same command again.

curl -fsSL https://recodex.cc/install.sh | bash && . "$HOME/.recodex/env"

Seeing gcodex: command not found right after installing? Open a new terminal window.

Approve this computer in your browserCopy Anchor Link

$

Your browser opens the authorization page; select the subscription, approve, and return to the terminal. gcodex prints its messages in Chinese: 请在浏览器中完成设备授权 means "complete device authorization in your browser", 登录成功 means "signed in" (followed by the subscription name), and the last line says you can now run gcodex to start the official Codex CLI. The link is valid for 5 minutes and works only once; if it expires, just run gcodex login again.

On a machine without a graphical desktop (for example a server you reach over SSH), run gcodex login --no-browser and open the printed link in a browser on any device to approve it.

Signing in backs up the configuration and sign-in files in ~/.codex first, then writes ReCodex's settings; your MCP servers, skills and session history are not affected. See what it changes.

Check that everything is readyCopy Anchor Link

gcodex status

Look at the 订阅 (subscription) line: 有效 (active) means you're good to go (close to expiry it shows 即将到期, "expiring soon", which works too). Daemon showing 未运行 (not running) at this point is normal; it starts automatically the first time you run gcodex or gcodex desktop run.

If it shows 已暂停计时：… (timer paused), the account needs an administrator's attention and the reason follows the colon; see subscription status.

Open CodexCopy Anchor Link

gcodex