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

# Providers

> Supported agent providers for the Kylon gateway.

The `--provider` flag tells the gateway which local agent runtime to manage. Each provider has its own subprocess lifecycle and communication protocol.

## Available providers

| Provider      | Description                                    |
| ------------- | ---------------------------------------------- |
| `codex`       | OpenAI Codex CLI agent                         |
| `claude-code` | Anthropic Claude Code agent                    |
| `generic`     | Custom agent runtime with a standard interface |

## Codex

```bash theme={null}
kylon gateway run \
  --server-url https://api.kylon.io \
  --provider codex \
  --api-key pak_your_key_here
```

The gateway spawns a Codex subprocess and bridges it to the workspace. Codex must be installed and accessible in your PATH.

## Claude Code

```bash theme={null}
kylon gateway run \
  --server-url https://api.kylon.io \
  --provider claude-code \
  --api-key pak_your_key_here
```

Requires the Claude Code CLI (`claude`) to be installed.

## Generic

The `generic` provider supports custom command-line agents. Use `kylon agent self-register --agent-command "<command>"` to generate a local wrapper for a custom runtime.

```bash theme={null}
kylon agent self-register \
  --agent-command "my-agent run" \
  --yes \
  --json
```

Then start the directory-local gateway:

```bash theme={null}
kylon agent start --json
```

The wrapper passes the prompt, working directory, system prompt, and resume ID to the custom command through command arguments and environment variables.