Skip to main content

Install and Launch Codex GUI

This page is for users trying Codex GUI for the first time.

1. Install Codex​

npm install -g @jiangshengdev/codex@latest

2. Launch Codex​

Go to your project directory, then run:

cdx

3. Get the GUI Address​

Enter:

/gui

/gui only prints access URLs; it does not open a browser automatically.

The output looks like this:

Local: http://127.0.0.1:<PORT>/task/<TASK_ID>#token=<ACCESS_TOKEN>
LAN:   http://<LAN_IP>:<PORT>/task/<TASK_ID>#token=<ACCESS_TOKEN>
  • Use Local when accessing the GUI on the computer running Codex.
  • Use LAN when accessing it from another device on the same local network.
  • The port, task ID, and access token may change each time. Use the actual terminal output.
  • Copy the full URL, including /task/... and #token=.... Do not share or publish the access token.

4. Open Codex GUI​

Copy the Local URL from the output, paste it into your browser's address bar, and open it.