가장 쉬운 방법은 한 줄 명령어 설치 프로그램을 사용하여 설정하는 것입니다. 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 파일에 아래 내용을 추가하세요 (ID joingonka는 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" }
      }
    }
  }
}

이 파일에 apiKey 필드를 추가할 필요는 없습니다. OpenCode가 ID 일치를 통해 auth.json에서 키를 자동으로 가져옵니다.

모델 선택: 기본적으로 joingonka/moonshotai/Kimi-K2.6이 적합하며, 긴 컨텍스트가 필요할 경우 joingonka/MiniMaxAI/MiniMax-M2.7을 사용하세요.

검증: opencode를 실행하고 함수 작성을 요청해보세요. 답변이 오면 설정이 완료된 것입니다.

OpenCode + Gonka가 최고의 조합인 이유

OpenCode와 Gonka의 조합이 개발자에게 최적인 3가지 이유:

완전 오픈소스: OpenCode와 Gonka Network 모두 오픈소스입니다. 벤더 종속(vendor lock-in)이나 독점적 종속성이 없으며, 모든 구성 요소를 완전하게 관리할 수 있습니다.
가격: 1M 토큰당 $0.003으로, 독점적 대안들보다 수천 배 저렴합니다. GitHub Copilot은 제한적 사용에 월 $19~39인 반면, OpenCode + Gonka는 무제한 사용이 가능합니다.
프라이버시: 코드가 Microsoft/OpenAI/Anthropic 서버로 전송되지 않습니다. 요청이 탈중앙화 네트워크를 통해 처리되므로 데이터가 단일 중앙 서버에 저장되지 않습니다.

OpenCode는 많은 LLM 공급자를 지원하지만, JoinGonka Gateway를 사용하면 가격, 품질, 프라이버시 간의 최적의 균형을 얻을 수 있습니다. 대체 터미널 도구: Claude Code, Aider.

모델 파라미터: 컨텍스트 윈도우 200K 토큰, 최대 응답 길이 최대 8192 토큰(네트워크 내 모든 모델 공통). 최신 모델 목록: GET https://gate.joingonka.ai/v1/models.

OpenCode + Gonka = 월 $0.30의 완전히 오픈 소스 AI 코딩 어시스턴트. 구독 없이, 벤더 종속 없이, 기업 서버에 코드 전송 없이. 시작 시 10M 무료 토큰.

← OpenClaw + Gonka AI — 저렴한 AI 에이전트 Continue.dev + Gonka AI — VS Code/JetBrains를 위한 AI →

더 자세히 알고 싶으세요?

다른 섹션을 탐색하거나 지금 GNK를 얻기 시작하세요.

10M 무료 토큰 받기 →