Skip to content

Harnesses

This page lists the coding agents (harnesses) that droneship run supports and the launch options each one takes. Name the agent after run. The registry id also works, so scripts that use claude-code keep working.

Terminal window
droneship run claude
droneship run claude-code   # same agent
Name Also accepted What runs How you reach it
claude claude-code Claude Code Your terminal
codex OpenAI Codex CLI Your terminal

What each one supports

Section titled “What each one supports”
claude codex
Prompt runs (-p) Yes No
Your own plan (--subscription) Claude Pro or Max ChatGPT
Your own key (--byok) ANTHROPIC_API_KEY, or your plan’s CLAUDE_CODE_OAUTH_TOKEN OPENAI_API_KEY
MCP servers from the repo’s .mcp.json With --trust-repo-mcp No
--ask Yes No
--model Yes Yes

Model calls go through the Highflame gateway by default, and you pay with your own API key (--byok) or your own plan (--subscription). With no key sent, claude and codex use the API key you saved on the console’s Settings page, under Model keys. With no saved key, on a terminal they use your plan. With no terminal, nobody can sign in to a plan, so send a key with --byok (for claude, a claude setup-token token works too).

Notes:

  • Prompt runs are Claude Code only. They use your exported key, your plan’s token in CLAUDE_CODE_OAUTH_TOKEN, --byok, or the key saved in the console (not --subscription or --direct). They take --model, and pass no other flags to the agent. They start the repo’s .mcp.json servers only with --trust-repo-mcp. See Background runs and logs.
  • --subscription needs an agent with its own sign-in, which is why only claude and codex take it. It’s for interactive sessions. A prompt run uses your Claude plan through CLAUDE_CODE_OAUTH_TOKEN instead.
  • --byok takes the variable’s name, not its value. For Claude Code, the key stays in the gateway sidecar, not in the sandbox. --subscription and --direct are the options that put a credential in the sandbox.
  • MCP servers come from the repo’s own .mcp.json, and start only with --trust-repo-mcp. See Tools and MCP.

An unknown name fails before a sandbox starts, and the error suggests the closest match:

Invalid value for 'AGENT': 'claud' is not an agent. Did you mean 'claude'? Choose from: claude, codex

More: Harnesses and models, droneship run.

Next

Section titled “Next”