Providers & Models
Heddle supports OpenAI and Anthropic model adapters. Configure one provider, then choose models with CLI flags, terminal slash commands, or browser controls.
Provider access
OpenAI account sign-in
heddle auth login openaiExperimental, user-selected ChatGPT/Codex account transport. Not official OpenAI support.
OpenAI Platform API key
export OPENAI_API_KEY=your_key_hereStable API-key path and required for hosted web search and drift embeddings.
Anthropic API key
export ANTHROPIC_API_KEY=your_key_hereUse this for Claude models. Heddle does not support Anthropic consumer subscription OAuth.
Credential commands
heddle auth status
heddle auth login openai
heddle auth login openai --no-browser
heddle auth logout openaiThe same auth surface is available inside terminal chat with /auth, /auth status, /auth login openai, and /auth logout openai.
Default models
OpenAI default
gpt-5.1-codex
Anthropic default
claude-sonnet-4-6
Choosing a model
heddle --model gpt-5.4-mini
heddle chat --model claude-3-5-haiku-latest
/model
/model list
/model set <query>
/model <name>The chat footer and browser composer footer show the active auth source for the selected model, such as auth=openai-oauth, auth=openai-key, or auth=missing-openai.
OpenAI account sign-in support
OpenAI account sign-in is limited to models Heddle has explicitly allowed for the ChatGPT/Codex transport path. Use OPENAI_API_KEY for other OpenAI Platform models or features that require API-key mode.
gpt-5.1-codex
gpt-5.1-codex-max
gpt-5.1-codex-mini
gpt-5.2
gpt-5.2-codex
gpt-5.3-codex
gpt-5.3-codex-spark
gpt-5.4
gpt-5.4-mini
gpt-5.5Important notes
- If both OpenAI OAuth and an API key are available, Heddle prefers OAuth by default.
- Use --prefer-api-key to force Platform API-key mode for a run, ask command, or daemon session.
- Hosted web search and drift embeddings require OpenAI Platform API-key mode today.
- Gemini model names are recognized by provider inference, but a Google adapter is not wired yet.