面向 AI 智能体：配置分步指南 — /docs/agents.md，文档索引 — /llms.txt。
将 Gonka 模型接入你的工具
兼容 OpenAI 和 Anthropic 的 API。选择你的工具——即可获取安装命令、给智能体的提示词和验证方法。
快速了解#
- OpenAI API 客户端的基地址：
https://gate.joingonka.ai/v1 - Anthropic API 客户端的基地址，不含
/v1：https://gate.joingonka.ai - 密钥通过
Authorization: Bearer jg-…或x-api-key: jg-…请求头传递 - 可用模型列表：
GET https://gate.joingonka.ai/v1/models - 推荐模型：
MiniMaxAI/MiniMax-M2.7
接入工具#
选择你的工具——下方是专为它准备的三步操作。安装器能用一条命令配置下表所列工具（共 25 个），其余工具可参照指南接入。
Claude Code
密钥
在 gate.joingonka.ai 注册，并在个人中心创建密钥。 注册后立即可获得 3M 免费 token。
获取 API 密钥接入
安装器会自动配置 Claude Code：以隐藏输入方式询问密钥，写入配置，并通过向网关发送请求来验证连接。
Bashnpx -y @joingonka/setup --tool claude-code --model MiniMaxAI/MiniMax-M2.7或者交由 AI 智能体配置——把这段提示词发给它：
智能体提示词请按照 https://gate.joingonka.ai/docs/agents.md 的说明，将 Claude Code 接入 JoinGonka Gateway——Gonka 网络兼容 OpenAI 和 Anthropic 的 API。密钥我会自己提供：不要将其保存到仓库文件中，也不要修改全局环境变量。最后用一条简短请求验证连接，并告知结果。分步指南：Claude Code。
验证
账户余额——此请求不消耗 token：
cURLcurl -s https://gate.joingonka.ai/api/balance \ -H "Authorization: Bearer $JOINGONKA_API_KEY"向模型发送简短请求——返回 200 即表示配置成功：
cURLcurl -s https://gate.joingonka.ai/v1/chat/completions \ -H "Authorization: Bearer $JOINGONKA_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model": "MiniMaxAI/MiniMax-M2.7", "messages": [{"role": "user", "content": "Say OK"}], "max_tokens": 32}'
所有工具#
| 工具 | 类型 | 安装器 |
|---|---|---|
| Cursor | IDE | --tool cursor |
| Claude Code | CLI 智能体 | --tool claude-code |
| OpenClaw | CLI 智能体 | --tool openclaw |
| OpenCode | CLI 智能体 | --tool opencode |
| Continue | IDE | --tool continue |
| Cline | IDE | --tool cline |
| Aider | CLI 智能体 | --tool aider |
| LangChain | 框架 | — |
| n8n | 框架 | — |
| Open WebUI | 聊天工具 | — |
| LibreChat | 聊天工具 | — |
| Hermes | CLI 智能体 | --tool hermes |
| Kilo Code | IDE | --tool kilo |
| Roo Code | IDE | --tool roo |
| LlamaIndex | 框架 | — |
| PydanticAI | 框架 | — |
| Vercel AI SDK | 框架 | — |
| TanStack AI | 框架 | — |
| ZCode | CLI 智能体 | --tool zcode |
| JetBrains | IDE | --tool jetbrains |
| Copilot BYOK | IDE | --tool copilot-byok |
| Zed | IDE | --tool zed |
| Pi | CLI 智能体 | --tool pi |
| Codex CLI | CLI 智能体 | --tool codex |
| DeepSeek Harness | CLI 智能体 | — |
| MiniMax Code | CLI 智能体 | --tool minimax-code |
| Warp | CLI 智能体 | — |
| Trae | IDE | — |
| Cherry Studio | 聊天工具 | — |
| omp (Oh My Pi) | CLI 智能体 | --tool omp |
| OpenHands | CLI 智能体 | — |
| Qwen Code | CLI 智能体 | --tool qwen-code |
| Goose | CLI 智能体 | --tool goose |
| Crush | CLI 智能体 | --tool crush |
| Zoo Code | IDE | --tool zoo |
| Kimi Code | CLI 智能体 | --tool kimi-code |
| Factory Droid | CLI 智能体 | --tool droid |
| MiMo Code | CLI 智能体 | --tool mimo-code |
代码示例#
通过 OpenAI SDK、cURL 和 Anthropic SDK 发送同一请求。密钥从环境变量 JOINGONKA_API_KEY 中读取。
import os
from openai import OpenAI
client = OpenAI(
base_url="https://gate.joingonka.ai/v1",
api_key=os.environ["JOINGONKA_API_KEY"],
)
response = client.chat.completions.create(
model="MiniMaxAI/MiniMax-M2.7",
messages=[{"role": "user", "content": "What is Gonka?"}],
)
print(response.choices[0].message.content)import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://gate.joingonka.ai/v1",
apiKey: process.env.JOINGONKA_API_KEY,
});
const response = await client.chat.completions.create({
model: "MiniMaxAI/MiniMax-M2.7",
messages: [{ role: "user", content: "What is Gonka?" }],
});
console.log(response.choices[0].message.content);curl https://gate.joingonka.ai/v1/chat/completions \
-H "Authorization: Bearer $JOINGONKA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MiniMaxAI/MiniMax-M2.7",
"messages": [{"role": "user", "content": "What is Gonka?"}]
}'import os
import anthropic
client = anthropic.Anthropic(
base_url="https://gate.joingonka.ai",
api_key=os.environ["JOINGONKA_API_KEY"],
)
message = client.messages.create(
model="MiniMaxAI/MiniMax-M2.7",
max_tokens=1024,
messages=[{"role": "user", "content": "What is Gonka?"}],
)
print(message.content[0].text)文档章节#
- API — 兼容 OpenAI 和 Anthropic 的 Gonka 网络模型 API 参考：密钥、参数、流式传输、工具、插件。注册即送免费 token。
- 模型 — 一个 API 调用 Gonka 网络全部模型：model 字段的 id、上下文、输出上限、价格与状态。同样的开源模型，价格低至几十分之一。
- 错误与速率限制 — 网关错误码、请求限制与超时：每个响应代表什么，以及何时重试请求。
- 定价与账户 — Gonka 网络模型按 token 计价：新用户免费 token，支持 GNK、USDT 或银行卡充值，所有费用公开透明，并提供账户 API 用于追踪支出。
- 面向智能体 — 把链接交给 AI 智能体，它就能自动将 Claude Code、Cursor 或 Codex 接入 Gonka 网络的模型：现成的提示词、指南与技能。