# Codex harness

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

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`](/reference/settings#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](https://developers.openai.com/codex/cli).

## Install

```sh
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

| Driver | Tested up to | Chosen automatically |
| --- | --- | --- |
| `codex-app-server` | 0.163.0 | Yes |
| `headless` | 0.163.0 | Yes |
| `acp` | 0.163.0 | No |

## 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](/setup/harnesses) for how the drivers and default accounts work.
