Aider 설치와 사용법: pip/uv, API 키, 첫 저장소 수정

pip 또는 uv로 Aider를 설치하고 API 키를 연결한 다음, 실제 Git 저장소에서 첫 수정을 끝낸다.

필요한 것은 로컬 Git 저장소를 읽고, diff를 제안하고, 파일을 고치는 페어 에이전트다. 루프는 터미널에 남겨 두고 싶다.

이 글은 Aider 설치와 사용을 공식 절차로 따라간다. pip, pipx, uv로 aider-chat을 넣고 API 키를 연결한 뒤, 실제 저장소에서 첫 수정을 한다. 근거는 aider.chat/docs/install.html과 aider.chat/docs/usage.html.

누구에게 맞나

Aider는 로컬 Git 저장소를 상대로 일한다. 파일을 보고 패치를 내며, 확인 후 쓰고 커밋할 수 있다. 웹 채팅이 아니며 IDE 확장은 필요 없다. 대상은 이미 Git이어야 한다.

설치, 키, 첫 수정

1. 1

   aider-chat 설치

   PyPI 이름은 aider-chat이며 단독 aider 패키지가 아니다. 전형: python3 -m pip install aider-chat. 격리하려면 pipx install aider-chat 또는 uv tool install --python python3.12 aider-chat. aider --help로 확인한다.

2. 2

   API 키 연결

   셸에서 export OPENAI_API_KEY=… 또는 export ANTHROPIC_API_KEY=…. 반복 세션은 같은 이름을 루트 .env에 쓰고 gitignore한다. aider --list-models로 인식된 제공자를 본다. 모델 ID는 aider.chat/docs/llms.html.

3. 3

   첫 저장소 수정

   저장소에 들어가 aider README.md를 실행한다. README에 한 줄 추가처럼 초점이 있는 변경을 요청한다. diff를 읽고 수락한다. 자동 커밋을 끄려면 공식 usage의 스위치를 쓴다. 나중에 히스토리에서 키를 파지 않는다.

python3 -m pip install aider-chat
# pipx install aider-chat
# uv tool install --python python3.12 aider-chat

export OPENAI_API_KEY=sk-...
# export ANTHROPIC_API_KEY=sk-ant-...

cd ~/code/your-repo
aider README.md
# Add a one-line note to the README that this repo uses Aider for local edits

첫 실행에서 자주 막히는 점

이미 Git이어야 한다

Aider는 맥락과 커밋에 Git을 쓴다. 빈 폴더면 git init하고 최소 한 번 커밋한 뒤 시작한다. 버전 관리 없는 디렉터리에서 시험하지 말 것.

.env는 비밀번호

커밋하지 말고 티켓에 붙이지 말 것. 이미 원격에 올라갔다면 공급자 콘솔에서 키를 교체한다. 커밋 메시지만 지워서는 부족하다.

자동 커밋은 더러운 파일도 가져간다

diff를 수락하기 전에 스테이징 범위를 본다. 키, 로컬 덮어쓰기, 큰 생성물은 이미 ignore되어야 한다. 수동 커밋을 원하면 공식 문서대로 auto-commit을 끈다.

공식 알림: API는 공급자 요금. 처음에는 싸고 짧은 컨텍스트 모델로 흐름을 익힌 뒤, 실제로 결제할 모델로 바꾼다.

변경을 사람과 볼 때

에이전트가 고친 뒤에는 무엇이 바뀌었고 왜 합쳐도 되는지의 한 장이 부족한 경우가 많다. 회의 스위트는 필요 없다. tidemeet에서 짧은 공간을 열거나 공간 만들기를 본다. 캔버스는 공유 화이트보드 기초. 이 사이트의 다른 터미널 에이전트 입문은 Codex CLI.

질문