模型提供商

​

快速开始

1. 安装提供商包 每个模型提供商都需要安装其对应的 LangChain 集成包。这些包作为可选的附加组件在安装 CLI 时提供，这样做是为了保持应用程序的轻量级：
   # 使用所选提供商快速安装
   # OpenAI、Anthropic 和 Gemini 默认包含在内
   DEEPAGENTS_EXTRAS="baseten,groq" curl -LsSf https://langch.in/gh-da-cli | bash
   
   # 或使用 uv 直接安装
   uv tool install 'deepagents-cli[baseten,groq]'
   
   # 稍后添加其他包
   uv tool install deepagents-cli --with langchain-ollama
   
   # 所有提供商
   uv tool install 'deepagents-cli[anthropic,baseten,bedrock,cohere,deepseek,fireworks,google-genai,groq,huggingface,ibm,litellm,mistralai,nvidia,ollama,openai,openrouter,perplexity,vertexai,xai]'
   
2. 设置凭据 将 API 密钥存储在 ~/.deepagents/.env 中，以便在所有项目中使用，或者在 shell 中导出它们：
   ANTHROPIC_API_KEY=sk-ant-...
   OPENAI_API_KEY=sk-...
   
   某些提供商使用其他凭据（例如，Vertex AI 使用 GOOGLE_CLOUD_PROJECT 加上 ADC）。请参阅下表了解每个提供商所需的变量。您也可以使用 DEEPAGENTS_CLI_ 前缀将凭据限定在 CLI 范围内。

​

提供商参考

​

模型路由器和代理

uv tool install 'deepagents-cli[openrouter]'

uv tool install 'deepagents-cli[litellm]'

​

切换模型

1. 使用交互式模型切换器，通过 /model 命令。这将显示来自每个已安装 LangChain 提供商包的模型配置文件的可用模型。
   并非所有模型都会显示在此处。如果您的模型缺失，请直接传递模型名称（例如 /model gpt-5.5）。详情请参阅哪些模型会出现在切换器中。
2. 直接指定模型名称作为参数，例如 /model gpt-5.5。您可以使用所选提供商支持的任何模型，无论它是否出现在选项 1 的列表中。模型名称将传递给 API 请求。
3. 在启动时指定模型，通过 --model，例如
   deepagents --model openai:gpt-5.5
   

​

哪些模型会出现在切换器中

​

设置默认模型

• 通过模型选择器： 打开 /model，导航到所需模型，然后按 Ctrl+S 将其固定为默认值。再次按 Ctrl+S 可清除当前默认值。
• 通过命令： /model --default provider:model（例如，/model --default anthropic:claude-opus-4-6）
• 通过配置文件： 在 ~/.deepagents/config.toml 中设置 [models].default（参见配置）。
• 通过 shell：
  deepagents --default-model anthropic:claude-opus-4-6
  

deepagents --default-model

• 通过 shell：
  deepagents --clear-default-model
  
• 通过命令： /model --default --clear
• 通过模型选择器： 在当前固定的默认模型上按 Ctrl+S。

​

模型参数

1. 启动时一次性使用 --model-params。 JSON 字符串，仅限会话：
   # OpenAI 推理努力程度
   deepagents --model openai:gpt-5.5 --model-params '{"reasoning": {"effort": "high"}}'
   
   # Anthropic 扩展思考
   deepagents --model anthropic:claude-opus-4-7 --model-params '{"thinking": {"type": "enabled", "budget_tokens": 10000}, "max_tokens": 16000}'
   
2. 会话中通过 /model --model-params。 相同的 JSON 语法——无需重启即可交换参数（并可选地交换模型）：
   /model --model-params '{"temperature": 0.7}' anthropic:claude-opus-4-7
   /model --model-params '{"num_ctx": 16384}'           # 打开选择器，将参数应用于所选模型
   
3. 在 config.toml 中持久化。 提供商级别的默认值（带有可选的每个模型子表），在每次启动时应用：
   [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
   
   # 每个模型的覆盖——优先于提供商级别的键
   [models.providers.ollama.params."qwen3:4b"]
   temperature = 0.5
   

​

高级配置