AI 에이전트용: 단계별 설정 안내 — /docs/agents.md, 문서 인덱스 — /llms.txt.

Gonka 모델을 사용 중인 도구에 연결하세요

OpenAI 및 Anthropic 호환 API. 도구를 선택하면 설치 명령, 에이전트용 프롬프트, 연결 확인 방법을 받을 수 있습니다.

빠른 정보#

  • OpenAI API 클라이언트용 기본 URL: https://gate.joingonka.ai/v1
  • Anthropic API 클라이언트용 기본 URL, /v1 없이: https://gate.joingonka.ai
  • 키는 Authorization: Bearer jg-… 또는 x-api-key: jg-… 헤더로 전달됩니다
  • 사용 가능한 모델 목록: GET https://gate.joingonka.ai/v1/models
  • 권장 모델: MiniMaxAI/MiniMax-M2.7

도구 연결#

도구를 선택하면 아래에 해당 도구 전용 3단계가 표시됩니다. 설치 프로그램은 아래 표에 있는 도구(25개)를 한 명령으로 설정하고, 나머지는 가이드에 따라 연결합니다.

Claude Code

  1. 키

    gate.joingonka.ai에 가입하고 마이페이지에서 키를 생성하세요. 가입 직후 3M 무료 토큰이 계정에 지급됩니다.

    API 키 받기
  2. 연결

    설치 프로그램이 Claude Code을(를) 자동으로 설정합니다. 키를 숨김 입력으로 요청하고, 설정 파일에 기록한 뒤 게이트웨이에 요청을 보내 연결을 확인합니다.

    Bash
    npx -y @joingonka/setup --tool claude-code --model MiniMaxAI/MiniMax-M2.7

    또는 AI 에이전트에게 설정을 맡기세요. 아래 프롬프트를 보내면 됩니다:

    에이전트용 프롬프트
    Claude Code을(를) JoinGonka Gateway — Gonka 네트워크의 OpenAI 및 Anthropic 호환 API — 에 https://gate.joingonka.ai/docs/agents.md 안내에 따라 연결해 주세요. 키는 제가 직접 제공하겠습니다. 저장소 파일에 저장하거나 전역 환경 변수를 변경하지 마세요. 마지막에 짧은 요청으로 연결을 확인하고 결과를 알려주세요.

    단계별 가이드: Claude Code.

  3. 확인

    계정 잔액 — 이 요청은 토큰을 소모하지 않습니다:

    cURL
    curl -s https://gate.joingonka.ai/api/balance \
      -H "Authorization: Bearer $JOINGONKA_API_KEY"

    모델에 보내는 짧은 요청 — 상태 코드 200이 반환되면 설정이 완료된 것입니다:

    cURL
    curl -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}'

모든 도구#

도구유형설치 프로그램
CursorIDE--tool cursor
Claude CodeCLI 에이전트--tool claude-code
OpenClawCLI 에이전트--tool openclaw
OpenCodeCLI 에이전트--tool opencode
ContinueIDE--tool continue
ClineIDE--tool cline
AiderCLI 에이전트--tool aider
LangChain프레임워크—
n8n프레임워크—
Open WebUI채팅—
LibreChat채팅—
HermesCLI 에이전트--tool hermes
Kilo CodeIDE--tool kilo
Roo CodeIDE--tool roo
LlamaIndex프레임워크—
PydanticAI프레임워크—
Vercel AI SDK프레임워크—
TanStack AI프레임워크—
ZCodeCLI 에이전트--tool zcode
JetBrainsIDE--tool jetbrains
Copilot BYOKIDE--tool copilot-byok
ZedIDE--tool zed
PiCLI 에이전트--tool pi
Codex CLICLI 에이전트--tool codex
DeepSeek HarnessCLI 에이전트—
MiniMax CodeCLI 에이전트--tool minimax-code
WarpCLI 에이전트—
TraeIDE—
Cherry Studio채팅—
omp (Oh My Pi)CLI 에이전트--tool omp
OpenHandsCLI 에이전트—
Qwen CodeCLI 에이전트--tool qwen-code
GooseCLI 에이전트--tool goose
CrushCLI 에이전트--tool crush
Zoo CodeIDE--tool zoo
Kimi CodeCLI 에이전트--tool kimi-code
Factory DroidCLI 에이전트--tool droid
MiMo CodeCLI 에이전트--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)

문서 섹션#

  • API — Gonka 네트워크 모델을 위한 OpenAI 및 Anthropic 호환 API 레퍼런스: 키, 파라미터, 스트리밍, 도구, 플러그인. 가입 시 무료 토큰 제공.
  • 모델 — 하나의 API로 Gonka 네트워크 모델을 이용하세요: model 필드용 id, 컨텍스트, 응답 한도, 가격 및 상태. 동일한 오픈 모델을 훨씬 저렴하게.
  • 오류 및 한도 — 게이트웨이 오류 코드, 요청 한도 및 타임아웃: 각 응답의 의미와 재시도 시점을 안내합니다.
  • 요금제 및 계정 — 토큰당 가격으로 Gonka 네트워크 모델 이용: 시작 시 무료 토큰, GNK, USDT 또는 카드로 충전, 모든 수수료 공개 및 비용 추적용 계정 API.
  • 에이전트용 — AI 에이전트에게 링크를 전달하면 Claude Code, Cursor 또는 Codex를 Gonka 네트워크 모델에 자동으로 연결합니다: 바로 쓸 수 있는 프롬프트, 안내 및 스킬.