Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ctrlnode.ai/llms.txt

Use this file to discover all available pages before exploring further.

Provider id: claude · CtrlNode agent type: ClaudeCode Runs tasks through the Claude Code CLI (claude command) with stream-json output. The Bridge writes CLAUDE.md into each task folder with role, instructions, and completion tags.

​
When to use it

  • You use an Anthropic Claude Code subscription on the Bridge machine
  • You prefer the official CLI over the programmatic Agent SDK
  • You want --resume session continuity on follow-up dispatches for the same task
For API-key-based programmatic agents, use Claude Agent SDK (claude-sdk) instead.

​
Prerequisites

Install Claude Code globally: 
npm install -g @anthropic-ai/claude-code
claude --version
Authenticate once: 
claude login

​
Environment variables

VariableDefaultDescription
CLAUDE_TOOLSRead,Write,EditAllowed tools
CLAUDE_MAX_TURNS20Max agentic turns
CLAUDE_TIMEOUT_MINUTES10Task timeout
CLAUDE_SKIP_PERMISSIONStrueAvoid permission prompts in unattended runs
AGENTS_FOLDERHomeWorkspace root
No ANTHROPIC_API_KEY is required when using CLI login.

​
CtrlNode setup

  1. Create a project with agent type Claude (CLI) / ClaudeCode
  2. Register agents in Team
  3. Ensure claude is on PATH for the user running ctrlnode-bridge

​
Example .env

PAIRING_TOKEN=...
PROVIDERS=claude
AGENTS_FOLDER=/home/you

​
How dispatch works

  1. Bridge creates the task folder under {AGENTS_FOLDER}/.ctrlnode/tasks/...
  2. Writes CLAUDE.md with instructions and required output paths
  3. Spawns claude with the task prompt; streams events to CtrlNode
  4. Parses terminal tags (TASK_COMPLETED, TASK_FAILED, TASK_BLOCKED) from the reply

​
Troubleshooting

IssueFix
Permission prompts hangSet CLAUDE_SKIP_PERMISSIONS=true (default)
claude not foundInstall CLI; fix PATH for service account
Task failed immediatelyRun claude login on the Bridge host
Wrong provider ran taskAgent type must be ClaudeCode, not ClaudeAgentSdk
← All providers