지식 기반 섹션 ▾

내비게이션

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

카테고리

도구 52
용어집 12

도구

Aider + Gonka AI — AI 페어 프로그래밍

Aider는 최고의 터미널 AI 코딩 어시스턴트 중 하나입니다. Git과 연동되고 프로젝트 구조를 이해하며, 커밋을 생성하고 여러 파일을 동시에 편집합니다. 단순한 AI 채팅이 아니라, AI 파트너가 코드를 읽고 변경 사항을 제안하며 적용하는 본격적인 페어 프로그래밍입니다.

Aider는 OpenAI 호환 API를 즉시 지원합니다. JoinGonka Gateway 연결은 환경 변수 2개, 30초 설정이면 충분합니다. 그 후 토큰 100만 개당 $0.0069로 무제한 페어 프로그래밍이 가능합니다.

1단계: Aider 설치 및 키 받기

Aider 설치:

# pip
pip install aider-chat

# pipx (recommended)
pipx install aider-chat

# Homebrew (macOS)
brew install aider

API 키: gate.joingonka.ai/register에서 가입하고 3M 무료 토큰을 받은 뒤 jg-xxx 키를 만드세요.

2단계: Aider 설정

JoinGonka 설치 도구로 설정 블록을 바로 얻는 것이 가장 쉽습니다:

npx @joingonka/setup --tool aider

설치 도구가 jg-… 키를 묻고 .aider.conf.yml용 블록(주소, 키, 모델)을 출력하며, Aider가 알 수 없는 컨텍스트 윈도우에 대해 경고하지 않도록 모델의 실제 한도를 담은 선택적 .aider.model.metadata.json도 함께 출력합니다. 파일은 쓰지 않으니 블록을 직접 붙여넣으세요. 키와 모델의 동작은 설치 도구가 gateway에 실제 요청을 보내 확인합니다. 아래는 같은 과정을 단계별로 설명합니다.

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

방법 1: 환경 변수(가장 간단):

export OPENAI_API_BASE=https://gate.joingonka.ai/v1
export OPENAI_API_KEY=jg-your-key

실행:

aider --model openai/MiniMaxAI/MiniMax-M2.7

방법 2: 프로젝트별 파일 프로젝트 루트의 .aider.conf.yml — 가장 네이티브한 방법입니다. endpoint, 키, 모델을 한 파일에 담고 전역 환경 변수를 건드릴 필요가 없습니다(전역 OPENAI_*는 다른 OpenAI 호환 도구를 가로챌 수 있습니다):

# .aider.conf.yml
openai-api-base: https://gate.joingonka.ai/v1
openai-api-key: jg-your-key
model: openai/MiniMaxAI/MiniMax-M2.7

선택 사항으로 별도의 .aider.model.settings.yml에서 모델 동작을 세밀하게 조정할 수 있습니다(이 파일은 모델 파라미터만 설정하며 endpoint나 키는 설정하지 않습니다):

# .aider.model.settings.yml
- name: openai/MiniMaxAI/MiniMax-M2.7
  edit_format: diff
  use_repo_map: true
  extra_params:
    max_tokens: 8192  # Gateway output cap

방법 3: 셸 alias로 편리하게:

alias gonka-aider='OPENAI_API_BASE=https://gate.joingonka.ai/v1 OPENAI_API_KEY=jg-your-key aider --model openai/MiniMaxAI/MiniMax-M2.7'

확인: Git 저장소로 이동해 gonka-aider를 실행합니다. Aider가 모델 정보를 보여주고 컨텍스트에 파일을 추가하라고 안내합니다. 파일에 변경을 요청했을 때 Aider가 커밋을 만들면 모두 정상입니다.

Aider + Gonka 기능

Aider는 단순한 채팅이 아닙니다. AI와 함께하는 페어 프로그래밍을 위한 본격적인 도구입니다.

  • Git 작업: Aider는 변경 사항마다 자동으로 커밋을 생성합니다. git undo를 통해 AI의 결정을 쉽게 되돌릴 수 있습니다.
  • 프로젝트 컨텍스트: Aider는 저장소 맵(repo map)을 구축하여 파일 간의 의존성, 임포트, 프로젝트 구조를 이해합니다. 모델은 전체 컨텍스트를 전달받습니다.
  • 다중 파일 수정: 기능 구현을 위해 5~10개의 파일을 동시에 수정할 수 있습니다. 각 파일은 개별 diff로 관리되며, 모든 수정 사항은 추적 가능합니다.
  • 음성 입력: --voice를 지원하여 텍스트 입력 대신 음성으로 작업을 지시할 수 있습니다.
  • 린팅 및 테스트: 린터 및 테스트 프레임워크와의 통합으로 Aider는 오류를 자동으로 감지하고 수정합니다.

Gonka를 사용하면 이 모든 것이 매우 저렴해집니다. 일반적인 페어 프로그래밍 세션(2~4시간)에 10~30M 토큰이 소비되는데, JoinGonka Gateway를 통하면 $0.01-0.03에 불과합니다. OpenAI를 사용하면 같은 세션에 $50-200이 듭니다.

대안 터미널 도구: Claude Code, OpenCode.

모델 매개변수: MiniMax M2.7의 컨텍스트 창은 200K 토큰, DeepSeek V4 Flash는 380K입니다. Gateway를 통한 최대 응답 길이는 MiniMax M2.7과 GLM-5.3 Flash가 8192 토큰, DeepSeek V4 Flash가 32768 토큰입니다. 대부분의 페어 프로그래밍 작업에는 이 정도로 충분합니다.

Aider + Gonka = OpenAI의 $50-200 대신 $0.01-0.03/세션으로 전문적인 AI 쌍 프로그래밍. Git 통합, 다중 파일 편집, 프로젝트 컨텍스트. 모든 것이 포함되어 있습니다.
← Cline + Gonka AI — VS Code의 AI 에이전트 LangChain + Gonka AI — 저렴한 AI 애플리케이션 →

더 자세히 알고 싶으세요?

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

무료 토큰 받기 →