知识库章节 ▾

导航

▸ 从这里开始 按角色

类别

工具 37
词汇表 12

工具

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

OpenCode 是一款直接在终端中运行的开源 AI 编程助手。无订阅费用,无供应商锁定。支持代码补全、代码生成、重构和解释功能——均通过 OpenAI 兼容的 API 实现。

与专有工具(GitHub Copilot, Cursor Pro)不同,OpenCode 是完全免费且开源的。唯一的开支是 LLM API 提供商。使用 JoinGonka Gateway,该费用每月可降至 $0.30。

配置仅需几分钟——通过单条指令安装程序或使用 OpenCode 原生方法手动配置,无需修改环境变量。

步骤 1:获取 API 密钥

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

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

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

步骤 2:配置 OpenCode

最简单的方法是使用一键安装程序。对于 CLI/文件工具,它会自动注册 JoinGonka 提供程序(baseUrl,模型)并将密钥保存到 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": {
        "moonshotai/Kimi-K2.6": { "name": "Kimi K2.6" },
        "MiniMaxAI/MiniMax-M2.7": { "name": "MiniMax M2.7" },
        "deepseek-ai/DeepSeek-V4-Flash-0731": { "name": "DeepSeek V4 Flash" }
      }
    }
  }
}

无需在此文件中添加 apiKey 字段——OpenCode 将使用匹配的 ID 从 auth.json 中注入密钥。

模型选择:默认推荐 joingonka/moonshotai/Kimi-K2.6;长上下文请使用 joingonka/MiniMaxAI/MiniMax-M2.7;网络中最长的上下文 (380K) 请使用 joingonka/deepseek-ai/DeepSeek-V4-Flash-0731

验证:启动 opencode 并要求它编写一个函数。如果收到响应,则说明配置完成。

为什么 OpenCode + Gonka 是最佳组合

OpenCode + Gonka 组合对于开发者来说是最佳选择的三个原因:

  • 完全开源:OpenCode 和 Gonka Network 均为开源。无厂商锁定,无专有依赖。您可以控制每一个组件。
  • 成本$0.0047/1M token — 比任何专有替代方案便宜数千倍。GitHub Copilot 每月收费 $19-39 且有限制。OpenCode + Gonka — 无限制,只需几分钱。
  • 隐私:您的代码不会发送到 Microsoft/OpenAI/Anthropic 服务器。请求通过去中心化网络处理 — 您的数据没有单一存储库。

OpenCode 支持多种 LLM 提供商,但使用 JoinGonka Gateway,您可以获得价格、质量和隐私的最佳平衡。其他终端工具替代方案:Claude Code, Aider

模型参数:上下文窗口 — 200K token,最大响应长度 — 高达 8192 token(适用于所有网络模型)。当前模型列表:GET https://gate.joingonka.ai/v1/models

OpenCode + Gonka = 完全开源的 AI 编程助手,每月仅需 $0.30。无订阅费,无供应商锁定,无需向公司服务器发送代码。注册即送免费代币。

想了解更多?

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

获取免费代币 →