지식 기반 섹션 ▾

내비게이션

▸ 여기서 시작하세요 역할별

카테고리

도구 37
용어집 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. 1.5M 무료 토큰 보너스 가 자동으로 지급됩니다.
  3. Dashboard에서 API 키(형식 jg-xxx)를 생성하세요.

동일한 키로 Cursor, Cline, Continue.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에 다음을 추가하세요(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" },
        "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 조합이 개발자에게 최적인 3가지 이유:

  • 완벽한 open-source: OpenCode와 Gonka Network 모두 오픈 소스입니다. 벤더 종속(vendor lock-in)이나 독점적인 종속성이 없습니다. 모든 구성 요소를 제어할 수 있습니다.
  • 비용: 토큰 100만 개당 $0.0047 — 모든 독점 대체제보다 수천 배 저렴합니다. 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 = 완전히 오픈 소스인 AI 코딩 어시스턴트. 월 $0.30. 구독료 없고, 벤더 종속 없으며, 기업 서버로 코드를 전송하지 않습니다. 무료 스타터 토큰 제공.

더 자세히 알고 싶으세요?

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

무료 토큰 받기 →