模型提供商

为深度智能体 CLI 配置任何兼容 LangChain 的模型提供商

深度智能体 CLI 支持任何与 LangChain 兼容的聊天模型提供商，可以使用几乎任何支持工具调用的大语言模型(LLM)。任何暴露 OpenAI 兼容或 Anthropic 兼容 API 的服务也可开箱即用——参见兼容 API。

快速入门

CLI 与以下模型提供商自动集成：除了安装相关提供商包外，无需额外配置。

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 中导出：

   OpenAI

   永久添加

   mkdir -p ~/.deepagents
   echo 'OPENAI_API_KEY=your-api-key' >> ~/.deepagents/.env
   

   Anthropic

   永久添加

   mkdir -p ~/.deepagents
   echo 'ANTHROPIC_API_KEY=your-api-key' >> ~/.deepagents/.env
   

   Google

   永久添加

   mkdir -p ~/.deepagents
   echo 'GOOGLE_API_KEY=your-api-key' >> ~/.deepagents/.env
   

   其他

   CLI 支持任何支持工具调用的大语言模型(LLM)。完整的支持提供商列表及其所需环境变量请参见提供商参考。

   要配置模型参数，请参见模型参数。

   您还可以使用 DEEPAGENTS_CLI_ 前缀将凭证的作用域限定在 CLI 内。

提供商参考

深度智能体 CLI 使用 Python 构建，请使用 Python 提供商参考文档。

模型路由器和代理

OpenRouter 和 LiteLLM 等模型路由器通过单一端点提供多个提供商的模型访问。

使用这些服务的专用集成包：

路由器	包
OpenRouter	langchain-openrouter

OpenRouter 是内置提供商——安装包后直接使用：

uv tool install 'deepagents-cli[openrouter]'

LiteLLM 也是内置提供商：

uv tool install 'deepagents-cli[litellm]'

切换模型

在 CLI 中切换模型，可以：

1. 使用交互式模型选择器——使用 /model 命令。这会显示从每个已安装 LangChain 提供商包的模型配置文件中获取的可用模型。

   并非所有模型都会显示在这里。如果您的模型缺失，直接传入模型名称（例如 /model gpt-5.5）。详见哪些模型出现在选择器中。

2. 直接指定模型名称作为参数，例如 /model gpt-5.5。您可以使用所选提供商支持的任何模型，无论它是否出现在选项 1 的列表中。模型名称将被传递到 API 请求中。

3. 启动时指定模型，通过 --model，例如

   deepagents --model openai:gpt-5.5
   

模型解析顺序

CLI 启动时按以下顺序解析使用哪个模型：

1. --model 标志——提供时始终优先。
2. [models].default——在 ~/.deepagents/config.toml 中——用户的长期偏好设置。
3. [models].recent——在 ~/.deepagents/config.toml 中——最近通过 /model 切换的模型。自动写入；不会覆盖 [models].default。
4. 环境自动检测：回退到第一个可用的启动凭证，按以下顺序检查：OPENAI_API_KEY、ANTHROPIC_API_KEY、GOOGLE_API_KEY、GOOGLE_CLOUD_PROJECT（Vertex AI）。

此启动回退有意仅检查这四个凭证。其他支持的提供商（例如 Groq）仍可通过 --model、/model 和保存的默认设置（[models].default / [models].recent）使用。

哪些模型出现在选择器中

/model 选择器动态构建其列表，从已安装的提供商包中获取。展开下方查看完整条件和故障排除。

选择器如何构建其模型列表

交互式 /model 选择器动态构建其列表——它不是 CLI 中内置的硬编码列表。当以下所有条件都为真时，模型会出现在选择器中：

1. 提供商包已安装。 每个提供商（例如 langchain-anthropic、langchain-openai）必须与 deepagents-cli 一起安装——作为安装附加项（例如 uv tool install 'deepagents-cli[ollama]'）或稍后通过 uv tool install deepagents-cli --with <package> 添加。如果包缺失，其整个提供商部分将不出现在选择器中。

