Aider CLI 가이드

Git 통합 AI 코딩 도구 Aider를 마스터하세요. 오픈소스, 무료, 다중 LLM 지원.

업데이트 안내: 모델/요금/버전/정책 등 시점에 민감한 정보는 변동될 수 있습니다. 최신 내용은 공식 문서를 확인하세요.

⚡ 빠른 시작

# 설치
pip install aider-chat

# Git 저장소에서 실행
cd my-project
git init  # Git 필요
aider

# Ollama와 함께 (무료)
aider --model ollama/llama3.2

소개

Aider는 Git 워크플로우에 최적화된 AI 코딩 CLI 도구입니다. 모든 변경사항을 자동으로 커밋하고, diff를 생성하며, 다양한 LLM을 지원합니다.

왜 Aider인가?

특징	설명
Git 네이티브	모든 변경사항 자동 커밋, diff 생성, 브랜치 관리
다중 LLM	Claude, GPT-4, Gemini, Ollama 모두 지원
오픈소스	MIT 라이선스, 무료, 커뮤니티 활발
스마트 편집	파일 전체가 아닌 변경된 부분만 수정
무료 사용	Ollama와 함께 사용 시 완전 무료

설치

Python으로 설치

# pip로 설치
pip install aider-chat

# 또는 pipx로 설치 (권장)
pipx install aider-chat

# 설치 확인
aider --version

API 키 설정 (선택사항)

# Claude 사용
export ANTHROPIC_API_KEY="sk-ant-api03-xxx"
aider --model claude-

# OpenAI 사용
export OPENAI_API_KEY="sk-xxx"
aider --model gpt-4

# Ollama 사용 (무료, API 키 불필요)
aider --model ollama/llama3.2

기본 사용법

Aider 시작

# 프로젝트 디렉토리에서
cd my-project

# Git 저장소 초기화 (필수)
git init

# Aider 실행
aider

# 특정 파일만 포함
aider src/app.js src/utils.js

# 특정 모델 지정
aider --model claude-

첫 번째 요청

💬 You> "Python Flask 웹 서버 만들어줘.
/hello 엔드포인트 추가하고, JSON 반환하게."

🤖 Aider> "Flask 서버를 생성하겠습니다."

# 파일 생성
Add app.py
Add requirements.txt

# Git 자동 커밋
Commit 3a7f2e1 Create Flask server with /hello endpoint

🤖 Aider> "2개 파일을 생성하고 커밋했습니다!"

주요 명령어

명령어	설명
`/add FILE`	파일을 채팅에 추가
`/drop FILE`	파일 제거
`/undo`	마지막 변경 취소
`/diff`	변경사항 diff 보기
`/run COMMAND`	쉘 명령어 실행
`/commit`	수동 커밋
`/clear`	대화 초기화
`/exit`	종료

Git 통합

자동 커밋

Aider는 모든 변경사항을 자동으로 커밋합니다. 각 커밋 메시지는 AI가 생성합니다.

💬 You> "사용자 인증 기능 추가해줘."

# AI가 코드 생성
Add src/auth.js
Modify src/app.js

# 자동 커밋
Commit 8b3c9a2 Add user authentication with JWT

Diff 검토

# 변경사항 확인
💬 You> "/diff"

# Git diff 표시
diff --git a/src/app.js b/src/app.js
@@ -10,6 +10,8 @@
 const app = express();
+const auth = require('./auth');
+app.use(auth.middleware);

변경 취소

💬 You> "/undo"

🤖 Aider> "마지막 커밋을 되돌렸습니다."
Reverted commit 8b3c9a2

다중 LLM 지원

지원 모델

# Claude
aider --model claude-
aider --model claude-

# OpenAI
aider --model gpt-4
aider --model gpt-4-turbo

# Gemini
aider --model gemini/gemini-pro

# Ollama (로컬)
aider --model ollama/llama3.2
aider --model ollama/codellama

모델 전환 전략

간단한 작업: Ollama llama3.2 (무료)
복잡한 코드: Claude Sonnet (고품질)
리팩토링: GPT-4 (범용)

실전 워크플로우

기능 브랜치 개발

# 새 브랜치 생성
git checkout -b feature/user-auth

# Aider 시작
aider

💬 You> "사용자 인증 시스템 구현해줘.
JWT 토큰 사용, 회원가입/로그인 API."

# AI가 코드 생성 및 커밋
Commit a3f89d Implement JWT authentication system

# 브랜치 푸시
git push origin feature/user-auth

버그 수정

# 버그가 있는 파일 열기
aider src/buggy-file.js

💬 You> "이 파일에서 TypeError 발생해.
users.map()에서 users가 undefined일 때 에러나.
수정해줘."

Modify src/buggy-file.js
Commit f2e8b3a Fix TypeError: Add null check before map()

리팩토링

💬 You> "src/utils.js를 읽어봐.
이 파일을 더 작은 모듈로 분리하고,
TypeScript로 변환해줘.
테스트 코드도 작성해줘."

Add src/utils/string.ts
Add src/utils/array.ts
Add src/utils/__tests__/string.test.ts
Add src/utils/__tests__/array.test.ts
Delete src/utils.js

Commit 9d4c2f1 Refactor utils to TypeScript modules with tests

고급 기능

쉘 명령어 실행

# Aider 내부에서 명령어 실행
💬 You> "/run npm test"

# 테스트 실패 시 자동 수정
💬 You> "테스트가 실패했어. 수정해줘."

Architect 모드

복잡한 변경사항을 계획하고 단계별로 실행:

aider --architect

💬 You> "전체 인증 시스템을 재설계해줘.
OAuth 2.0 지원, refresh token, 역할 기반 권한."

🤖 Aider> "계획을 수립하겠습니다..."
# AI가 단계별 계획 생성 및 실행

.aider.conf.yml

프로젝트별 설정:

# .aider.conf.yml
model: claude-
auto-commits: true
dark-mode: true
edit-format: diff

map-tokens: 2048
cache-prompts: true

모범 사례

활용 팁

작은 커밋: 한 번에 하나의 기능만 요청
명확한 요청: 구체적이고 명확하게
/add 활용: 관련 파일 모두 추가
/diff 확인: 커밋 전 변경사항 검토
Ollama 활용: 간단한 작업은 로컬 LLM

비용 최적화

Ollama 사용 (완전 무료)
--map-tokens로 컨텍스트 제한
--cache-prompts로 캐싱 활성화
불필요한 파일 /drop

다른 도구와 비교

vs Codex

Aider는 Git 중심의 로컬 CLI 에이전트이고, Codex는 앱/웹/CLI에서 작업 단위로 실행되는 코딩 에이전트입니다. 팀의 워크플로우에 맞춰 선택하세요. 자세한 흐름은 Codex 가이드를 참고하세요.

특징	Aider	Codex
환경	로컬 CLI	앱/웹/CLI
워크플로우	Git 커밋 자동화	작업 단위 실행/승인
자율성	중간 (대화 기반)	높음 (에이전트)
계정/키	API 키 기반	계정 로그인 또는 API 키
추천 사용	로컬 Git 중심 작업	분리된 에이전트 작업

문제 해결

일반적인 문제

❌ "Not a git repository"

해결: git init으로 Git 초기화

❌ API 키 오류

해결: 환경 변수 확인 또는 Ollama 사용

❌ 파일이 수정되지 않음

해결: /add FILE로 파일 명시적 추가

💡 자세한 로그

aider --verbose

핵심 정리

Aider CLI 가이드의 핵심 개념과 흐름을 정리합니다.
소개를 단계별로 이해합니다.
실전 적용 시 기준과 주의점을 확인합니다.