From 3834d3c6ad835a4b80e06d9e1b0e0ab90045a165 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=AE=87=E5=AE=99=E7=86=8AYzx?=
 <53250620+849261680@users.noreply.github.com>
Date: Tue, 2 Jun 2026 01:03:01 +0800
Subject: [PATCH] docs: clarify model config IDs

---
 packages/web/src/content/docs/config.mdx | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/web/src/content/docs/config.mdx b/packages/web/src/content/docs/config.mdx
index 346ce63805ee..6b8d9bb8f3f9 100644
--- a/packages/web/src/content/docs/config.mdx
+++ b/packages/web/src/content/docs/config.mdx
@@ -366,7 +366,10 @@ You can configure the providers and models you want to use in your OpenCode conf
 }
 ```
 
+The `model` and `small_model` values use the `provider_id/model_id` format. For built-in providers, use the provider and model IDs shown by `opencode models` or [Models.dev](https://models.dev). For custom providers, `provider_id` is the key under `provider`, and `model_id` is the key under that provider's `models`.
+
 The `small_model` option configures a separate model for lightweight tasks like title generation. By default, OpenCode tries to use a cheaper model if one is available from your provider, otherwise it falls back to your main model.
+The small model can use a different provider than your main model.
 
 Provider options can include `timeout`, `chunkTimeout`, and `setCacheKey`: