지식 기반 섹션 ▾

내비게이션

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

카테고리

도구 52
용어집 12

도구

Claude Code + Gonka AI — 터미널을 위한 LLM

Claude Code는 터미널에서 바로 사용하는 강력한 AI 개발 어시스턴트입니다. Git, 파일 시스템과 연동하며 테스트 실행, 코드 리팩토링이 가능합니다. 하지만 네이티브 Claude Sonnet 4.6은 1M 토큰당 $3-15이며, 활발하게 작업할 경우 주간 비용이 $200를 초과할 수 있습니다.

JoinGonka Gateway는 네이티브 Anthropic API (/v1/messages)를 지원하여 Claude Code가 프록시 없이 직접 연결되도록 합니다. 분산형 네트워크 Gonka를 통해 MiniMax M2.7, DeepSeek V4 Flash, GLM-5.3 Flash 모델을 1M 토큰당 $0.0069에 사용할 수 있으며, 이는 코딩 작업 시 품질은 유지하면서 비용을 수백 배 절감하는 효과를 줍니다.

설정은 단 2분이면 완료됩니다. 설치 명령어 하나를 입력하거나 환경 변수 몇 개만 설정하면 됩니다.

1단계: API 키 받기

JoinGonka Gateway 키가 아직 없다면:

  1. gate.joingonka.ai/register 에 가입하세요.
  2. 3M 무료 토큰 보너스 를 받으세요.
  3. Dashboard → API Keys 에서 API 키를 생성하세요.
  4. 키(형식: jg-xxx)를 복사하세요.

하나의 키로 Cursor, Aider, LangChain 등 모든 OpenAI 호환 도구를 사용할 수 있습니다.

2단계: Claude Code 연결하기

JoinGonka Gateway는 Anthropic Messages API(/v1/messages)를 네이티브로 지원하므로 프록시가 필요 없습니다.

권장 방법은 원 커맨드 설치 프로그램입니다:

npx @joingonka/setup --tool claude-code

이것은 JoinGonka의 범용 설치 프로그램입니다. 플래그 없이 npx @joingonka/setup을 실행하면 목록에서 도구를 선택하도록 안내합니다. 지원 도구는 이미 25개입니다: Claude Code, Codex CLI, OpenClaw, Cursor, Cline 등 — 전체 목록은 패키지 README의 이곳에서 확인할 수 있습니다.

설치 프로그램은 API 키를 물어보고 ~/.claude/settings.json을 백업한 뒤 env 블록에 자체 필드만 기록하며 나머지 설정은 건드리지 않습니다: 게이트웨이 주소(ANTHROPIC_BASE_URL), 키(ANTHROPIC_AUTH_TOKEN), 모델(ANTHROPIC_MODEL 및 별칭 opus, sonnet, haiku)과 그 실제 한도 — CLAUDE_CODE_MAX_CONTEXT_TOKENS 및 CLAUDE_CODE_MAX_OUTPUT_TOKENS. 한도는 중요합니다. 낯선 식별자에 대해 Claude Code는 자체 컨텍스트 윈도를 가정하고 기록을 제때 압축하지 못하는데, 네트워크의 모델은 200K~390K 토큰의 자체 윈도를 가지고 있기 때문입니다. 키가 담긴 파일에는 600 권한이 부여됩니다. 기본적으로 DeepSeek V4 Flash가 설정되며, 다른 모델은 --model minimax|deepseek|glm 플래그로 선택합니다. --scope local 플래그를 사용하면 설정이 현재 프로젝트의 .claude/settings.local.json에 기록되고 해당 파일이 .gitignore에 추가됩니다.

수동으로 설정하기(플랜 B)

또는 수동으로 — 환경 변수를 통해:

export ANTHROPIC_BASE_URL=https://gate.joingonka.ai
export ANTHROPIC_AUTH_TOKEN=jg-your-key
export ANTHROPIC_MODEL=deepseek-ai/DeepSeek-V4-Flash-0731
export CLAUDE_CODE_MAX_CONTEXT_TOKENS=380000
export CLAUDE_CODE_MAX_OUTPUT_TOKENS=32768
claude

처음 두 변수는 Claude Code를 게이트웨이로 향하게 합니다. 요청은 네이티브 Anthropic 형식으로 전송되고, Gateway가 이를 Gonka 네트워크 요청으로 변환한 뒤 Anthropic 형식으로 응답을 반환합니다. ANTHROPIC_MODEL은 네트워크 모델을 고정합니다 — 이것이 없으면 Claude Code가 자체 식별자 claude-*를 보내고 게이트웨이가 기본 모델을 대입합니다. 마지막 두 변수는 선택한 모델의 실제 컨텍스트 윈도와 응답 상한을 선언합니다(Claude Code 2.1.223 이상 필요). 그렇지 않으면 낯선 식별자에 대해 Claude Code가 자체 윈도를 가정하고 기록을 제때 압축하지 못합니다. 다른 네트워크 모델의 값은 아래 '운영 팁' 섹션에 있습니다.

