# Harnesses on your own login

EasyCode drives each harness unmodified on your own login and never reads its credentials. Install one, sign in, and pick how it runs.

A _harness_ is a coding agent you run from a terminal, such as Claude Code or Codex. EasyCode drives seven of them.
Each one runs unmodified on your machine, signed in with your own account.

## What "on your own login" means

- **You sign in, not EasyCode.** When you click **Connect**, EasyCode runs the harness's own sign-in command in a
  terminal inside the app. The harness writes and keeps its own token.
- **EasyCode never reads credentials.** It asks the harness's own status command whether you are signed in. For
  Gemini, Copilot and pi there is no such command, so their state stays **Unknown** after you sign in.
- **Your plan pays for your work.** Usage counts against your own subscription or API key, under your vendor's terms.

## Which harness should I use?

Claude Code, Codex, Cursor and OpenCode have **Full** support. Gemini, Copilot and pi are in **Preview**: they run
over the Agent Client Protocol (ACP) and no release of them is tested yet. The
[harness matrix](/reference/harnesses) lists each one's install command, sign-in command and tested versions.

If your team has no preference, start with Claude Code or Codex. They have the most features, and knowledge tasks
run on one of the two ([`knowledge.harness`](/reference/settings#knowledge-harness)).

## Install and sign in

Open **Settings → Harnesses** in the desktop app. The page lists the harnesses on this machine under **Connected**,
**Needs attention** and **Available to install**.

For a harness that isn't installed, click **Install**. It runs the vendor's official install command in a terminal.

Click **Connect** and finish the sign-in in your browser or in the terminal. Claude Code and Codex offer more
methods under **Sign-in options**.

You can also sign in from your own terminal. The command per harness:

**Claude Code**

```bash
claude auth login
```

**Codex**

```bash
codex login
```

**Cursor**

```bash
cursor-agent login
```

**Copilot**

```bash
copilot login
```

**Gemini**

Run `gemini`, then type `/auth login` inside it.

**OpenCode**

```bash
opencode auth login
```

**pi**

Run `pi`, then type `/login` inside it and pick a provider.

## Pick a default

There is no single default harness. When you start a session, EasyCode preselects the first harness that is
installed and signed in, and you change it in the **Harness** menu. Two things you do set once:

- **The default account.** A harness can hold several accounts, for example _Work_ and _Personal_, each in its own
  config folder. Click **Make default** on the account a new session should use. Each space can set its own default
  accounts under **Settings → Spaces**.
- **The driver.** Under a harness's advanced options, **Automatic** picks the best driver available: **Native**
  (full features through the vendor's SDK), **ACP**, or **Headless** (one process per turn, fewest features). Leave it
  on Automatic unless support asks you to change it ([`harnesses.<id>.driver`](/reference/settings#harnesses-id-driver)).

> **A version that's too new or too old**
>
> If your installed version is newer than the tested range, EasyCode still runs it and says some features may be
> missing. If it is older than the supported range or a known-broken release, the card says **Needs update** and
> offers **Update**.

## The harnesses

- [Claude Code](/setup/harnesses/claude-code)
- [Codex](/setup/harnesses/codex)
- [Cursor](/setup/harnesses/cursor)
- [Copilot](/setup/harnesses/copilot)
- [Gemini](/setup/harnesses/gemini)
- [OpenCode](/setup/harnesses/opencode)
- [pi](/setup/harnesses/pi)
