// docs

Live in two minutes.

Point your editor at BroCode and start coding with Claude. Pick your tool below - or run the wizard.

Quickest start

One command. It asks for your key, configures your IDEs, and verifies the connection.

1 Asks for your API key
2 Configures your chosen IDEs
3 Web search & vision work automatically
4 Verifies your connection

terminal

npx brocode

macOS / Linux

curl -fsSL https://brocode.live/setup.sh | bash

Windows (PowerShell)

irm https://brocode.live/setup.ps1 | iex

Set up your editor

Pick your tool - manual config if you’d rather not use the wizard.

Claude Code

1Run npx brocode and pick Claude Code - done.
2Or configure manually:

~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.brocode.live",
    "ANTHROPIC_MODEL": "Opus 4.8[1m]",
    "ANTHROPIC_SMALL_FAST_MODEL": "Haiku 4.5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "Sonnet 4.6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "Haiku 4.5"
  },
  "hasCompletedOnboarding": true
}

// Replace YOUR_API_KEY with your BroCode key.

API reference

Base URL: https://api.brocode.live · Anthropic-compatible.

Authentication

x-api-key: YOUR_API_KEY
# or
Authorization: Bearer YOUR_API_KEY

Example request

curl https://api.brocode.live/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-4-6",
       "max_tokens":1024,
       "messages":[{"role":"user","content":"Hi"}]}'

POST/v1/messagesAPI key

Create a message. Set stream:true for SSE streaming. Anthropic-compatible request/response.

GET/v1/modelsnone

List models with context_window - Opus is 1,000,000; others 200,000.

POST/v1/messages/count_tokensAPI key

Count tokens for a message without sending it.

GET/api/key-status?key=none

Check status, usage and limits for an API key.

Web search

Automatic & server-side - no setup. Claude looks things up when it needs current info.

Image analysis

Send a URL, path or base64 image - vision is handled for you, server-side.

Available models

Opus 4.8claude-opus-4-8

Flagship - 1M context, deep reasoning, long-horizon agentic coding.

Sonnet 4.6claude-sonnet-4-6

Best balance of speed and intelligence for everyday work.

Haiku 4.5claude-haiku-4-5-20251001

Fastest, for simple queries and high-throughput jobs.

Troubleshooting

Connection errors

Check your API key is active and not expired on the Check Usage page.

Web search / image tools not working

They’re built into the server and work automatically. If issues persist, verify your key is valid.

Model not found

Use exact model IDs (e.g. claude-sonnet-4-6) or friendly names like “Sonnet 4.6”.

Rate limited

Your 5-hour window may be exhausted - check /api/key-status. It resets automatically.

Changes not applying

Restart your IDE after any config change.

Cursor / Windsurf not routing

Make sure you’re using the /v1 endpoint URL.