GUÍA DE PROVEEDOR
Claude SDK
Ejecuta Claude de Anthropic localmente en tu máquina. CTRL NODE despacha tareas a través del Bridge, que invoca a Claude directamente — sin navegador, sin interfaz, API pura.
Clave API de Anthropic claude-3-5-sonnet / claude-3-7-sonnet
Requisitos
- ✓ CTRL NODE Bridge instalado en tu máquina (GitHub)
- ✓ Modo suscripción — Claude Code CLI instalado y autenticado con
claude /init. No requiere clave API. - ✓ Modo clave API — clave API de Anthropic desde console.anthropic.com. No requiere CLI.
Inicio rápido
Opción A — Suscripción a Claude
RecomendadoRequiere la Claude Code CLI — no necesita clave API, menos parámetros del Bridge.
$npm install -g @anthropic-ai/claude-code
$claude /init # autenticar una vez
$ PAIRING_TOKEN=your-pairing-token \
CLAUDE_SDK_EXECUTABLE=claude \
./ctrlnode
CLAUDE_SDK_EXECUTABLE=claude \
./ctrlnode
Opción B — Clave API de Anthropic
$ PAIRING_TOKEN=your-pairing-token \
ANTHROPIC_API_KEY=sk-ant-… \
./ctrlnode
ANTHROPIC_API_KEY=sk-ant-… \
./ctrlnode
Obtén tu clave en console.anthropic.com.
Archivo .env
PAIRING_TOKEN=your-pairing-token
# Modo suscripción (sin clave API)
CLAUDE_SDK_EXECUTABLE=claude
# O: modo clave API
ANTHROPIC_API_KEY=sk-ant-…
# Opcional: fijar el modelo
CLAUDE_DEFAULT_MODEL=claude-3-7-sonnet-20250219
Variables de entorno
| Variable | Obligatoria | Descripción |
|---|---|---|
| ANTHROPIC_API_KEY | Sí* | Clave API de Anthropic. Obligatoria salvo que uses el login por CLI. |
| CLAUDE_SDK_EXECUTABLE | No | Ruta al binario CLI de claude. Usa el SDK directamente si no se define. |
| CLAUDE_DEFAULT_MODEL | No | Modelo a usar. Por defecto claude-3-5-sonnet-20241022. |
Cómo el Bridge despacha tareas a Claude
Cuando CTRL NODE despacha una tarea a un agente de Claude:
- El Bridge escribe un archivo CLAUDE.md en la carpeta de workspace del agente con las instrucciones de la tarea.
- Lanza el Claude SDK (o CLI) con el prompt de la tarea y la ruta del workspace.
- La salida de la terminal se transmite a CTRL NODE en tiempo real mediante el WebSocket saliente.
- Al finalizar o si hay un error, el estado de la tarea se actualiza en el panel de CTRL NODE.
Tu código, archivos y clave API nunca salen de tu máquina — solo se transmiten el estado de la tarea y la salida de la terminal.