지식 기반 섹션 ▾

내비게이션

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

카테고리

도구 32
용어집 12

도구

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

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

Aider는 OpenAI 호환 API를 기본적으로 지원합니다. JoinGonka Gateway 연결은 2개의 환경 변수만 설정하면 30초 안에 완료됩니다. 그 후에는 $0.003/1M 토큰으로 무제한 페어 프로그래밍이 가능합니다.

1단계: Aider 설치 및 키 받기

Aider 설치:

# pip
pip install aider-chat

# pipx (권장)
pipx install aider-chat

# Homebrew (macOS)
brew install aider

API 키: gate.joingonka.ai/register에 등록하여 10M 무료 토큰을 받고 jg-xxx 키를 생성하세요.

2단계: Aider 설정

가장 쉬운 방법은 설치 프로그램을 통해 한 번의 명령어로 설정하는 것입니다. CLI/파일 도구의 경우 JoinGonka 제공자(baseUrl, 모델)를 자동으로 입력하며, UI 도구의 경우 붙여넣을 값을 제공합니다:

npx @joingonka/setup --tool aider

설치 프로그램은 범용적이며(플래그가 없으면 목록에서 도구 선택 가능), jg-… 키를 요구하고 설정 후 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 (프로젝트 루트): 가장 네이티브한 방법입니다. 엔드포인트, 키, 모델을 한 파일에 담아 전역 환경 변수를 수정하지 않습니다 (전역 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에서 모델 동작을 세밀하게 조정할 수 있습니다 (이 파일은 모델 매개변수만 지정하며 엔드포인트나 키는 지정하지 않습니다):

# .aider.model.settings.yml
- name: openai/MiniMaxAI/MiniMax-M2.7
  edit_format: diff
  use_repo_map: true
  extra_params:
    max_tokens: 8192  # Gateway 경유 출력 제한

방법 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)을 구축하여 파일 간의 의존성, 임포트, 프로젝트 구조를 이해합니다. Kimi K2.6은 완전한 컨텍스트를 제공받습니다.
  • 멀티 파일 수정: 기능 구현을 위해 5~10개의 파일을 동시에 수정할 수 있습니다. 각 파일별 diff가 생성되며, 모든 수정 사항을 추적할 수 있습니다.
  • 음성 입력: --voice 옵션을 지원하여 텍스트 입력 대신 작업을 말로 지시할 수 있습니다.
  • 린팅 및 테스트: 린터 및 테스트 프레임워크와 통합되어 Aider가 오류를 식별하고 자동으로 수정합니다.

Gonka를 사용하면 이 모든 것을 매우 저렴하게 이용할 수 있습니다. 일반적인 페어 프로그래밍 세션(2~4시간)에서 10~30M 토큰을 사용하게 되는데, JoinGonka Gateway를 통하면 $0.01~$0.03 수준입니다. OpenAI는 같은 세션에 $50~$200이 듭니다.

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

모델 파라미터: Kimi K2.6의 컨텍스트 윈도우는 200K 토큰이며, Gateway를 통한 최대 응답 길이는 8192 토큰입니다(네트워크의 모든 모델 공통). 대부분의 페어 프로그래밍 작업에 충분합니다.

Aider + Gonka = OpenAI의 $50-200 대신 $0.01-0.03/세션으로 전문적인 AI 쌍 프로그래밍. Git 통합, 다중 파일 편집, 프로젝트 컨텍스트. 모든 것이 포함되어 있습니다.

더 자세히 알고 싶으세요?

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

10M 무료 토큰 받기 →