2. 模型有启用了 tool_calling 的配置文件。 CLI 需要工具调用支持，因此配置文件中没有 tool_calling: true 的模型将被排除。这是模型缺失最常见的原因。对于不捆绑配置文件的提供商（参见提供商参考表），您可以在 config.toml 中定义：

   [models.providers.ollama.profile."qwen3:4b"]
   tool_calling = true
   max_input_tokens = 32768
   max_output_tokens = 8192
   

   这不是模型出现在选择器中的严格要求——将其添加到 models 列表也可以且更简单。当您希望 CLI 了解模型的上下文窗口和能力（用于自动摘要等功能）时，配置文件很有用。所有可覆盖字段请参见配置文件覆盖。

3. 模型接受并产生文本。 配置文件中明确将 text_inputs 或 text_outputs 设置为 false 的模型（例如嵌入或图像生成模型）将被排除。

在 config.toml 的 [models.providers.<name>].models 下定义的模型会绕过配置文件过滤——无论配置文件元数据如何，它们始终出现在选择器中。这是添加列表中缺失模型的推荐方式。

凭证状态不影响模型是否被列出。选择器显示所有符合条件的模型，并在每个提供商标题旁显示凭证指示器：对勾表示已确认凭证，警告表示缺少凭证，问号表示凭证状态未知。您仍可以选择缺少凭证的模型——提供商会在请求时报告认证错误。

故障排除缺失模型

症状	可能原因	修复方法
整个提供商在选择器中缺失	提供商包未安装	安装包（例如 uv tool install deepagents-cli --with langchain-groq）
提供商显示但特定模型缺失	模型配置文件的 tool_calling: false 或不存在配置文件	将模型添加到 config.toml 中的 [models.providers.<name>].models，或直接使用 /model <provider>:<model>
提供商显示 “missing credentials” 警告	API 密钥环境变量未设置	设置提供商参考表中的凭证环境变量
提供商显示 “credentials unknown” 问号	提供商使用 CLI 无法验证的非标准认证	凭证可能仍然有效——尝试切换到该模型。如果认证失败，请查看提供商文档

设置默认模型

您可以设置一个持久的默认模型，用于所有未来的 CLI 启动：

• 通过模型选择器： 打开 /model，导航到所需模型，按 Ctrl+S 将其固定为默认。在当前默认值上再次按 Ctrl+S 取消固定。

• 通过命令： /model --default provider:model（例如 /model --default anthropic:claude-opus-4-7）

• 通过配置文件： 在 ~/.deepagents/config.toml 中设置 [models].default（参见配置）。

• 从 shell：

  deepagents --default-model anthropic:claude-opus-4-7
  

查看当前默认值：

deepagents --default-model

清除默认值：

• 从 shell：

  deepagents --clear-default-model
  

• 通过命令： /model --default --clear

• 通过模型选择器： 在当前固定的默认模型上按 Ctrl+S。

没有默认值时，CLI 将默认使用最近使用的模型。

模型参数

向模型传递额外的构造函数关键字参数——采样控制、推理/思考预算、上下文窗口大小、请求超时，以及底层聊天模型类接受的任何其他参数。三个设置位置，按优先级排列（最高优先）：

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
   

CLI 标志覆盖配置文件 params 且仅限当前会话（会话内更改不会持久化）。config.toml 中按模型子表覆盖提供商级键（浅合并——完整语义请参见模型构造函数参数）。--model-params 不能与 --default 组合使用。

底层聊天模型构造函数接受的任何关键字参数都有效。完整列表请参阅提供商的参考文档——例如 ChatAnthropic、ChatOpenAI、ChatOllama。未知的关键字参数会被转发到上游 API 请求，因此新发布的参数无需 CLI 更新即可使用。

不要在 params 中放置凭证（api_key）——使用 api_key_env 指向环境变量。

要覆盖模型运行时配置文件（max_input_tokens、tool_calling、能力标志）上的字段——与构造函数参数不同——请参见配置文件覆盖。

高级配置

有关提供商参数、配置文件覆盖、自定义基础 URL、兼容 API、任意提供商和生命周期钩子的详细配置，请参见配置。

---

通过 MCP 连接这些文档到 Claude、VSCode 等以获取实时解答。

在 GitHub 上编辑此页面 或 提交 issue。