在 OpenCode 中配置 Grok
更新于:
在 OpenCode 中接入 Grok：通过 Grok API Dev 配置不到 5 分钟。
什么是 OpenCode
OpenCode 自称是开源 AI 编程智能体：它能在终端、IDE 或桌面应用中协助你写代码。它刻意不绑定单一厂商——通过 Models.dev 可接入 75 个以上的提供商，包括本地模型，而任何 OpenAI 兼容端点都可以声明为你自己的提供商。Grok 4.5 正是通过后者接入的。
终端、桌面或 IDE
同一个智能体提供终端界面、桌面应用和编辑器扩展三种形态，提供商配置三者共用。
任意模型与提供商
开箱即用 75+ 提供商，再加上你在配置中声明的 OpenAI 兼容端点，密钥和地址始终归你所有。
需要准备什么
- Grok API Dev 账号——新账号赠送 $0.25 测试额度，并可直接在控制台生成 API 密钥。
配置 OpenCode
安装 OpenCode
最快的方式是官方安装脚本。也可通过 npm、Homebrew、Scoop 和 Chocolatey 安装。先运行一次，让它创建自己的配置目录。
curl -fsSL https://opencode.ai/install | bash在配置中注册提供商
OpenCode 的全部设置都在一个文件中。用任意编辑器打开它，并加入下面的提供商配置块。
~/.config/opencode/opencode.json
如果该文件尚不存在，请连同上级目录一起创建。
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"llm-gate": {
"npm": "@ai-sdk/openai-compatible",
"name": "LLM Gate",
"options": {
"baseURL": "https://api.llm-gate.tech/v1",
"apiKey": "YOUR_API_KEY"
},
"models": {
"grok-4.5": {
"name": "Grok 4.5"
}
}
}
}
}- 将 YOUR_API_KEY 替换为控制台中的密钥，并且不要把该文件放进代码仓库。
运行并验证
保存文件，在项目目录中启动 OpenCode。在排查问题前值得知道：OpenCode 会合并而非替换配置文件，且项目根目录中的 opencode.json 优先级高于全局配置。因此如果模型没有出现，请先检查仓库中是否存在覆盖你的提供商的配置，再去改动全局文件。
opencodeopencode
Ask anything... "Fix broken tests"
Build · Grok 4.5 LLM Gate
tab agentsctrl+p commands
Tip Press ctrl+p to see all available actions and commands
常见问题
为什么提供商叫 llm-gate 而不是 grok？
provider 下的键是你自己取的标识符，OpenCode 会把它显示为提供商名称。它与模型无关：模型是 grok-4.5，声明在下方的 models 块中。
OpenCode 看不到模型，是什么原因？
三个常见原因：baseURL 缺少 /v1 后缀，地址必须正好是 https://api.llm-gate.tech/v1；配置文件不在 ~/.config/opencode/opencode.json；或者合并后 JSON 不合法——多一个逗号就会让 OpenCode 跳过整个文件。
npm 字段有什么用？
它告诉 OpenCode 为该提供商加载哪个适配器。@ai-sdk/openai-compatible 是通用的 OpenAI 兼容适配器，正是 GrokAPI 端点所需要的。缺少它，OpenCode 就不知道如何与提供商通信。
可以同时保留其他提供商吗？
可以。provider 是一个对象，多个提供商可以并存：把我们的加在现有键旁边，而不是替换它们。之后可在 OpenCode 内部切换模型。
把密钥写在配置文件里安全吗？
该文件位于用户主目录而非项目中，默认不会进入代码仓库。只要不把它复制到会被提交的项目目录即可；一旦泄露，请在控制台重新生成密钥。