知识库章节 ▾

导航

▸ 从这里开始 按角色

类别

工具 52
词汇表 12

工具

OpenCode：在终端中使用自己的模型

OpenCode 是一款开源 AI 编程助手，直接跑在终端里。无需订阅，没有 vendor lock-in。支持自动补全、代码生成、重构和代码讲解——全部通过 OpenAI 兼容 API 完成。

与专有工具（GitHub Copilot、Cursor Pro）不同，OpenCode 完全免费且开源。唯一的开销就是 LLM 的 API 服务商。接入 JoinGonka Gateway 后，这笔开销可以降到每月 $0.30。

配置只需几分钟——用一条命令的安装器，或用 OpenCode 原生方式手动配置，都无需修改环境变量。

步骤 1：获取 API 密钥

所有工具的通用操作流程：

  1. 在 gate.joingonka.ai/register 注册。
  2. 系统自动发放 3M免费代币。
  3. 在 Dashboard 中创建 API 密钥（格式：jg-xxx）。

此密钥同样适用于 Cursor、Cline、Continue.dev 及任何兼容 OpenAI 的客户端。

步骤 2：配置 OpenCode

最简单的方法是通过单行安装程序进行设置。对于 CLI/文件工具，它将自动注册 JoinGonka 提供程序 (baseUrl, models) 并将密钥保存到 OpenCode 的原生存储中，而无需触碰环境变量；对于 UI 工具，它将显示准备好的输入值：

npx @joingonka/setup --tool opencode

安装程序是通用的（如果不加标志，它会提示从列表中选择工具），它会询问 jg-… 密钥，并在配置完成后通过网关请求进行实时验证。它不会更改其他设置。如果您更喜欢手动设置，请参考下方的手动方法。

手动配置（方案 B）

OpenCode 原生存储密钥并在其配置文件中描述提供程序——因此手动设置也不会触及环境变量，您其他与 OpenAI 兼容的工具将继续照常工作。

第 1 步 — 保存密钥。 运行 opencode auth login，选择 Other，输入提供程序 ID joingonka 并粘贴 jg-… 密钥。OpenCode 将其保存到 ~/.local/share/opencode/auth.json。

第 2 步 — 描述提供程序。 添加到 ~/.config/opencode/opencode.json (joingonka ID 必须与第 1 步一致)：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "joingonka": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "JoinGonka (Gonka)",
      "options": { "baseURL": "https://gate.joingonka.ai/v1" },
      "models": {
        "MiniMaxAI/MiniMax-M2.7": { "name": "MiniMax M2.7" },
        "deepseek-ai/DeepSeek-V4-Flash-0731": { "name": "DeepSeek V4 Flash" },
        "zai-org/GLM-5.3-Flash": { "name": "GLM-5.3 Flash" }
      }
    }
  }
}

您无需在此文件中添加 apiKey 字段——OpenCode 将通过匹配的 ID 从 auth.json 中获取密钥。

模型选择：默认建议使用 joingonka/MiniMaxAI/MiniMax-M2.7；对于推理任务和拥有全网最长上下文 (390K) 的需求，建议使用 joingonka/zai-org/GLM-5.3-Flash；对于无推理的大型提示词和最长输出需求，建议使用 joingonka/deepseek-ai/DeepSeek-V4-Flash-0731 (380K，上下文长度排名第二)。

验证：运行 opencode 并要求它编写一个函数。如果收到回复，说明配置完成。

为什么 OpenCode + Gonka 是最佳组合

OpenCode + Gonka 组合对于开发者而言是最优选择的三个原因：

  • 完全开源：OpenCode 和 Gonka Network 均为开源。无厂商锁定（vendor lock-in），无专有依赖。您掌控每一个组件。
  • 成本：$0.0069/1M token——比任何专有替代品便宜数千倍。GitHub Copilot 每月花费 $19-39 且有限制。OpenCode + Gonka —— 无限制，成本极低。
  • 隐私：您的代码不会发送到 Microsoft/OpenAI/Anthropic 的服务器。请求通过 去中心化网络 进行——您的数据不存在统一存储库。

OpenCode 支持多种 LLM 提供程序，但通过 JoinGonka Gateway，您可以获得价格、质量和隐私的最佳平衡。其他终端工具：Claude Code, Aider。

模型参数：上下文窗口 —— MiniMax M2.7 为 200K token (DeepSeek V4 Flash 为 380K, GLM-5.3 Flash 为 390K)，最大响应长度 —— 高达 8192 token (DeepSeek V4 Flash 高达 32768)。当前模型列表：GET https://gate.joingonka.ai/v1/models。

OpenCode + Gonka = 完全开源的 AI 编程助手，每月仅需 $0.30。无订阅费，无供应商锁定，无需向公司服务器发送代码。注册即送免费代币。
← OpenClaw + Gonka AI — 可负担的 AI 代理 Continue.dev + Gonka AI — 适用于 VS Code/JetBrains 的 AI →

想了解更多？

探索其他章节或立即开始赚取 GNK。

获取免费代币 →