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

Pi는 2026년에 가장 빠르게 성장하는 오픈 소스 하네스 중 하나인 미니멀리스트 터미널 코딩 에이전트입니다. 공급자는 ~/.pi/agent/models.json 에 선언적으로 기술되며 OpenAI Completions나 Anthropic Messages를 지원하는 모든 endpoint와 호환됩니다. 즉, JoinGonka Gateway는 양쪽 방식으로 모두 연결할 수 있습니다. Gonka 분산 네트워크 모델은 일반 벤더 가격보다 수백 배 저렴하며, 초기 10M 토큰은 무료입니다.

빠른 시작: 설치 프로그램

가장 짧은 방법은 설치 도구를 사용하는 것입니다:

npx @joingonka/setup --tool pi

이 도구는 ~/.pi/agent/models.json에 최신 네트워크 모델을 포함한 제공자를 작성하고, ~/.pi/agent/settings.json에 기본 모델을 설정하며(기존 선택 사항을 가로채지 않음), 게이트웨이가 키와 모델을 수락하는지 실시간 요청으로 확인합니다. 키는 0600 권한이 있는 설정 파일 내에 리터럴로 저장되므로 환경 변수를 내보낼 필요가 없습니다.

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

등록 시 jg-… 키를 받고 ~/.pi/agent/models.json에 제공자를 추가하세요:

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

네트워크 모델의 올바른 값: deepseek-ai/DeepSeek-V4-Flash-0731 — contextWindow 380000, maxTokens 32768; moonshotai/Kimi-K2.6 및 MiniMaxAI/MiniMax-M2.7 — 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)를 추천합니다. Kimi K2.6은 다단계 에이전트 작업에 강력하며, MiniMax M2.7은 범용적인 옵션입니다. 요금은 통합되어 있으며, 실시간 가격은 게이트웨이 가격표에서 확인할 수 있습니다.

Pi는 ~/.pi/agent/models.json에 항목을 하나 추가하여 JoinGonka Gateway에 연결합니다: baseUrl gate.joingonka.ai/v1, api openai-completions, 키는 리터럴, 모델은 정확한 contextWindow/maxTokens를 지정. 더 빠르게 하려면 npx @joingonka/setup --tool pi를 사용하세요. 샌드박스에서 에이전트를 실행하고 10M 무료 토큰으로 시작하세요.

← Zed + JoinGonka Gateway — 에디터 내 저렴한 추론

더 자세히 알고 싶으세요?

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

pi.cta.text →