Credenciales de la API de Claude Code

Para conectar una máquina con Claude Code a Botize necesitas instalar un pequeño worker en esa máquina y copiar aquí el token que te genere. A continuación te mostramos cómo hacerlo paso a paso.

Instalar el worker y obtener el token

1. 1

   En la máquina donde quieras instalar el worker (tu Mac, un servidor Linux, una Raspberry Pi...) abre un terminal.

2. 2

   Asegúrate de tener Python 3 instalado. En Mac y en la mayoría de Linux ya viene preinstalado.

3. 3

   Instala Claude Code si aún no lo tienes. Ejecuta: 'npm install -g @anthropic-ai/claude-code' (requiere Node.js instalado). Luego autentícate con: 'claude auth'.

4. 4

   Ejecuta este comando para instalar el worker: 'curl -fsSL https://kanon.botize.es/downloads/claude_code/install.sh | bash'. El instalador comprueba los requisitos, crea la carpeta '~/botize_claude_code/' y descarga el script dentro.

5. 5

   Entra en la carpeta del worker: 'cd ~/botize_claude_code'.

6. 6

   Arranca el worker: si solo quieres probarlo usa 'python3 claude_api.py --start' (corre en tu terminal, Ctrl+C para parar). Si quieres dejarlo instalado permanente usa 'python3 claude_api.py --install' (corre en segundo plano y arranca al reiniciar la máquina).

7. 7

   El primer arranque muestra un token de Botize (una cadena larga de letras y números). Cópialo: lo pegarás en el campo 'Token' de este formulario. Si se te olvida, al volver a ejecutar cualquiera de esos dos comandos verás el token otra vez.

Crear tu primer agente en Claude Code

1. 1

   Desde el terminal ejecuta: 'python3 ~/botize_claude_code/claude_api.py --session-add mi-agente' (cambia 'mi-agente' por el nombre que quieras, solo letras minúsculas, números, guiones y guiones bajos).

2. 2

   Si la sesión no existe, el comando te preguntará si quieres crearla. Pulsa Enter o 'y' para confirmar.

3. 3

   Te pedirá la carpeta donde quieres que viva el agente (por defecto '~/agents/mi-agente'). Pulsa Enter para aceptar la por defecto o escribe otra ruta.

4. 4

   El comando creará la carpeta, arrancará Claude con un mensaje de prueba, añadirá el alias a la whitelist del worker y te mostrará un mensaje de confirmación ('✓ Session ready' y '✓ Added to whitelist').

Conectar en Botize

1. 1

   Pega en el campo 'Token' de este formulario el token que copiaste en el paso 7 de la primera sección.

2. 2

   Guarda el perfil de conexión.

3. 3

   En tus flujos de Botize, cuando uses el método 'run' de Claude Code, introduce en el campo 'Session' el nombre del alias que creaste (por ejemplo 'mi-agente'). Los mensajes que envíes desde Botize llegarán a esa sesión de Claude en tu máquina.