Skip to main content
Deep Agents CLI 支持任何兼容 LangChain 的聊天模型提供商，从而解锁对几乎所有支持工具调用的大型语言模型的使用。任何提供 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 中导出它们： 
    ANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-...
    某些提供商使用其他凭据（例如，Vertex AI 使用 GOOGLE_CLOUD_PROJECT 加上 ADC）。请参阅下表了解每个提供商所需的变量。您也可以使用 DEEPAGENTS_CLI_ 前缀将凭据范围限定到 CLI。

​
提供商参考

Deep Agents CLI 使用 Python 构建，请使用 Python 提供商参考文档。

​
模型路由器和代理

像 OpenRouter 和 LiteLLM 这样的模型路由器通过单个端点提供对来自多个提供商的模型的访问。 请使用这些服务的专用集成包：
路由器包
OpenRouterlangchain-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. ~/.deepagents/config.toml 中的 [models].default——用户有意的长期偏好。
  3. ~/.deepagents/config.toml 中的 [models].recent——通过 /model 切换到的最后一个模型。自动写入；永远不会覆盖 [models].default。
  4. 环境自动检测：回退到第一个可用的启动凭据，按以下顺序检查：OPENAI_API_KEY、ANTHROPIC_API_KEY、GOOGLE_API_KEY、GOOGLE_CLOUD_PROJECT（Vertex AI）。
此启动回退有意仅检查这四个凭据。其他支持的提供商（例如 Groq）仍可通过 --model、/model 和保存的默认值（[models].default / [models].newest）使用。

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

/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>
提供商显示 ⚠ “缺少凭据”API 密钥环境变量未设置设置提供商参考表中的凭据环境变量
提供商显示 ? “凭据未知”提供商使用 CLI 无法验证的非标准身份验证凭据可能仍然有效——尝试切换到该模型。如果身份验证失败，请查看提供商的文档

​
设置默认模型

您可以设置一个持久的默认模型，该模型将用于所有未来的 CLI 启动：
  • 通过模型选择器： 打开 /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。
如果没有默认值，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 上编辑此页面或提交问题。