How do I install OpenAI Codex for codus?
Install the Codex command-line app for your operating system, run codex, and complete its sign-in. Codus can then use it in a project quadrant or the Brain. You do not need Claude Code to use a Codex-powered Brain.
Before you start
Use an OpenAI sign-in method available to your account. Your Codus subscription does not include OpenAI usage. The official Codex CLI guide is the authority for installation and authentication options.
Install and sign in
On Mac, open Terminal and run:
curl -fsSL https://chatgpt.com/codex/install.sh | shOn Windows, install Node.js (LTS) if you do not have it, then open PowerShell and run:
npm install -g @openai/codexThis is OpenAI's official npm package. It needs no change to your PowerShell execution policy and nothing is piped from the network straight into a shell. Do not run install commands that turn the execution policy off.
The Mac command downloads and runs OpenAI's installer script. If your organisation restricts that, use the npm package on Mac as well. Review organisation restrictions before running any downloaded installer.
- Open a new terminal window and run
codex --version. It should print a version. - Run
codex, choose Sign in with ChatGPT or another offered method, and finish the browser approval.
If the command is not found, follow the installer's PATH instructions. PATH is the list of locations your computer searches for programs. On Windows, installing only inside WSL does not make Codex available in native PowerShell.
Start it in Codus
- Finish active work and reopen Codus if it was running during installation.
- Assign a project folder.
- Click start → Codex → boot project, or choose Codex in the Brain.
- Read any first-folder trust or permission prompt. Approve only a folder and tools you recognise.
How do I know it worked?
The Codex session starts in the intended project or Brain and answers. Its own version is separate from the Codus app version shown in Settings → Updates.