> ## 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

> Fully Nito-routed Claude Code or Codex sessions from the terminal.

`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`](/plugin/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.

Fully Nito-routed sessions require a **paid plan**. See [Plans](/plans).

## Claude

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
# 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](/plugin/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"}}
# 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. |

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

Use an up-to-date Nito CLI with the current model catalog. The launcher enables Codex shell and patch tools when a model's `supported_parameters` includes `tools`. If Codex can answer but cannot use those tools, update the CLI and check the model's live catalog entry.

## 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"}}
nito agent models
```

Anonymous, Private, and Confidential models can power a session. An `:encrypted` model cannot, because Encrypted is [coming soon to the plugin](/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.

## 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="/plugin/commands/session">
    The in-chat equivalent and how sessions keep history.
  </Card>

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.