지원되는 기능:

  • 스트리밍 — 응답이 즉시 표시되기 시작합니다(Anthropic 형식의 SSE: message_start, content_block_delta, message_stop)
  • 툴 호출 — Claude Code는 파일과 명령을 다루기 위해 함수를 적극적으로 사용합니다. 네트워크의 모든 모델에서 네이티브 툴 호출을 지원합니다.
  • 시스템 프롬프트 — 시스템 프롬프트는 그대로 전달됩니다

확인: Claude Code에서 아무 질문이나 해보세요. 응답이 나타나면 모든 것이 정상 작동하는 것입니다.

Windows/PowerShell의 경우:

$env:ANTHROPIC_BASE_URL="https://gate.joingonka.ai"
$env:ANTHROPIC_AUTH_TOKEN="jg-your-key"
$env:ANTHROPIC_MODEL="deepseek-ai/DeepSeek-V4-Flash-0731"
$env:CLAUDE_CODE_MAX_CONTEXT_TOKENS="380000"
$env:CLAUDE_CODE_MAX_OUTPUT_TOKENS="32768"
claude

이전의 제한적인 설치 프로그램 npx @joingonka/claude-code는 범용 @joingonka/setup으로 대체되었으며 더 이상 개발되지 않습니다 — 새로운 것을 사용하세요.

Anthropic과의 비용 비교

Claude Code는 가장 리소스를 많이 소비하는 AI 도구 중 하나로, 전체 파일 컨텍스트, 명령 기록, diff를 전송합니다. 일반적인 세션에서 20-50M 토큰을 소비합니다.

제공자모델1M당 입력/출력 비용4시간 세션 (약 30M 토큰)한 달 (20 영업일)
JoinGonkaMiniMax M2.7 / DeepSeek V4 Flash / GLM-5.3 Flash$0.0069 / $0.021$0.14$2.9
AnthropicClaude Sonnet 4.6$3.00 / $15.00$210$4,200
OpenAIGPT-5.5$5.00 / $30.00$300$6,000

차이는 3자릿수에 달합니다. JoinGonka를 통하면 월 $2.9로 Anthropic에서 $4,200 이상 드는 환경을 얻을 수 있습니다. 인디 개발자에게 이는 "AI 어시스턴트를 사용할 수 있느냐"와 "없느냐"의 차이입니다.

작업 팁

Gonka를 통한 Claude Code의 효율적인 작업을 위한 몇 가지 권장 사항:

  • 컨텍스트: MiniMax M2.7의 컨텍스트 창은 200K 토큰(약 10만 단어)으로 대부분의 프로젝트에 충분하며, DeepSeek V4 Flash는 380K, GLM-5.3 Flash는 390K입니다. Gateway를 통한 최대 출력 길이는 MiniMax M2.7 및 GLM-5.3 Flash의 경우 8192 토큰, DeepSeek V4 Flash의 경우 32768 토큰입니다. 긴 생성이 필요한 경우 작업을 나누어야 할 수도 있습니다. 현재 네트워크 모델 목록은 GET https://gate.joingonka.ai/v1/models에서 확인할 수 있습니다.
  • Streaming: Gateway는 네이티브 Anthropic 형식의 스트리밍을 지원하여 네이티브 Claude처럼 응답이 즉시 나타납니다.
  • Tool calling: 모든 네트워크 모델이 네이티브 tool calling을 지원하며, 이는 Claude Code가 파일 및 명령 작업을 수행하는 데 매우 중요합니다.
  • 지연 시간: 첫 번째 요청은 5-10초가 소요될 수 있습니다(노드 콜드 스타트). 이후 요청은 1-3초가 소요됩니다.
  • 기타 도구: JoinGonka Gateway는 OpenAI API와도 호환됩니다. Aider, OpenCode, Cursor는 /v1/chat/completions를 통해 연결할 수 있습니다.

다른 터미널 도구를 선호하는 개발자는 다음을 참조하세요: Aider, OpenCode.

Claude Code + Gonka = 강력한 터미널 AI 어시스턴트. Anthropic의 $4,200 대비 월 ~$0.60. 프록시 없는 Anthropic API 직접 연결: 설치 명령어 한 줄, 2분 소요. 시작 시 무료 토큰 제공.
← Cursor + Gonka AI — 코딩을 위한 저렴한 LLM OpenClaw + Gonka AI — 저렴한 AI 에이전트 →

더 자세히 알고 싶으세요?

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

무료 토큰 받기 →