Deep Agents Code 支持任何兼容 LangChain 的聊天模型提供商，使得几乎任何支持工具调用的 LLM 都可以使用。任何暴露兼容 OpenAI 或 Anthropic API 的服务也可以开箱即用——请参阅兼容 API。

​
快速入门

Deep Agents Code 会自动集成以下模型提供商：除了安装相应的提供商包外，无需额外配置。
  1. 安装提供商包 每个模型提供商都需要其对应的 LangChain 集成包。这些包作为可选额外组件提供，以保持应用程序轻量。OpenAI、Anthropic 和 Gemini 默认包含在内。使用会话内的 /install 命令，或使用 Shell 命令 dcode --install 安装任何其他额外组件：
    运行不带参数的 /install 可列出有效的额外组件。要在初始 CLI 安装期间预安装额外组件，请设置 DEEPAGENTS_CODE_EXTRAS：
  2. 设置凭据 使用 /auth 凭据管理器为你的提供商添加 API 密钥：
    /auth 会显示可用提供商列表并存储凭据，以便跨会话重用。 对于非交互式运行、CI/CD 或任何没有 TUI（文本用户界面）的环境，可以使用 dcode auth set 从 Shell 存储相同的密钥，或者改为设置提供商的环境变量。完整的密钥解析顺序、用于将密钥作用域限定到 Deep Agents Code 的 DEEPAGENTS_CODE_ 前缀以及各提供商的环境变量，请参阅提供商凭据和提供商参考。 要配置模型参数，请参阅模型参数。

​
提供商参考

使用了这里未列出的提供商？请参阅任意提供商：任何兼容 LangChain 的提供商都可以在 Deep Agents Code 中使用，但需要额外设置。
你可以通过添加 DEEPAGENTS_CODE_ 前缀将任何凭据的作用域限定到 Deep Agents Code。例如，在 Deep Agents Code 内部，DEEPAGENTS_CODE_OPENAI_API_KEY 优先于 OPENAI_API_KEY，且不影响其他工具。详情请参阅 DEEPAGENTS_CODE_ 前缀。
模型配置文件提供了交互式 /model 切换器使用的模型元数据。如果某个模型未出现在切换器中，请直接传递模型名称，或通过 config.toml 添加它。

​
使用 ChatGPT 登录

openai_codex 提供商允许你使用 OpenAI 的 Codex 模型，并通过你的付费 ChatGPT 订阅进行身份验证，而无需 OPENAI_API_KEY。你使用 ChatGPT 帐户登录，它会显示为 /auth 和 /model 切换器中的一个独立提供商，与基于 API 密钥的 openai 提供商区分开来。
1

开始登录

在任何会话中运行 /auth 并选择 openai_codex。由于 ChatGPT 是通过浏览器登录的，这将启动浏览器登录流程，而不是要求输入 API 密钥。
2

在浏览器中授权

Deep Agents Code 会打开你的浏览器跳转到 ChatGPT 登录页面。如果无法打开浏览器（例如通过 SSH 连接），它也会在屏幕上显示登录 URL，以便你可以在另一台设备的浏览器中复制并访问。
3

选择 Codex 模型

登录后，Codex 模型会出现在 /model 切换器的 openai_codex 提供商下。可以直接使用其规格切换模型：
你的登录状态在会话间保持。要检查状态或退出登录，请运行 /auth，选择 openai_codex，然后选择重新认证或退出登录。
openai_codex 与 openai 是分开的。要使用标准 API 密钥访问 OpenAI 模型，请使用常规的 openai 提供商（例如 /model openai:gpt-5.5）。
某些提供商特定的帐户类型或密钥作用域可能不适用于 API 访问。如果提供商在 /auth 中显示已配置但请求仍然失败，请验证帐户计划和 API 密钥权限是否符合提供商的 API 要求。

​
模型路由器和代理

像 OpenRouter 和 LiteLLM 这样的模型路由器可以通过单个端点访问来自多个提供商的模型。 为这些服务使用专用的集成包： OpenRouter 是一个内置提供商——安装额外组件后可直接使用：
LiteLLM 也是一个内置提供商：

​
切换模型

要在 Deep Agents Code 中切换模型，有以下几种方式：
  1. 使用交互式模型切换器，通过 /model 命令。
    并非所有模型都会出现在这里。如果你的模型缺失，请直接传递模型名称（例如 /model gpt-5.5）或将其添加到 config.toml。
  2. 直接指定模型名称作为参数，例如 /model gpt-5.5。你可以使用所选提供商支持的任何模型，无论它是否出现在选项 1 的列表中。模型名称将传递给 API 请求。
  3. 在启动时通过 --model 指定模型，例如：
当 Deep Agents Code 启动时，它会按以下顺序解析使用哪个模型：
  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].recent）使用。

​
切换器中显示哪些模型

