OpenCode API Key 怎么拿：申请、配置与用量查看

OpenCode 本身通常不签发一张通用 API Key，而是让你接入已有模型服务商或使用内置免费模型；本文说明可选的申请路径、配置位置和用量查看方法。

先分清：OpenCode Key 与模型服务商 Key

截至 2026 年 10 月 28 日抓取时，OpenCode 是一个开源 AI 编程代理，可以在终端、IDE 和桌面应用中使用。它支持直接使用免费模型，也可以接入 OpenAI、Anthropic、xAI 等模型服务商。

因此，“申请 OpenCode API Key”通常有两种含义：

• 如果你想使用 ChatGPT Plus/Pro 或 GitHub Copilot，优先在 OpenCode 中登录对应账号，不必另外申请一张 API Key。
• 如果你要接入自己的模型服务商，则到该服务商的开发者控制台申请 API Key，再把这张 Key 配给 OpenCode。

OpenCode 官方首页说明，它自带免费模型，用户不创建账号也能使用；同时支持 ChatGPT Plus/Pro、GitHub Copilot 登录，以及通过 Models.dev 连接 75 个以上的模型服务商和本地模型。

这里容易混淆的是：OpenCode 的控制台账号、模型服务商的 API Key、第三方网关的 server key，是三套不同的凭据。后文会分别说明，避免把 OpenCode Go 上游 Key 和网关生成的 Key 混为一谈。

你的目标	应该申请什么	是否一定付费	更适合谁
直接试用 OpenCode	使用内置免费模型	否	首次体验、临时改代码
使用已有订阅	登录 ChatGPT Plus/Pro 或 GitHub Copilot	取决于原订阅	已有 AI 编程订阅的人
调用自有模型账号	模型服务商的 API Key	取决于服务商	需要固定模型、程序化调用的人
给团队网关分配凭据	网关的 server key	取决于网关上游	多人共用一个网关的人

安装 OpenCode，并先确认它能运行

前置条件

1. 准备一台能访问 npm、Homebrew 或官方安装脚本的电脑；使用 npm 方案时，运行 node -v，确认已安装兼容的 Node.js 和 npm。
2. 准备一个模型入口：可以是 OpenCode 内置免费模型、ChatGPT Plus/Pro、GitHub Copilot，或者其他模型服务商的 API Key。
3. 如果准备使用付费模型，提前登录对应服务商控制台；运行 opencode --version，确认命令行程序已经安装。

官方仓库给出的安装方式包括安装脚本、npm、Homebrew、Arch Linux、mise 和 Nix。下面三条命令都来自官方仓库 README，可按自己的系统选择其一：

curl -fsSL https://opencode.ai/v2/install | bash

npm i -g @opencode/cli@latest

brew install anomalyco/tap/opencode-v2

macOS 用户如果准备安装桌面版，也可以使用官方仓库列出的 Homebrew 命令：

brew install --cask opencode-desktop

官方说明安装脚本会把 OpenCode 放到 $HOME/.opencode/bin。如果安装后终端找不到 opencode，先确认这个目录是否已经加入 PATH，再重新打开终端；不要同时安装多个来源不一致的旧版本。官方仓库 README 还特别提醒，升级前应移除早于 0.1.x 的版本。

安装脚本会下载并执行远程内容。处理公司设备或敏感仓库时，应先打开 https://opencode.ai/v2/install 检查内容，或者改用 npm、Homebrew 等能由本地包管理器记录安装来源的方案。

不申请 API Key 的两条路径

直接使用免费模型

这是最快验证 OpenCode 是否适合当前项目的办法。进入 https://opencode.ai/，点击顶部的 Docs，按入门文档启动 OpenCode，并在模型选择界面挑免费模型。

官方 FAQ 对这一点写得很明确：OpenCode 包含一组免费模型，不创建账号也能使用；只有连接其他模型服务商时，才可能产生额外费用。

这条路径适合做三件事：确认终端或桌面端能正常打开、测试项目是否能被读取、确认交互流程是否符合习惯。它不适合需要固定模型版本、严格预算控制或生产环境稳定性的任务，因为免费模型集合可能调整。

复用 ChatGPT Plus/Pro 或 GitHub Copilot

如果你已经购买 ChatGPT Plus/Pro，或者正在使用 GitHub Copilot，OpenCode 官方首页提供对应登录入口。网页上的入口名称分别是 ChatGPT Plus/Pro 和 GitHub Copilot。

这条路径的价值在于复用已有订阅，不必再为同一个模型单独计算 API 费用。进入 https://opencode.ai/ 后点击对应入口，按浏览器提示完成授权，然后回到模型列表，确认已登录账号提供的模型能够被选择。

注意，OpenCode 能复用订阅，不代表它能调用订阅包含的全部模型。模型名单、可访问范围和额度仍由原服务商控制。验证时应选一个模型完成真实请求，而不是只看账号是否已经出现在列表中。

需要自己的 Key 时，按服务商流程申请

OpenCode 官方首页把 Models、Console 和 Subscription 放在顶部导航中。模型服务商的 Key 应从对应服务商的开发者控制台申请，而不是从 OpenCode GitHub 仓库或安装脚本中寻找。

可执行路径是：

