Get set upHarnesses

Codex harness

Install Codex, sign in on your own login, and the versions EasyCode is tested with.

Generated from the codeView as Markdown

Codex is OpenAI's coding agent for the terminal. EasyCode runs it on your machine, signed in with your own ChatGPT account, and never reads its credentials.

What EasyCode uses it for

Codex runs chat and terminal sessions. On the Native driver EasyCode talks to Codex's own app server, which gives the most features. Codex and Claude Code are the two harnesses that can run knowledge tasks (knowledge.harness).

The install, sign-in and tested versions below come from the runner's harness catalog.

Codex CLI is made by OpenAI. EasyCode supports it fully. Its own documentation.

Install

npm install -g @openai/codex

Update it with npm install -g @openai/codex@latest.

Sign in

Sign in on your own login with codex login (methods: device).

Tested versions

DriverTested up toChosen automatically
codex-app-server0.163.0Yes
headless0.163.0Yes
acp0.163.0No

What's specific to Codex

  • Sign-in options. Connect signs in with your ChatGPT account in the browser. On a machine without a browser, pick Device code under Sign-in options.
  • Several accounts. Each account is its own Codex home folder. Add one with Add account, and click Make default on the one new sessions should use.
  • Limit resets. When your plan gives you limit resets, the card lists them under Limit resets. Use reset spends one, after you confirm.
  • MCP servers. You can connect the Linear or Atlassian MCP server to Codex in one click, under Settings → Harnesses. It runs Codex's own codex mcp add and sign-in commands.
  • ACP. The ACP driver needs an optional adapter. Automatic prefers the native driver, so you rarely need it.

See Harnesses on your own login for how the drivers and default accounts work.

Something wrong or missing? Suggest a change

On this page