Pi + JoinGonka Gateway — 저렴한 인퍼런스를 활용한 터미널 에이전트

Pi는 2026년 가장 빠르게 성장하는 오픈소스 코딩 에이전트 중 하나인 미니멀한 터미널 기반 코딩 에이전트입니다. 프로바이더는 ~/.pi/agent/models.json에 선언적으로 기술되며, OpenAI Completions 또는 Anthropic Messages를 지원하는 모든 엔드포인트가 적합합니다. 즉, JoinGonka Gateway는 두 가지 방식 모두로 연결이 가능합니다. 탈중앙화 네트워크 Gonka의 모델은 벤더사의 GPU 가격보다 수백 배 저렴하며, 초기 3M 토큰은 무료로 제공됩니다.

Pi는 npm을 통해 설치합니다: npm install -g --ignore-scripts @earendil-works/pi-coding-agent. 패키지 이름이 변경되었습니다: 프로젝트가 earendil-works/pi 저장소로 이전되었으며, 기존 패키지 @mariozechner/pi-coding-agent는 더 이상 업데이트되지 않는 구버전(deprecated)으로 간주됩니다. Pi가 구버전 이름으로 설치되어 있다면 재설치하십시오. 설정 디렉토리 ~/.pi/agent는 이전 후에도 그대로 유지됩니다.

빠른 시작: 설치 프로그램

가장 짧은 방법은 당사의 설치 프로그램을 사용하는 것입니다:

npx @joingonka/setup --tool pi

이 도구는 최신 네트워크 모델을 포함한 프로바이더를 ~/.pi/agent/models.json에 작성하고, ~/.pi/agent/settings.json에 기본 모델을 설정합니다(사용자가 직접 선택한 모델은 가로채지 않으며, 명시적인 --model minimax|deepseek|glm 플래그를 통해서만 변경됩니다). 또한 라이브 요청을 통해 게이트웨이가 키와 모델을 정상적으로 수락하는지 확인합니다. 설정 디렉토리가 PI_CODING_AGENT_DIR 변수로 이동된 경우, 설치 프로그램은 해당 경로에 작성합니다. 키는 0600 권한을 가진 설정 파일에 리터럴 형태로 저장되므로 환경 변수를 내보낼(export) 필요가 없습니다.

수동 설정: models.json에 공급자 추가

등록 시 jg-… 키를 발급받고 ~/.pi/agent/models.json에 프로바이더를 추가하세요:

`baseUrl`	`https://gate.joingonka.ai/v1`
`api`	`openai-completions`
`apiKey`	당신의 키 `jg-…`를 리터럴로 지정합니다. Pi는 `$VAR`/`${VAR}` 참조와 `!command`도 이해하지만, 리터럴은 환경 변수를 내보내지 않아도 작동합니다 — 파일 권한은 `0600`으로 유지하세요
`models`	배열: `id`, `name`, `contextWindow`, `maxTokens`

네트워크 모델의 올바른 값: deepseek-ai/DeepSeek-V4-Flash-0731 — contextWindow 380000, maxTokens 32768; MiniMaxAI/MiniMax-M2.7 — contextWindow 200000, maxTokens 8192; zai-org/GLM-5.3-Flash — contextWindow 390000, maxTokens 8192. Pi의 기본값(128000/16384)은 네트워크의 실제 한도와 일치하지 않으므로 두 필드를 모두 명시적으로 설정하세요. 기본 모델은 다른 파일 — ~/.pi/agent/settings.json의 defaultProvider와 defaultModel 필드에 있습니다. 확인 방법: pi --list-models로 추가한 모델이 표시되어야 합니다.

대안: Anthropic 방식

게이트웨이는 Anthropic Messages도 지원합니다: api: "anthropic-messages" 및 baseUrl: "https://gate.joingonka.ai" (/v1/messages 경로 제외)를 설정하십시오. 클라이언트가 경로를 자동으로 보완합니다. 일상적인 작업에는 OpenAI 방식이면 충분하지만, Pi 확장이 Messages 형식에 최적화된 경우 Anthropic 옵션이 유용합니다.

보안 관련 주의사항

기본적으로 Pi는 완전한 permission 레이어가 없어서, 더 무거운 하네스에서 지원하는 단계별 승인 절차 없이 터미널에서 명령을 실행합니다. 특히 자율적인 다단계 작업의 경우 컨테이너나 별도의 사용자 계정 등 샌드박스 환경에서 실행하십시오. 이는 Pi 자체의 속성이며 게이트웨이와는 무관합니다.

모델 선택 및 비용

세 가지 네트워크 모델 모두 tool calling과 streaming을 지원합니다. 긴 세션과 대규모 리포지토리에는 DeepSeek V4 Flash(네트워크에서 가장 긴 컨텍스트 중 하나, 출력 최대 32768)를 권장합니다. MiniMax M2.7은 범용 옵션이며, GLM-5.3 Flash는 네트워크에서 가장 긴 컨텍스트(390K)를 가진 추론 모델입니다. 응답 전 추론을 수행하므로 maxTokens를 낮게 설정하지 마십시오. 요금제는 단일이며, 실시간 가격은 게이트웨이 가격표에서 확인할 수 있습니다.

Pi의 미니멀리즘이 부족하다면 포크 버전인 omp (Oh My Pi)를 살펴보십시오. 선언적 프로바이더라는 개념은 동일하지만 모델 역할, 언어 서버, 하위 에이전트가 추가되었습니다. 설정 파일이 다르므로 omp는 별도로 설정해야 합니다.

Pi는 ~/.pi/agent/models.json에 한 줄을 추가하여 JoinGonka Gateway에 연결할 수 있습니다: baseUrl gate.joingonka.ai/v1, api openai-completions, 키 리터럴 지정, contextWindow/maxTokens가 포함된 모델 설정. npx @joingonka/setup --tool pi를 사용하면 더 빠릅니다. 샌드박스에서 에이전트를 실행하고 무료 시작 토큰으로 시작하세요.

← Zed + JoinGonka Gateway — 에디터 내 저렴한 추론 Codex CLI: 구독 대신 자체 키 사용 →

더 자세히 알고 싶으세요?

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

무료 토큰 받기 →