From 777e8bc041fc59a655c2dc32972b6439109d17a9 Mon Sep 17 00:00:00 2001
From: ufodar <904869198@qq.com>
Date: Tue, 24 Mar 2026 12:26:47 +0800
Subject: [PATCH] docs(web): clarify GitHub token usage

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

diff --git a/packages/web/src/content/docs/github.mdx b/packages/web/src/content/docs/github.mdx
index a31fe1e7be82..1c45fa52e8b4 100644
--- a/packages/web/src/content/docs/github.mdx
+++ b/packages/web/src/content/docs/github.mdx
@@ -97,6 +97,15 @@ Or you can set it up manually.
     issues: write
   ```
 
+  :::note
+  `token` and `GITHUB_TOKEN` here only authenticate GitHub operations such as
+  comments, commits, and pull requests. They do not configure a model provider.
+
+  The `opencode github install` flow does not currently offer
+  `github-copilot` in its provider list, so set up the GitHub agent with a
+  provider that has its own API credentials available to the runner.
+  :::
+
   You can also use a [personal access tokens](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)(PAT) if preferred.
 
 ---