Codex Setup

Codex is OpenAI's official CLI tool, renamed from the original codex-cli. It ships with the GPT-5 series models and offers capabilities comparable to Claude Code on writing, code, and tool-use tasks.

Flowix Memo treats Codex as a pluggable Agent. Once connected, you can invoke it right at the cursor in your document -- no need to switch terminals, copy context, or manage conversation history by hand. Codex defaults to ChatGPT Plus / Pro subscription sign-in (billed against your subscription quota, no API charges), but you can also switch to an OpenAI API key for separate metering. A single document can hold multiple Codex cards at once, each tracking its own conversation stream independently.

1. Install Codex

Prerequisites:

  • You need Node.js 20 or newer installed
  • macOS users should install Node.js via nvm or Homebrew (brew install node). Installing from the official package directly is not recommended (you may hit permission issues later)
  • Windows users also need Git for Windows

Open a terminal and install Codex:

npm install -g @openai/codex

Upgrade to the latest version:

npm install -g @openai/codex@latest

Note: If you hit permission issues during installation on macOS, install Node.js via nvm instead. Once installed, finish the integration in section 2 "Use Codex in Flowix Memo" below -- do not start Codex directly with the codex command yet (it may fail due to network or regional restrictions).

1.1 macOS

Step 1: Install Node.js 20+

brew install node

Step 2: Install the Codex CLI globally

npm install -g @openai/codex
  1. Verify the install: codex --version -- a version number means the CLI is OK.
  2. Upgrade (optional): npm install -g @openai/codex@latest
  3. End-to-end check: run codex "say hello" in the terminal. A normal response means the CLI, sign-in, and PATH are all good.

1.2 Windows 11

  1. Install Node.js 20+: get the LTS version from nodejs.org, and check Add to PATH during installation.
  2. Install Git for Windows
  3. Install the CLI globally: run npm install -g @openai/codex in an Administrator PowerShell.
  4. Verify the install: codex --version -- a version number means the CLI is OK.
  5. Upgrade (optional): npm install -g @openai/codex@latest
  6. End-to-end check: open a new terminal and run codex "say hello". A normal response means the CLI, sign-in, and PATH are all good.

2. Use Codex in Flowix Memo

Once the CLI is installed, Flowix Memo detects it automatically -- no extra configuration needed. Pick one of the two sign-in methods under Settings > AI > Codex:

  • ChatGPT Plus / Pro subscription sign-in -- click the "ChatGPT Sign-in" button, authorize your ChatGPT account in the browser, and it bills against your subscription quota. Writing a full 3000-word document barely dents the subscription.
  • OpenAI API key -- paste sk-... into the form. This is equivalent to writing ~/.codex/.env and is billed per token.

After signing in, use the / command to insert a Codex card -- same UI pattern as Claude Code.

2.1 Insert an Agent card via command

Type / anywhere in the document to bring up the Agent type menu, then choose Codex. A draggable Agent card is inserted into the document.

2.2 AI Agent conversation

You can invoke it directly at the cursor in your document -- no need to switch terminals, copy context, or manage conversation history by hand. Codex ships with a codex-prefixed bash mode; toggle it on under Settings > AI > Codex > Enable Bash mode to run shell commands directly.