Proxy not running
paper init
If it still won’t start, run paper status to see what’s wrong, then paper logs for the underlying error.
Sessions not appearing in paper console
Open the paper CLI menu bar app and confirm:
- you are authenticated and your auth is not expired
- you are connected to the correct organization
paperdis running
Then re-run paper start claude so the new session is routed through the local proxy.
The paper CLI won’t start (multiple orgs)
If you belong to more than one org and haven’t picked one, paper logs shows:
paperd: cannot derive inference upstream: no org selected — run `paper org select` or pass --upstream
Run paper org select, then paper init.
Claude Code can’t connect
Confirm ANTHROPIC_BASE_URL matches the proxy address in paper status. If the proxy restarted and the port changed, re-run paper start claude to pick up the new address — or copy the new proxy address from paper status and re-export it if you’re managing the env var yourself.
Model rejected
The backend’s model allowlist doesn’t include the model you requested. Contact the team to update the allowlist, or switch to a model that’s already enabled.
401 from the gateway
The Anthropic API key stored in your backend may be wrong or expired. Run paper login again — the wizard will prompt you to re-enter it.
Claude Code starts, but nothing is captured
Make sure you started Claude Code with the paper CLI:
paper start claude
If you started Claude Code directly, the paper CLI will not be able to capture the session.