Docs / Debug

Debug & troubleshooting

If requests still go to Anthropic or OpenAI directly, your shell probably has not loaded the install env yet.

1. Check env vars

source ~/.headroom-proxy/env.sh
echo $ANTHROPIC_BASE_URL
echo $OPENAI_BASE_URL
curl -fsS https://api.kloodproject.com/health

Expected base URLs:

• ANTHROPIC_BASE_URL=https://api.kloodproject.com
• OPENAI_BASE_URL=https://api.kloodproject.com/v1

2. Open a new terminal

Install appends to ~/.zshrc / ~/.bashrc. Existing terminals do not pick that up until you restart them or run source ~/.headroom-proxy/env.sh.

3. Re-run install

curl -fsSL https://kloodproject.com/install.sh | bash

Safe to run again — it refreshes env.sh and your shell profile lines.

4. Set base URLs manually (one session)

export ANTHROPIC_BASE_URL="https://api.kloodproject.com"
export OPENAI_BASE_URL="https://api.kloodproject.com/v1"
claude

5. Cursor still bypassing Klood?

Cursor’s GUI ignores shell env. Paste in Settings → Models → Override OpenAI Base URL:

• GPT models: https://api.kloodproject.com/v1
• Claude models: https://api.kloodproject.com

6. Proxy unreachable

If curl …/health fails but env vars are correct, the hosted API may be down. Check status on the contact page or retry later.

Checklist

Contact support →