Agentic Data Plane

rpk ai run

Launch a third-party coding agent configured to send its model traffic through the Redpanda AI gateway for the current environment.

Sessions authenticate with an API key, so a running session keeps working when your login token expires (starting one still needs a valid login). The first launch in an environment asks to create one; it is valid for 30 days, stored next to rpk ai’s credentials file, and replaced automatically when it expires or is deleted. Without a key (no terminal to ask on, or declined) a session uses your login token. `--api-key=yes creates one without asking, --api-key=no always uses the login token.

Usage

rpk ai run [flags]

Subcommands

Command Description

rpk ai run claude

Launch Anthropic’s Claude Code CLI with its model traffic routed through the Redpanda AI gateway for the current rpk ai environment. rpk ai points ANTHROPIC_BASE_URL at the gateway’s Anthropic Messages endpoint for the chosen provider and wires the gateway auth for the life of the session.

rpk ai run codex

Launch the OpenAI Codex CLI with its model traffic routed through the Redpanda AI gateway for the current rpk ai environment. rpk ai generates a throwaway Codex config in a temporary CODEX_HOME, points it at the gateway’s OpenAI-compatible Responses endpoint for the chosen provider, and wires Codex’s bearer to rpk ai auth token so it refreshes itself for the life of the session (with an ADP API key, rpk ai auth api-key prints the stored key).

Global flags

Value Type Description

--config

string

Redpanda or rpk config file; default search paths are ~/.config/rpk/rpk.yaml, $PWD/redpanda.yaml, and /etc/redpanda/redpanda.yaml.

-X, --config-opt

stringArray

Override rpk configuration settings; -X help for detail or -X list for terser detail.

--ignore-profile

bool

Ignore rpk.yaml and redpanda.yaml; use default settings.

--profile

string

rpk profile to use.

-v, --verbose

bool

Enable verbose logging.