Model providers

​

快速开始

1. 安装 provider packages 每个 model provider 都需要对应的 LangChain integration package。这些 packages 以 optional extras 形式提供，以保持应用轻量。OpenAI、Anthropic 和 Gemini 默认包含。可以在 session 中用 /install 安装任何其他 extra，或在 shell 中用 dcode --install 安装：
   In session

   Shell

   /install groq
   
   不带 argument 运行 /install 可列出有效 extras。若要在初始 CLI install 期间预安装 extras，请设置 DEEPAGENTS_CODE_EXTRAS：
   DEEPAGENTS_CODE_EXTRAS="baseten,groq" curl -LsSf https://langch.in/dcode | bash
   
2. 设置 credentials 使用 /auth credential manager 为 provider 添加 API key：
   /auth
   
   对于 non-interactive runs、CI/CD，或任何无法使用 TUI 的环境，请改为设置 provider 的 environment variable。完整 key resolution order 请参阅 Provider credentials；将 key 作用域限定到 Deep Agents Code 的方法请参阅 DEEPAGENTS_CODE_ prefix；每个 provider 的 environment variable 请参阅 Provider reference。 若要配置 model parameters，请参阅 Model parameters。

​

Provider reference

​

Model routers 和 proxies

/install openrouter

/install litellm

​

切换 models

1. 使用 /model command 打开 interactive model switcher。这会显示来自每个已安装 LangChain provider package 的 model profiles 的 available models。
   并非所有 models 都会出现在这里。如果你的 model 缺失，请直接传入 model name（例如 /model gpt-5.5）。详情请参阅 Which models appear in the switcher。
2. 将 model name 直接指定为 argument，例如 /model gpt-5.5。无论该 model 是否出现在选项 1 的列表中，你都可以使用所选 provider 支持的任何 model。Model name 会传递给 API request。
3. 通过 --model 在启动时指定 model，例如：
   dcode --model openai:gpt-5.5
   

​

哪些 models 会出现在 switcher 中

​

设置 default model

• 通过 model selector： 打开 /model，导航到想要的 model，并按 Ctrl+S 将其 pin 为 default。在当前 default 上再次按 Ctrl+S 会清除它。
• 通过 command： /model --default provider:model（例如 /model --default anthropic:claude-opus-4-7）
• 通过 config file： 在 ~/.deepagents/config.toml 中设置 [models].default（请参阅 Configuration）。
• 从 shell：
  dcode --default-model anthropic:claude-opus-4-7
  

dcode --default-model

• 从 shell：
  dcode --clear-default-model
  
• 通过 command： /model --default --clear
• 通过 model selector： 在当前 pinned default model 上按 Ctrl+S。

​

Model parameters

1. 启动时用 --model-params 一次性设置。 JSON string，仅限 session：
   # OpenAI reasoning effort
   dcode --model openai:gpt-5.5 --model-params '{"reasoning": {"effort": "high"}}'
   
   # Anthropic extended thinking
   dcode --model anthropic:claude-opus-4-7 --model-params '{"thinking": {"type": "enabled", "budget_tokens": 10000}, "max_tokens": 16000}'
   
2. Session 中通过 /model --model-params 设置。 使用相同 JSON syntax，无需重启即可替换 params（并可选择替换 model）：
   /model --model-params '{"temperature": 0.7}' anthropic:claude-opus-4-7
   /model --model-params '{"num_ctx": 16384}'           # opens selector, applies params to choice
   
3. 持久保存在 config.toml 中。 每次启动都应用的 provider-level defaults（可带 optional per-model sub-tables）：
   [models.providers.anthropic.params]
   thinking = { type = "enabled", budget_tokens = 10000 }
   max_tokens = 16000
   
   [models.providers.openai.params]
   reasoning = { effort = "high", summary = "auto" }
   output_version = "responses/v1"
   
   [models.providers.ollama.params]
   num_ctx = 16384
   temperature = 0
   
   # Per-model override—wins over provider-level keys
   [models.providers.ollama.params."qwen3:4b"]
   temperature = 0.5
   

​

Advanced configuration