API Credentials for Claude Code

To connect a machine running Claude Code to Botize you need to install a small worker on that machine and paste here the token it gives you. Here's how to do it step by step.

Install the worker and get the token

1. 1

   On the machine where you want to install the worker (your Mac, a Linux server, a Raspberry Pi...) open a terminal.

2. 2

   Make sure you have Python 3 installed. It comes preinstalled on Mac and most Linux distros.

3. 3

   Install Claude Code if you don't have it yet. Run: 'npm install -g @anthropic-ai/claude-code' (requires Node.js installed). Then authenticate with: 'claude auth'.

4. 4

   Run this command to install the worker: 'curl -fsSL https://kanon.botize.es/downloads/claude_code/install.sh | bash'. The installer checks the prerequisites, creates the '~/botize_claude_code/' folder and downloads the script inside.

5. 5

   Go into the worker folder: 'cd ~/botize_claude_code'.

6. 6

   Start the worker: if you just want to try it out, use 'python3 claude_api.py --start' (runs in your terminal, Ctrl+C to stop). If you want it installed permanently, use 'python3 claude_api.py --install' (runs in the background and starts on boot).

7. 7

   The first launch prints a Botize token (a long string of letters and numbers). Copy it: you'll paste it into the 'Token' field of this form. If you forget it, running either command again shows the token.

Create your first agent in Claude Code

1. 1

   From the terminal run: 'python3 ~/botize_claude_code/claude_api.py --session-add my-agent' (replace 'my-agent' with whatever name you want; only lowercase letters, numbers, dashes and underscores).

2. 2

   If the session doesn't exist yet, the command will ask whether to create it. Press Enter or 'y' to confirm.

3. 3

   It asks for the folder where the agent will live (default '~/agents/my-agent'). Press Enter to accept the default or type a different path.

4. 4

   The command will create the folder, start Claude with a smoke-test prompt, add the alias to the worker's whitelist, and show a confirmation ('✓ Session ready' and '✓ Added to whitelist').

Connect in Botize

1. 1

   Paste into the 'Token' field of this form the token you copied in step 7 of the first section.

2. 2

   Save the connection profile.

3. 3

   In your Botize flows, when you use the Claude Code 'run' method, enter in the 'Session' field the name of the alias you created (for example 'my-agent'). The messages you send from Botize will reach that Claude session on your machine.