> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trynito.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Session Launchers

> Start an isolated, fully Nito-routed Claude Code or Codex session from the terminal, with a dedicated profile that leaves your normal setup untouched.

`nito claude` and `nito codex` open a harness session that runs **entirely through Nito**, from your terminal. They are the command line tool form of the in-chat [`session`](/commands/session) command: the harness runs normally, but every model turn goes to Nito instead of the harness's own provider.

Each launcher runs in an **isolated profile**. Your ordinary Claude Code or Codex configuration, credentials, and history are not touched, and exiting returns you to your normal setup.

<Note>
  Fully Nito-routed sessions require a **paid plan** with full-session access enabled for your organization. See [What Paid Unlocks](/plans/what-paid-unlocks).
</Note>

## Claude

```bash theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["typescript","python","curl"]}}
# Start a Nito-routed Claude Code session
nito claude --model z-ai/glm-5.2

# Private session: no transcript or prompt-history persistence
nito claude --model z-ai/glm-5.2 --private

# Start in a project directory, passing args through to Claude Code after --
nito claude --model z-ai/glm-5.2 --working-directory ./my-project
```

Anything after `--` is passed straight through to Claude Code.

### Options

| Flag                         | Default    | Effect                                                                                   |
| :--------------------------- | :--------- | :--------------------------------------------------------------------------------------- |
| `--model <id>`               | (required) | The Nito-supported model that powers the session.                                        |
| `--private`                  | off        | Start with no Claude transcript or prompt-history persistence.                           |
| `--ephemeral-history`        | off        | Allow up-arrow history in the temporary private profile, then delete it on a clean exit. |
| `--skip-permissions`         | off        | Run a private sidecar with Claude permission prompts bypassed.                           |
| `--web-search off\|auto\|on` | `on`       | Claude web search mode.                                                                  |
| `--web-fetch <on\|off>`      | `on`       | Allow Claude WebFetch.                                                                   |
| `--working-directory <path>` | current    | Working directory for the session.                                                       |
| `--agent-profile <name>`     | default    | Nito agent credential profile to use.                                                    |

The privacy flags mirror the in-chat Private command. Read [Private](/commands/private) for exactly what each one does and does not guarantee: `--ephemeral-history` is not the same as never writing to disk, and `--skip-permissions` is not a sandbox.

## Codex

```bash theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["typescript","python","curl"]}}
# Start a Nito-routed Codex session
nito codex --model qwen/qwen3-coder

# Web search off, in a specific directory
nito codex --model qwen/qwen3-coder --web-search off --working-directory ./my-project
```

Anything after `--` is passed straight through to Codex.

### Options

| Flag                         | Default    | Effect                                                    |
| :--------------------------- | :--------- | :-------------------------------------------------------- |
| `--model <id>`               | (required) | The Nito-supported model that powers the session.         |
| `--web-search off\|auto\|on` | `on`       | Codex web search: `off`, `auto` (cached), or `on` (live). |
| `--working-directory <path>` | current    | Working directory for the session.                        |
| `--agent-profile <name>`     | default    | Nito agent credential profile to use.                     |

<Note>
  `nito codex` is a Nito-routed session, so it needs **only your Nito sign-in**, not an OpenAI login. It does not accept the Private-only flags (`--private`, `--ephemeral-history`, `--skip-permissions`); those belong to `nito claude`.
</Note>

## Choosing the Model

Both launchers require `--model`. List the certified session models available to your account with:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["typescript","python","curl"]}}
nito agent models
```

Anonymous, Private, and Confidential models can power a session. An `:encrypted` model cannot, because Encrypted is [coming soon](/privacy/levels/encrypted) and the client refuses it on every path, not only in sessions. See [Models](/models) for the catalog and [Privacy Levels](/privacy/levels) for what each level reaches.

## Relationship to the In-Chat Command

`nito claude` / `nito codex` and `/nito:session` / `$nito:session` open the same kind of isolated Nito-routed session. Use the plugin command when you are already in a chat; use the command line tool launcher when you want to start one from a script, an alias, or a fresh terminal.

## Related

<CardGroup cols={2}>
  <Card title="Session command" icon="window" href="/commands/session">
    The in-chat equivalent and how sessions keep history.
  </Card>

  <Card title="Choosing a Model" icon="list-check" href="/commands/choosing-a-model">
    Which models can power a session, and how to pick one.
  </Card>
</CardGroup>