Claude Code (CLI) provider

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

Variable	Default	Description
`CLAUDE_TOOLS`	`Read,Write,Edit`	Allowed tools
`CLAUDE_MAX_TURNS`	`20`	Max agentic turns
`CLAUDE_TIMEOUT_MINUTES`	`10`	Task timeout
`CLAUDE_SKIP_PERMISSIONS`	`true`	Avoid permission prompts in unattended runs
`BASE_PATH`	Home	Workspace root

No ANTHROPIC_API_KEY is required when using CLI login.

CtrlNode setup

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

Example `.env`

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

How dispatch works

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

Troubleshooting

Issue	Fix
Permission prompts hang	Set `CLAUDE_SKIP_PERMISSIONS=true` (default)
`claude` not found	Install CLI; fix PATH for service account
Task failed immediately	Run `claude login` on the Bridge host
Wrong provider ran task	Agent type must be `ClaudeCode`, not `ClaudeAgentSdk`

← All providers

​When to use it

​Prerequisites

​Environment variables

​CtrlNode setup

​Example .env

​How dispatch works

​Troubleshooting

When to use it

Prerequisites

Environment variables

CtrlNode setup

Example `.env`

How dispatch works

Troubleshooting