/model 选择器会根据已安装的提供商包动态构建其列表。展开下方查看完整标准和故障排除。
交互式 /model 选择器根据已安装的提供商包和 config.toml 中配置的模型来构建其列表。当满足以下条件时，一个模型会显示出来：
  1. 提供商包已安装。
  2. 该模型来自提供商包、本地提供商或你的 config.toml。
  3. 模型配置文件未将文本输入或输出标记为不支持。
如果模型缺失，请直接使用 /model <provider>:<model> 或将其添加到 [models.providers.<name>].models。
凭据状态不影响模型是否列出。你仍然可以选择缺少凭据的模型。提供商会在请求时报告身份验证错误。

​
开放权重模型

如果你想使用开放权重模型，根据你偏好本地推理还是云端托管推理，通常有两条路径。 使用 Ollama 进行本地推理是免费入门最简单的方法，无需 API 密钥：
  1. 安装 Ollama 并拉取一个模型，例如：
  2. 安装 Ollama 额外组件：
  3. 选择模型：
    使用交互式切换器，或直接通过 /model ollama:qwen3:4b 传递模型。
通过 Groq 进行云端托管的开放权重模型让你无需在本地运行任何东西即可获得快速推理：
  1. 在 console.groq.com 获取免费 API 密钥。
  2. 安装 Groq 额外组件：
  3. 选择模型：
    使用交互式切换器，或直接通过 /model groq:openai/gpt-oss-120b 传递模型。
Fireworks 是另一个流行的开放权重模型云端提供商：
使用交互式切换器，或直接通过 /model fireworks:accounts/fireworks/models/deepseek-v4-pro 传递模型。 Baseten 是另一个用于开放权重模型的云端提供商：
使用交互式切换器，或直接通过 /model baseten:moonshotai/Kimi-K2.7-Code 传递模型。
如果你希望在安装 CLI 的同时预安装某个提供商，请在初始安装期间使用 DEEPAGENTS_CODE_EXTRAS：
你可以组合多个提供商：DEEPAGENTS_CODE_EXTRAS="groq,fireworks,ollama"。如果 Deep Agents Code 已经安装，请改为在会话中使用 /install <extra> 或在 Shell 中使用 dcode --install <extra>。
Together、OpenRouter 和 Hugging Face (langchain-huggingface) 是云端托管开放权重模型的其他选择。凭据和包名请参阅提供商参考。

​
设置默认模型

你可以设置一个持久的默认模型，适用于所有未来的 CLI 启动：
  • 通过模型选择器： 打开 /model，导航到所需的模型，然后按 Ctrl+S 将其固定为默认值。在当前默认模型上再次按 Ctrl+S 可清除默认设置。
  • 通过命令： /model --default provider:model（例如，/model --default anthropic:claude-opus-4-8）
  • 通过配置文件： 在 ~/.deepagents/config.toml 中设置 [models].default（参见配置）。
  • 从 Shell：
要查看当前默认模型：
要清除默认设置：
  • 从 Shell：
  • 通过命令： /model --default --clear
  • 通过模型选择器： 在当前固定的默认模型上按 Ctrl+S。
如果没有设置默认模型，Deep Agents Code 将使用最近使用的模型。

​
模型参数

向模型传递额外的构造函数关键字参数——采样控制、推理/思考预算、上下文窗口大小、请求超时以及底层聊天模型类接受的任何其他内容。设置这些参数有三个地方，按优先级从高到低排列：
  1. 在启动时使用 --model-params 一次性设置。 JSON 字符串，仅限当前会话：
  2. 会话中途通过 /model --model-params 设置。 相同的 JSON 语法——无需重启即可交换参数（以及可选的模型）：
  3. 在 config.toml 中持久化设置。 提供商级别的默认值（带有可选的每个模型的子表），在每次启动时应用：
CLI 标志会覆盖配置文件中的 params，并且仅限于当前会话（会话中途的更改不会被持久化）。config.toml 中每个模型的子表会覆盖提供商级别的键（浅合并——完整语义请参阅模型构造函数参数）。--model-params 不能与 --default 组合使用。 对于重试次数，请优先使用 --max-retries 或顶层的 [retries] 配置。
底层聊天模型构造函数接受的任何关键字参数都是有效的。请参考提供商的参考文档获取完整列表——例如 ChatAnthropic、ChatOpenAI、ChatOllama。未知的关键字参数会被转发到上游 API 请求，因此新发布的参数无需 CLI 更新即可使用。
不要在 params 中放置凭据（api_key）——请使用 api_key_env 指向一个环境变量。
要覆盖模型运行时配置文件（max_input_tokens、tool_calling、能力标志）上的字段——这与构造函数参数不同——请参阅配置文件覆盖。

​
高级配置

有关提供商参数、配置文件覆盖、自定义基础 URL、兼容 API、任意提供商和生命周期钩子的详细配置，请参阅配置文件和钩子。
Connect these docs to Claude, VSCode, and more via MCP for real-time answers.
Edit this page on GitHub or file an issue.