Troubleshooting

Resolve daemon, authentication, and capture issues with the paper CLI.

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
  • paperd is 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.

Copied to clipboard