# Run — Claude Code

Botize method — `claude_code.run` (action).

Send a message to a Claude Code session and wait for the response.

This is an action: it runs as a step of a task. Several can be chained.

## Fields you set

The field's internal name, its type and the values it accepts. These fields accept `{{...}}` tags from earlier steps.

- `mb_switch` *(boolean)* — Rules
- `session` *(string)* — Session name
- `message` *(string)* — Message
- `mode` *(string, one of: "direct" = Direct (free-text answer); "orchestrator" = Orchestrator (agent can delegate to others); "custom" = Custom (define your own JSON Schema))* — Response mode
- `json_schema` *(string)* — Custom JSON Schema
- `mb_outputvars_switch` *(boolean)* — Customize tags

It also accepts repeatable field groups, with these prefixes: `mb_filters_*`. These are composite components (buttons, filters, keyboards); the trailing number is set by the user as they are added.

## Output variables

Data this step makes available. Reference them in later steps with the double-brace tag.

- `{{text}}` *(text)* — Response text. Claude's response. In orchestrator mode this is the message the agent wants to send to the next recipient.
- `{{cost_usd}}` *(text)* — Cost (USD). API cost in USD. e.g. 0.0032
- `{{duration_ms}}` *(int)* — Duration (ms). Total response time in milliseconds
- `{{session_id}}` *(text)* — Session ID. Internal Claude session UUID (for resuming)
- `{{job_id}}` *(text)* — Job ID. Worker job identifier
- `{{ok}}` *(boolean)* — Success. true if the call succeeded, false otherwise
- `{{done}}` *(boolean)* — Done. Orchestrator mode only: 'true' when the agent has the final answer for the user, 'false' when it needs to delegate further.
- `{{next_agent}}` *(text)* — Next agent. Orchestrator mode only: alias of the agent to which 'text' should be sent next (empty when 'done' is true).
- `{{reason}}` *(text)* — Reason. Orchestrator mode only: brief reasoning behind the agent's decision.
- `{{permission_denials}}` *(text)* — Permission denials. JSON array of tools Claude tried to use but were blocked by the session's .claude/settings.json. Empty when there were none.

## Account

Needs a connected Claude Code account in Botize: https://botize.com/en/app/claude_code/authenticate

## This app

Every trigger and action for Claude Code: https://botize.com/en/app/claude_code.md

## How to build this

An AI assistant (Claude, ChatGPT, Cursor…) can create and edit these tasks in the user's account through the Botize MCP connector, included in every plan:

    https://webhook.botize.es/mcp

- Connection guide: https://botize.com/en/mcp
- Agent map: https://botize.com/llms.txt
- New account: https://botize.com/en/join (500 free operations, no card)

---
Machine-readable summary for AI assistants. Human version: https://botize.com/en/method/claude_code/run