1. 在 https://opencode.ai/ 点击顶部 Models，确认准备接入的服务商。
2. 打开该服务商的官方开发者控制台，找到 API Keys 或 API 管理页面。
3. 创建一张新 Key，复制后立即保存。完整 Key 通常只在创建时显示，关闭页面后未必能再次查看。
4. 回到 OpenCode，按服务商对应的认证方式配置或登录。
5. 选择刚才的服务商和模型，发送一条最小请求，确认模型能返回内容。

这里不能给出一段适用于所有服务商的配置命令，因为不同服务商使用的环境变量名和认证格式并不统一，OpenCode 官方提供的登录入口也会随服务商变化。配置时应以所选服务商的官方说明为准，不要照搬其他教程里的 API_KEY、TOKEN 或自定义变量名。

对普通用户来说，选择顺序很简单：先试免费模型；已有订阅就复用订阅；确实需要自有账号、固定账单或程序化调用时，再申请服务商 Key。这样可以避免为了“使用 OpenCode”额外创建一张用不到的 Key。

多人网关：Key 应在网关控制台生成

如果 OpenCode 实际连接的是一个团队共用的模型网关，那么要管理的是网关自己的 server key，而不是上游模型服务商的 Key。

一份 2026 年 10 月 28 日发布的第三方网关管理文档给出了完整操作路径：登录管理控制台，进入 /#api-keys，然后创建、重命名、启用、停用或删除 Key。创建后，页面会提供完整密钥及对应环境变量，复制入口就在创建结果中。

这份文档还给出了可执行的限制与行为：

操作或状态	文档说明
自动生成 Key	使用 192 位随机密钥
自定义 Key	长度为 16—256 位，只允许英文字母、数字、-、_、.
用量窗口	分别显示近 1 小时与累计用量
停用或删除	新请求返回 401，已在途的请求可以完成
启用数量	至少保留一个启用的 Key
监控接口	GET /api/monitor 的 usage.server_keys 返回同一份统计
数据保存	监控数据只存在内存中，进程重启后清零

需要注意，网关 Key 的创建、停用和删除都会热应用，不需要重启服务；但用量统计不是持久化账本，进程重启后不能拿它做长期对账。

这里还存在一个容易漏掉的边界：Playground 调试流量会单独归到 playground，不会记到任何一张 server key。也就是说，控制台总请求数与各 Key 用量之和可能不同，不能把两者直接当作同一个指标比较。

用量、状态和常见卡点

怎么看用量

在网关的 /#api-keys 页面，Key 列表会显示名称、尾码、状态、用量和创建时间。尾码用于辨认密钥，不会暴露完整内容。需要程序化查看时，可调用文档给出的监控接口：

curl http://127.0.0.1:3000/api/monitor

上面的主机名和端口应以实际网关配置为准；如果网关使用 HTTPS、反向代理或非默认端口，需要替换为实际管理地址。返回数据中的 usage.server_keys 与网页按 Key 展示的统计使用同一口径。

Key 失效后为什么返回 401

当 Key 被停用或删除时，新请求会返回 401。这通常不是 OpenCode 本地安装损坏，而是网关已经拒绝该凭据。依次检查 Key 是否仍为启用状态、请求是否使用了最新保存的完整值，以及网关进程是否已经热加载了管理配置。

生成后复制不到完整 Key

完整密钥和对应环境变量只在创建结果页提供。若已经离开该页面，应在列表中创建一张新 Key，再替换客户端配置；不要依赖尾码恢复完整 Key。

环境变量没有生效

检查当前终端是否导出了网关创建页面提供的环境变量，然后重新启动 OpenCode。环境变量在进程启动时读取，修改 shell 配置后，旧进程不会自动获得新值。

用量突然归零

网关文档明确说明监控数据只保存在内存，热重载可以保留，但进程重启会清零。需要长期统计时，应在网关之外保存监控接口返回值；这是根据其内存存储机制得出的使用建议，不是网关已经提供的历史报表功能。

怎么确认已经配置成功

成功标志不是“页面显示已保存”，而是完成一次真实调用：

• 使用免费模型时，OpenCode 能返回模型响应，且无需输入服务商 Key。
• 使用订阅登录时，模型列表出现该订阅账户提供的模型，并能完成一次对话。
• 使用服务商 Key 时，模型请求成功，没有出现认证失败。
• 使用网关 Key 时，/#api-keys 中该 Key 为启用状态；GET /api/monitor 的 usage.server_keys 能看到对应统计；停用后新请求明确返回 401。

若要复核 OpenCode 本体，可查看官方首页 https://opencode.ai/、官方仓库 https://github.com/anomalyco/opencode 和仓库许可证 https://github.com/anomalyco/opencode?tab=MIT-1-ov-file#readme。网关管理的具体实现则应回到其管理文档 https://github.com/jasonxu114514/opencode2api/blob/58f56676ba1438adb30604b889bf36db2a1542a1/docs/management.zh-CN.md 核对，并以实际部署版本为准。

参考来源

• 管理控制台：模型轮转、Go 额度与 API Key
• 管理控制台：模型轮转、Go 额度与 API Key – 管理控制台：模型轮转、Go 额度与 API Key
• magpie-intern-ai – npm Package Security Analysis – Socket