> This page is for NeMo Relay, version dev.
> For other versions, use one of these documentation indexes:
> - Latest (v0.11.2) (default): https://docs.nvidia.com/nemo/relay/latest/llms.txt
> - dev: https://docs.nvidia.com/nemo/relay/dev/llms.txt
> - v0.11.2: https://docs.nvidia.com/nemo/relay/v0.11.2/llms.txt
> - v0.10.4: https://docs.nvidia.com/nemo/relay/v0.10.4/llms.txt
> - v0.9.4: https://docs.nvidia.com/nemo/relay/v0.9.4/llms.txt
> - v0.8.4: https://docs.nvidia.com/nemo/relay/v0.8.4/llms.txt
> - v0.7.3: https://docs.nvidia.com/nemo/relay/v0.7.3/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/nemo/relay/llms.txt.

# CLI

> Install the Relay executable for Claude Code and Codex.

Install the latest stable Relay CLI for Claude Code or Codex. The prebuilt
installers do not require a Rust compiler or Python environment.

#### Linux / macOS

```bash
curl -fsSL https://raw.githubusercontent.com/NVIDIA/NeMo-Relay/main/install.sh | sh
export PATH="$HOME/.local/bin:$PATH"
```

#### Windows PowerShell

```powershell
irm https://raw.githubusercontent.com/NVIDIA/NeMo-Relay/main/install.ps1 | iex
```

For Git Bash, MSYS, Cygwin, or MINGW, use the
[Windows POSIX shell instructions](/nemo/relay/dev/nemo-relay-cli/install-details#windows-posix-shells).

Check that the executable is available:

```bash
nemo-relay --version
```

The Linux / macOS `PATH` command applies to the current shell. The PowerShell installer
updates the Windows user `PATH` and the installing PowerShell process.

With the CLI and your coding agent installed, choose how Relay connects:

## Run for One Session

Launch your agent through Relay for the current session. These commands do not
install a persistent agent integration; the CLI remains installed after the
session ends.

### Claude Code

```bash
nemo-relay claude
```

### Codex

```bash
nemo-relay codex
```

For a first complete example, follow the
[Claude Code](/nemo/relay/dev/getting-started/quick-start/claude-code) or
[Codex](/nemo/relay/dev/getting-started/quick-start/codex)
quick start.

## Install a Persistent Integration

The persistent gateway reads user and system configuration; quick-start project
files are not selected automatically. Follow
[Prepare Relay Configuration](/nemo/relay/dev/nemo-relay-cli/plugin-installation#prepare-relay-configuration)
to copy the exporter and provider settings you need into that configuration
before expecting exported activity.

Run the matching command once to enable Relay across sessions. Then start your
agent normally and Relay loads automatically.

### Claude Code

```bash
nemo-relay install claude-code
```

### Codex

```bash
nemo-relay install codex
```

Restart your coding agent after installation so it loads the integration.

#### [Manage Persistent Integrations](/nemo/relay/dev/nemo-relay-cli/plugin-installation)

After installation, verify your integration, manage updates, troubleshoot startup,
or remove it when no longer needed.

For supported platforms, version pinning, alternative installers, upgrades, and
removal, use [Install Details](/nemo/relay/dev/nemo-relay-cli/install-details).
For administrator-managed services, use [Deploy Overview](/nemo/relay/dev/getting-started/deploy).