參考 / Provider 與 Model

Provider 與 Model

Heddle 支援 OpenAI 與 Anthropic model adapter。設定一個 provider 後，就能透過 CLI flag、terminal slash command 或瀏覽器控制選擇 model。

Provider access

heddle auth login openai

實驗性的 user-selected ChatGPT/Codex account transport。這不是 OpenAI 官方支援。

export OPENAI_API_KEY=your_key_here

穩定的 API-key path，也是 hosted web search 與 drift embedding 所需的模式。

export ANTHROPIC_API_KEY=your_key_here

Claude model 使用這個方式。Heddle 不支援 Anthropic consumer subscription OAuth。

heddle auth status
heddle auth login openai
heddle auth login openai --no-browser
heddle auth logout openai

Terminal chat 內也有相同的 auth surface：/auth、/auth status、/auth login openai 與 /auth logout openai。

gpt-5.1-codex

claude-sonnet-4-6

heddle --model gpt-5.4-mini
heddle chat --model claude-3-5-haiku-latest

/model
/model list
/model set <query>
/model <name>

Chat footer 與瀏覽器 composer footer 會顯示所選 model 的 active auth source，例如 auth=openai-oauth、auth=openai-key 或 auth=missing-openai。

OpenAI account sign-in 只限於 Heddle 已明確允許走 ChatGPT/Codex transport path 的 model。其他 OpenAI Platform model，或需要 API-key mode 的 feature，請使用 OPENAI_API_KEY。

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.5

如果 OpenAI OAuth 與 API key 都可用，Heddle 預設偏好 OAuth。
使用 --prefer-api-key 可強制 run、ask command 或 daemon session 走 Platform API-key mode。
Hosted web search 與 drift embedding 目前需要 OpenAI Platform API-key mode。
Provider inference 會辨識 Gemini model name，但 Google adapter 尚未接上。