OpenCode CLI 接入指引

OpenCode 是一款专为全栈工程师设计的现代终端 AI 研发辅助命令行工具。它深度集成了 LSP 语法服务、MCP 工具生态，具备自主式多文件编辑、命令执行与项目上下文理解能力。

通过 GWLLM，您可以在 OpenCode 中无缝使用全球领先的旗舰代码模型（如 claude-opus-5-5、gpt-6-sol、gemini-4-argon 等）。

---

配置文件路径

OpenCode 的全局配置文件位于：

• macOS / Linux：~/.config/opencode/opencode.json
• Windows：%USERPROFILE%\.config\opencode\opencode.json

---

配置步骤

打开 opencode.json 配置文件，在 provider 字段中添加 gwllm 自定义接入服务：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "gwllm": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "GWLLM",
      "options": {
        "baseURL": "https://gwllm.com/v1",
        "apiKey": "sk-您的GWLLM令牌"
      },
      "models": {
        "claude-sonnet-5-5": {
          "name": "Claude Sonnet 5.5"
        },
        "gpt-6-sol": {
          "name": "GPT-6 Sol"
        },
        "claude-opus-5-5": {
          "name": "Claude Opus 5.5"
        },
        "gemini-4-argon": {
          "name": "Gemini 4 Argon"
        }
      }
    }
  }
}

安全建议：使用环境变量引用

如果您不想将 API 密钥以明文形式保存在配置文件中，可将其替换为环境变量引用：

"apiKey": "{env:GWLLM_API_KEY}"

然后在终端或系统环境中配置 export GWLLM_API_KEY="sk-xxxxxx" 即可。

---

启动与使用

配置完成后，OpenCode 会自动感知并加载新模型，无需重启后台服务。

1. 验证模型是否加载成功

在终端运行以下命令，查看模型列表中是否已出现 GWLLM：

opencode models

2. 交互式会话

进入项目目录，指定 GWLLM 模型启动交互：

opencode --model gwllm/claude-sonnet-5-5

3. 一次性任务执行 (Non-interactive)

opencode run --model gwllm/claude-sonnet-5-5 "检查当前目录下的 package.json，帮我升级有安全风险的依赖"