> ## Documentation Index
> Fetch the complete documentation index at: https://nvd-54.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 模型提供商

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

深度智能体 CLI 支持任何[与 LangChain 兼容的聊天模型提供商](/oss/javascript/integrations/chat)，可以使用几乎任何支持工具调用的大语言模型(LLM)。任何暴露 OpenAI 兼容或 Anthropic 兼容 API 的服务也可开箱即用——参见[兼容 API](/oss/javascript/deepagents/cli/configuration#compatible-apis)。

## 快速入门

CLI 与[以下模型提供商](#provider-reference)自动集成：除了安装相关提供商包外，无需额外配置。

1. **安装提供商包**

   每个模型提供商需要安装其对应的 LangChain 集成包。这些包作为安装 CLI 时的可选附加项提供，特意这样做是为了保持应用程序轻量：

   ```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
   # 选择提供商快速安装
   # 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 中导出：

   <Tabs>
     <Tab title="OpenAI">
       <CodeGroup>
         ```bash 永久添加 theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
         mkdir -p ~/.deepagents
         echo 'OPENAI_API_KEY=your-api-key' >> ~/.deepagents/.env
         ```

         ```bash 仅当前会话添加 theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
         export OPENAI_API_KEY="your-api-key"
         ```
       </CodeGroup>
     </Tab>

     <Tab title="Anthropic">
       <CodeGroup>
         ```bash 永久添加 theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
         mkdir -p ~/.deepagents
         echo 'ANTHROPIC_API_KEY=your-api-key' >> ~/.deepagents/.env
         ```

         ```bash 仅当前会话添加 theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
         export ANTHROPIC_API_KEY="your-api-key"
         ```
       </CodeGroup>
     </Tab>

     <Tab title="Google">
       <CodeGroup>
         ```bash 永久添加 theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
         mkdir -p ~/.deepagents
         echo 'GOOGLE_API_KEY=your-api-key' >> ~/.deepagents/.env
         ```

         ```bash 仅当前会话添加 theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
         export GOOGLE_API_KEY="your-api-key"
         ```
       </CodeGroup>
     </Tab>

     <Tab title="其他">
       CLI 支持任何支持工具调用的大语言模型(LLM)。完整的支持提供商列表及其所需环境变量请参见[提供商参考](#provider-reference)。
     </Tab>
   </Tabs>

   要配置模型参数，请参见[模型参数](/oss/javascript/deepagents/cli/providers#model-parameters)。

   您还可以使用 [`DEEPAGENTS_CLI_` 前缀](/oss/javascript/deepagents/cli/configuration#deepagents_cli_-prefix)将凭证的作用域限定在 CLI 内。

## 提供商参考

深度智能体 CLI 使用 Python 构建，请使用 [Python 提供商参考文档](https://docs.langchain.com/oss/python/deepagents/cli/providers#provider-reference)。

### 模型路由器和代理

[OpenRouter](https://openrouter.ai/) 和 [LiteLLM](https://docs.litellm.ai/) 等模型路由器通过单一端点提供多个提供商的模型访问。

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

| 路由器        | 包                                                                      |
| ---------- | ---------------------------------------------------------------------- |
| OpenRouter | [`langchain-openrouter`](/oss/javascript/integrations/chat/openrouter) |

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

```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
uv tool install 'deepagents-cli[openrouter]'
```

**LiteLLM** 也是内置提供商：

```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
uv tool install 'deepagents-cli[litellm]'
```

## 切换模型

在 CLI 中切换模型，可以：

1. **使用交互式模型选择器**——使用 `/model` 命令。这会显示从每个已安装 LangChain 提供商包的[模型配置文件](/oss/javascript/langchain/models#model-profiles)中获取的可用模型。

   <Note>
     并非所有模型都会显示在这里。如果您的模型缺失，直接传入模型名称（例如 `/model gpt-5.5`）。详见[哪些模型出现在选择器中](#which-models-appear-in-the-switcher)。
   </Note>
2. **直接指定模型名称**作为参数，例如 `/model gpt-5.5`。您可以使用所选提供商支持的任何模型，无论它是否出现在选项 1 的列表中。模型名称将被传递到 API 请求中。
3. **启动时指定模型**，通过 `--model`，例如

   ```txt theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
   deepagents --model openai:gpt-5.5
   ```

<Accordion title="模型解析顺序" icon="list-numbers">
  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`）使用。
</Accordion>

### 哪些模型出现在选择器中

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

<Accordion title="选择器如何构建其模型列表" icon="list-search">
  交互式 `/model` 选择器动态构建其列表——它不是 CLI 中内置的硬编码列表。当以下**所有**条件都为真时，模型会出现在选择器中：

  1. **提供商包已安装。** 每个提供商（例如 `langchain-anthropic`、`langchain-openai`）必须与 `deepagents-cli` 一起安装——作为[安装附加项](/oss/javascript/deepagents/cli/providers#quickstart)（例如 `uv tool install 'deepagents-cli[ollama]'`）或稍后通过 `uv tool install deepagents-cli --with <package>` 添加。如果包缺失，其整个提供商部分将不出现在选择器中。
  2. **模型有启用了 `tool_calling` 的配置文件。** CLI 需要工具调用支持，因此配置文件中没有 `tool_calling: true` 的模型将被排除。这是模型缺失最常见的原因。对于不捆绑配置文件的提供商（参见[提供商参考](#provider-reference)表），您可以在 `config.toml` 中定义：

     ```toml theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
     [models.providers.ollama.profile."qwen3:4b"]
     tool_calling = true
     max_input_tokens = 32768
     max_output_tokens = 8192
     ```

     这不是模型出现在选择器中的严格要求——将其添加到 [`models` 列表](/oss/javascript/deepagents/cli/configuration#adding-models-to-the-interactive-switcher)也可以且更简单。当您希望 CLI 了解模型的上下文窗口和能力（用于自动摘要等功能）时，配置文件很有用。所有可覆盖字段请参见[配置文件覆盖](/oss/javascript/deepagents/cli/configuration#profile-overrides-advanced)。
  3. **模型接受并产生文本。** 配置文件中明确将 `text_inputs` 或 `text_outputs` 设置为 `false` 的模型（例如嵌入或图像生成模型）将被排除。

  在 `config.toml` 的 [`[models.providers.<name>].models`](/oss/javascript/deepagents/cli/configuration#adding-models-to-the-interactive-switcher) 下定义的模型会绕过配置文件过滤——无论配置文件元数据如何，它们始终出现在选择器中。这是添加列表中缺失模型的推荐方式。

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

  #### 故障排除缺失模型

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

### 设置默认模型

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

* **通过模型选择器：** 打开 `/model`，导航到所需模型，按 `Ctrl+S` 将其固定为默认。在当前默认值上再次按 `Ctrl+S` 取消固定。
* **通过命令：** `/model --default provider:model`（例如 `/model --default anthropic:claude-opus-4-7`）
* **通过配置文件：** 在 `~/.deepagents/config.toml` 中设置 `[models].default`（参见[配置](/oss/javascript/deepagents/cli/configuration)）。
* **从 shell：**

  ```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
  deepagents --default-model anthropic:claude-opus-4-7
  ```

查看当前默认值：

```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
deepagents --default-model
```

清除默认值：

* **从 shell：**

  ```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
  deepagents --clear-default-model
  ```

* **通过命令：** `/model --default --clear`

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

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

### 模型参数

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

1. **启动时一次性使用 `--model-params`。** JSON 字符串，仅限当前会话：

   ```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
   # 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 语法——无需重启即可切换参数（以及可选的模型）：

   ```txt theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
   /model --model-params '{"temperature": 0.7}' anthropic:claude-opus-4-7
   /model --model-params '{"num_ctx": 16384}'           # 打开选择器，将参数应用到选择的模型
   ```

3. **在 `config.toml` 中持久化。** 提供商级默认值（可选按模型子表覆盖）在每次启动时应用：

   ```toml theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
   [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` 中按模型子表覆盖提供商级键（浅合并——完整语义请参见[模型构造函数参数](/oss/javascript/deepagents/cli/configuration#model-constructor-params)）。`--model-params` 不能与 `--default` 组合使用。

<Tip>
  底层聊天模型构造函数接受的任何关键字参数都有效。完整列表请参阅提供商的参考文档——例如 [`ChatAnthropic`](https://reference.langchain.com/python/langchain-anthropic/langchain_anthropic/chat_models/ChatAnthropic)、[`ChatOpenAI`](https://reference.langchain.com/python/langchain-openai/langchain_openai/chat_models/base/ChatOpenAI)、[`ChatOllama`](https://reference.langchain.com/python/langchain-ollama/langchain_ollama/chat_models/ChatOllama)。未知的关键字参数会被转发到上游 API 请求，因此新发布的参数无需 CLI 更新即可使用。
</Tip>

<Note>
  不要在 `params` 中放置凭证（`api_key`）——使用 [`api_key_env`](/oss/javascript/deepagents/cli/configuration#provider-configuration) 指向环境变量。
</Note>

要覆盖模型运行时*配置文件*（`max_input_tokens`、`tool_calling`、能力标志）上的字段——与构造函数参数不同——请参见[配置文件覆盖](/oss/javascript/deepagents/cli/configuration#profile-overrides-advanced)。

## 高级配置

有关提供商参数、配置文件覆盖、自定义基础 URL、兼容 API、任意提供商和生命周期钩子的详细配置，请参见[配置](/oss/javascript/deepagents/cli/configuration)。

***

<div className="source-links">
  <Callout icon="terminal-2">
    [通过 MCP 连接这些文档](/use-these-docs)到 Claude、VSCode 等以获取实时解答。
  </Callout>

  <Callout icon="edit">
    [在 GitHub 上编辑此页面](https://github.com/langchain-ai/docs/edit/main/src/oss/deepagents/cli/providers.mdx) 或 [提交 issue](https://github.com/langchain-ai/docs/issues/new/choose)。
  </Callout>
</div>