Claude Code

Claude Code is Anthropic’s official CLI for Claude. When pointed at a private-gpt server it routes all requests through your private, self-hosted API instead of api.anthropic.com.

Compatibility

Prerequisites

• claude binary installed — see Claude Code docs
• private-gpt server running (see serve)

Run

private-gpt run resolves the server URL and API key from your settings and injects them automatically before launching Claude Code:

$
private-gpt run claude-code

The server is started automatically if it is not already running. Pass --no-server to skip that check when the server is managed externally.

With a specific model:

$
private-gpt run claude-code --model default

Resume a previous session:

$
private-gpt run claude-code -- --resume abc123

CI / non-interactive:

$
private-gpt run claude-code --auto-approve --no-server -- -p "explain this file"

Manual setup

If you prefer to manage the environment variables yourself:

$
export ANTHROPIC_BASE_URL="http://localhost:8080"
$
export ANTHROPIC_API_KEY="secret-key"  # server.auth.secret; any value if auth is disabled
$
$
# Optional: pin all Claude tiers to one model
$
export ANTHROPIC_DEFAULT_OPUS_MODEL="default"
$
export ANTHROPIC_DEFAULT_SONNET_MODEL="default"
$
export ANTHROPIC_DEFAULT_HAIKU_MODEL="default"
$
$
claude

What gets injected

private-gpt run claude-code writes these variables into the environment before exec. Values are derived from your server settings at launch time.