SP Cambo
All documentation

Claude Code setup

Claude Code talks to SP Cambo through its standard Anthropic environment variables. No plugin and no patching required.

Before you start

Configure the environment

Set the base URL to the SP Cambo gateway root, the auth token to your key, and the model to an SP Cambo alias.

bash
export ANTHROPIC_BASE_URL="https://sp-cambo.store"
export ANTHROPIC_AUTH_TOKEN="sk-your-key"
export ANTHROPIC_MODEL="<your-model-alias>"

claude

Do not append /v1 to ANTHROPIC_BASE_URL. Claude Code adds its own path, so the correct value is exactly https://sp-cambo.store. Adding /v1 produces requests to /v1/v1/messages, which fail with a not-found error.

Making it persistent

Exporting in a shell only lasts for that shell. For everyday use, put the variables in your shell profile (~/.zshrc, ~/.bashrc) or, better, in a per-project .envrc or secret manager so the key is not sitting in a file that gets backed up and shared.

If you keep the key in a dotfile, make sure that dotfile is not in a repository. A key committed to git must be treated as compromised and rotated.

Choosing a model

Use the public alias exactly as shown in the catalogue. Aliases are stable across upstream routing changes, so a working configuration keeps working. A provider-specific model id is not a valid value here and will be rejected.

Your key may be scoped to a subset of aliases. If Claude Code reports that the model is not permitted, check the key's scope in the dashboard rather than changing the base URL.

Troubleshooting

Every request 404s

Almost always a /v1 on the end of ANTHROPIC_BASE_URL. Remove it and restart the shell.

401 or 403 immediately

The key is wrong, disabled, revoked, or scoped to different models. Validate it from the dashboard — validation does not spend any quota.

402 or "insufficient" errors

Your package is spent or expired. Requests stop rather than becoming an overage bill. Buy another package and access resumes immediately.

429s during a long session

You are hitting the per-key or per-package rate limit. See rate limits for the correct backoff behaviour.

Variables set but ignored

Claude Code reads the environment at launch. Restart it after changing variables, and confirm they are exported in the same shell that launches it — not only in a parent process.

What SP Cambo records

Request metadata only: which alias, which key, when, how long, how many tokens, and whether it settled. Prompts, completions, tool payloads and file contents are not stored. Your activity view shows exactly what is retained.