Aider AI란 무엇이며 Aider 사용법: 초보자 가이드

안녕하세요! 궁극적으로 당신과 함께 프로그래밍을 할 수 있는 슈퍼 스마트 어시스턴트를 갖고 싶었던 적이 있나요? 터미널에서 코드 수정과 변경 사항을 전문적으로 커밋할 수 있는 어시스턴트를 소개합니다. Aider AI를 만나보세요. 2025년 코딩 시장을 바꾸고 있는 오픈 소스 AI 코딩 어시스턴트입니다. 이것은 당신의 개인 코딩 사이드킥과 같으며, Claude나 GPT-4o 같은 좋아하는 대규모 언어 모델(LLMs)로 구동되어 프로젝트 구축, 버그 수정 또는 비브 코드 같은 게임까지 도와줄 준비가 되어 있습니다. 이 초보자 가이드에서 Aider AI를 설치하는 방법부터 브라우저에서 대화하는 방법까지 알아보도록 하겠습니다. 설정, 사용법, LLM 연결하기, 그리고 챔프처럼 구성하는 방법을 다룰 것입니다. 코딩이 순풍처럼 느껴질 준비가 되셨나요? 그럼 시작해봅시다!

💡

우리가 Aider AI를 시작하기 전에, API 애호가들에게 완벽한 Apidog에 간단히 인사를 전합시다! 이 멋진 도구는 API 설계, 테스트 및 문서화를 매우 쉽게 만들어주며, 인터페이스가 매우 친숙하여 초보자들도 쉽게 사용할 수 있습니다. 당신이 Aider AI의 모험과 함께 앱을 구축하고 있다면, apidog.com에서 확인하세요. 개발자의 꿈이 실현되는 곳입니다!

button

Aider AI란 무엇인가요? 당신의 코딩 듀오입니다.

자, Aider AI는 어떤 것일까요? Paul Gauthier가 만든 이 것은 터미널이나 브라우저에서 AI와 함께 페어 프로그래밍을 할 수 있게 해주는 무료이고 오픈 소스 도구입니다. 기본적인 코드 완성 도구와는 달리, Aider AI는 당신의 Git 저장소를 깊이 탐색하고, 코드베이스를 매핑하며, 여러 파일에서 스마트한 수정 작업을 수행합니다. 이는 Python, JavaScript, Rust 및 수십 가지 다른 언어에 능통한 주니어 개발자를 가진 것과 비슷하며, 깔끔한 Git 메시지와 함께 자동으로 변경 사항을 커밋합니다. 새 프로젝트를 시작하든 오래된 프로젝트를 멋지게 꾸미든, Aider AI는 더 빠르고 매끄럽게 코딩할 수 있게 해줍니다. X 사용자들은 그 이유로 “최고의 무료 AI 코딩 어시스턴트”라고 부릅니다. 강력하고 유연하며 그냥 재미있습니다.

Aider AI를 시작하는 방법을 단계별로 살펴보면서 왜 모두가 이 도구에 열광하는지 당신도 알게 될 것입니다.

1. Aider AI 설치하기: 정말 간단합니다

Aider AI를 실행하는 것은 매우 간단한 작업입니다. 특히 터미널에 익숙하다면 더욱 그렇습니다. aider.chat의 공식 문서에서는 몇 가지 방법을 추천합니다. 나는 초보자를 위한 가장 간단한 방법으로 안내할 것입니다. 알아야 할 사항은 다음과 같습니다.

필요 조건

Aider AI를 설치하기 전에 다음을 준비하세요:

Python: 버전 3.9 이상. python --version 명령어로 확인하세요. Python이 없다면 python.org에서 다운로드하세요.
Git: 버전 관리용 도구입니다 (이는 Aider AI가 변경 사항을 추적하는 방법입니다). git --version을 실행하여 설치 여부를 확인하세요. 설치되어 있지 않다면 git-scm.com으로 가세요.
터미널 접근: 명령줄이 필요합니다 (Mac/Linux의 경우 터미널, Windows의 경우 PowerShell).
API 키 (지금은 선택 사항): Claude나 GPT-4o 같은 프리미엄 LLM을 사용하려면 Anthropic이나 OpenAI의 키가 필요합니다. 나중에 다룰 것입니다.

단계별 설치

Aider 문서에서는 pipx 또는 uv를 사용하여 깨끗한 설치를 권장하지만, 우리는 pip를 가상 환경에서 사용하여 정리된 상태를 유지할 것입니다. 따라해 보세요:

가상 환경 만들기:
터미널을 열고 코딩 프로젝트를 위한 새로운 폴더를 만드세요:

mkdir aider-projects
cd aider-projects
python -m venv aider-env

활성화하세요:

Mac/Linux: source aider-env/bin/activate
Windows: aider-env\Scripts\activate

Aider AI 설치하기:
환경이 활성화되었으면 다음을 실행하세요:

python -m pip install -U --upgrade-strategy only-if-needed aider-chat

이 명령은 최신 Aider AI 패키지(2025년 4월 기준 0.42.1)와 그 의존성을 가져오지만 시스템 Python에는 영향을 주지 않습니다.

작동 테스트하기:
작동하는지 확인해 보세요:

aider --version

“Aider v0.42.1-dev”와 같은 것이 보일 것입니다. 오류가 발생하면 python -m aider --version를 시도하거나 Python 버전을 다시 확인하세요.

옵션 추가하기:
음성 명령을 사용하거나 웹 페이지를 스크랩하고 싶으신가요? 문서에서는 웹 스크래핑을 위해 Playwright를 설치할 것을 제안합니다:

pip install playwright
playwright install

또는 음성을 위해 PortAudio를 설치합니다 (Mac/Linux 예시):

brew install portaudio

이것들은 완전히 선택 사항입니다. 지금 시작하시는 거라면 생략하세요.

이게 다입니다! 이제 Aider AI가 시스템에 설치되어, 코딩할 준비가 되었습니다. 문제가 발생하면 설치 가이드에 더 많은 팁이 있습니다.

2. Aider AI 사용하기: 터미널, 브라우저 및 채팅 모드

이제 Aider AI가 설치되었으니 사용해 봅시다! 터미널에서 클래식 코딩을 즐기거나 브라우저에서 GUI로 사용하거나, 채팅 모드를 전환하여 행동 방식을 제어할 수 있습니다. 여기서 요점을 설명할게요.

터미널에서 Aider AI 실행하기

터미널에서는 Aider AI가 빛을 발합니다. Git 저장소로 이동하거나 새로 만들어 보세요:

mkdir my-project
cd my-project
git init

Aider AI를 시작하세요:

aider

이제 aider >와 같은 프롬프트가 나타납니다. 이것은 코드 모드로, 변경 요청에 대해 Aider AI가 파일을 직접 수정합니다. 시도해 보세요:

>> "Hello, Aider!"를 출력하는 hello.py라는 Python 스크립트를 만드세요.

Aider AI가 hello.py를 작성하고, 차이점(diff)을 보여주고, Git에 커밋합니다. 수정이 필요하신가요? 다음과 같이 말씀해 보세요:

>> hello.py에 이름을 인수로 받아 인사말을 출력하는 함수를 추가하세요.

파일을 업데이트하고 다시 커밋해 줄 것입니다. 정말 부드럽죠!

채팅 모드 전환하기

Aider AI는 당신의 기분에 맞는 네 가지 채팅 모드를 제공합니다 [aider.chat/docs/usage]. /chat-mode <mode> 플래그나 /<mode name> 명령어를 사용하세요:

코드 모드 (기본): 요청에 따라 파일을 수정합니다. 예: > /chat-mode code.

건축 모드: 코딩 전에 큰 변화를 계획합니다. 시도해 보세요: > /architect 그리고 “REST API 설계하세요.”

질문 모드: 파일에 손을 대지 않고 질문에 답변합니다. 실행: > /chat-mode ask이고, “Python 데코레이터가 무엇인가요?”라고 물어보세요.

도움 요청 모드: Aider AI 기능에 대해 설명합니다. 입력하세요: > /chat-mode help 또는 > /help 파일을 어떻게 추가하나요?

세션 중간에 /chat-mode <name> 및 /<mode name>로 모드를 전환할 수 있습니다. AI 페르소나를 전환하는 것과 같아서 매우 유용합니다!

브라우저에서 Aider AI 사용하기

터미널이 마음에 들지 않나요? Aider AI는 실험적인 브라우저 모드도 갖추고 있습니다 [aider.chat/docs/usage]:

aider --browser

이 명령은 웹 UI(브라우저의 로컬호스트)를 열어 Aider AI와 채팅할 수 있도록 해줍니다. 시각적인 것을 선호하거나 여러 작업을 동시에 처리하는 경우에 좋습니다. 여전히 Git 저장소가 필요하며, API 키가 설정된 경우에 가장 잘 작동합니다 (그에 대해서는 곧 다룰 것입니다). UI는 조금 원시적이지만 X 사용자들은 빠른 편집을 위해 “놀랍도록 매끄럽다”고 합니다.

전문적인 사용 팁

파일 추가하기: Aider AI에게 편집할 파일을 aider file1.py file2.js와 같이 알려주거나 채팅 중에 /add file.py를 입력하세요. 과부하를 주지 마세요—필요한 것만 선택하십시오 [aider.chat/docs/usage].
변경 사항 되돌리기: 실수하셨나요? /undo를 입력하여 마지막 커밋을 되돌리세요.
테스트 실행하기: /run pytest를 사용하여 테스트를 실행하고 Aider AI가 실패를 수정하도록 하세요.
음성 모드: 대화하고 싶으신가요? 음성 명령을 시험해 보세요 /voice를 입력하세요 (PortAudio 필요).

당신이 터미널을 고집하는 hardcore 사용자건, 브라우저에 호기심이 있든 Aider AI는 당신의 스타일에 맞춰 적응합니다.

3. Aider AI를 LLM에 연결하기

Aider AI는 그 뒤에 있는 LLM만큼만 스마트하며, 운 좋게도 많은 모델과 호환성이 있습니다—Claude 3.7 Sonnet, GPT-4o, DeepSeek, 심지어 Ollama를 통한 로컬 모델까지. 다음은 설정하는 방법입니다.

LLM 선택하기

문서는 최고 성능 모델을 강조합니다 [aider.chat/docs/llms]:

Claude 3.7 Sonnet: 추론에 좋습니다. 사용법: aider --model sonnet.
GPT-4o: 빠르고 다재다능합니다. 실행: aider --model gpt-4o.
DeepSeek R1: 예산에 친숙합니다. 시도해 보세요: aider --model deepseek.
로컬 모델: Ollama가 있나요? 서버를 시작한 후: aider --model ollama/llama3.

사용 가능한 모델 목록을 확인하려면:

aider --list-models openai/

전체 목록은 [aider.chat/docs/llms]를 확인하세요.

API 키 설정하기

프리미엄 LLM은 OpenAI나 Anthropic과 같은 제공업체에서 API 키가 필요합니다. 아래에서 받으세요:

OpenAI: platform.openai.com (ChatGPT Plus 아님!).
Anthropic: console.anthropic.com.

명령줄로 키를 전달하십시오:

aider --model gpt-4o --api-key openai=sk-xxx

혹은 더 나은 방법은 안전하게 저장하는 것입니다 (아래 구성 참조). 로컬 모델의 경우, 키가 필요하지 않습니다—단지 실행 중인 Ollama 서버만 있으면 됩니다.

웹 채팅 대체 수단

API 키가 없으신가요? Aider AI는 LLM의 웹 채팅(예: ChatGPT 사이트)으로 코드를 복사 및 붙여넣을 수 있습니다 [aider.chat/docs/llms]. 실행:

aider --copy-paste

약간 번거롭지만 필요한 경우에 작동합니다. 전체 경험을 위해서는 API 키를 사용하는 것이 좋습니다.

언제든지 /model <name>로 모델을 전환할 수 있습니다. Aider AI의 유연함 덕분에 완벽한 코딩 파트너를 찾기 위해 실험할 수 있습니다.

4. Aider AI 구성하기: API 키, .env 파일 및 기타

Aider AI는 매우 사용자 정의가 가능하여 API 키부터 색상까지 모든 것을 조정할 수 있습니다. 주요 사항인 API 키와 .env 파일, 그리고 몇 가지 다른 옵션에 대해 집중해 보겠습니다 [aider.chat/docs/config].

API 키 저장하기

매번 API 키를 입력하는 것은 귀찮습니다. Aider AI는 다음에 저장할 수 있습니다:

i) 명령줄: --api-key openai=sk-xxx와 같이.

ii) 환경 변수:

Mac/Linux: export OPENAI_API_KEY=sk-xxx
Windows: setx OPENAI_API_KEY sk-xxx (셸을 재시작하세요).

iii) .env 파일: 가장 쉬운 방법입니다. 설정해 보겠습니다.

.env 파일 사용하기

.env 파일은 키 및 설정을 안전하게 저장합니다. Aider AI는 이를 홈 디렉토리, Git 저장소 루트 또는 현재 폴더에서 찾습니다 [aider.chat/docs/config/dotenv]. 방법은 다음과 같습니다:

프로젝트에서 .env라는 파일을 만드세요:

touch .env

2. 키를 추가하세요:

OPENAI_API_KEY=sk-xxx
ANTHROPIC_API_KEY=sk-xxx
DEEPSEEK_API_KEY=xxx

3. 저장하고 Aider AI를 실행하세요:

aider

스스로 키를 자동으로 로드할 것입니다—플래그가 필요 없습니다!

다른 제공업체(예: Gemini)에 대해서는:

GEMINI_API_KEY=xxx

또는 --api-key gemini=xxx 플래그를 사용하세요.

중요: .env를 Git에서 제외하세요—누출을 방지하기 위해 .gitignore에 추가하세요.

기타 멋진 구성 옵션

Aider AI는 명령 플래그, .aider.conf.yml 또는 .env를 통해 많은 조정을 제공합니다 [aider.chat/docs/config/options]:

색상: 어두운 터미널 좋아하시나요? --dark-mode를 시도해 보세요:

AIDER_DARK_MODE=true

모델 설정: 추론 노력을 설정합니다: --reasoning-effort high 또는 AIDER_REASONING_EFFORT=high.
편집기 모드: VS Code에서 Aider AI를 실행하나요? 터미널 창에서 잘 작동합니다. /add로 파일을 추가하거나 --fancy-input로 편집을 관찰하세요.
YAML 구성: 구성 파일을 선호하나요? .aider.conf.yml를 생성하세요:

model: gpt-4o
openai-api-key: sk-xxx

저장소 루트나 홈 디렉토리에 놓으세요.

모든 옵션을 확인하려면:

aider --help

또는 [aider.chat/docs/config/options]를 참조하세요. Aider AI는 당신의 도구가 될 수 있게 해줍니다.

보너스: 초보자에게 Aider AI가 멋진 이유

그렇다면 왜 초보자로서 Aider AI를 선택해야 할까요? 용서가 넓고 강력합니다:

Git 안전성: 자동 커밋은 git revert를 통해 실수를 되돌릴 수 있게 해줍니다.
언어 지원: Python, JS, Go, HTML—모두 처리합니다.
커뮤니티 사랑: X 포스트들은 생산성을 높이는 “정말 놀라운” 도구라고 평가하며, Eric S. Raymond는 “당신의 세계를 흔든다”고 말했습니다.
무료 및 오픈: Apache 2.0 라이센스를 가지고 있어 GitHub에서 수정할 수 있습니다.

AI 코딩을 위한 훈련 바퀴와 같습니다—전문가의 스트레스 없이 전문가의 결과를 얻을 수 있습니다.

HiMCP.ai - 1682개 이상의 MCP 서버 찾기

마무리: 당신의 Aider AI 여정이 이제 시작됩니다

축하합니다—이제 Aider AI를 동작할 준비가 되셨습니다! 가상 환경에서 설치하는 것부터 아키텍트 모드에서 대화하거나, VS Code에 연결하는 것, 또는 .env 파일을 설정하는 것까지, 더 스마트하게 코딩할 수 있는 도구가 갖춰졌습니다. 터미널을 켜고 aider --browser를 시도하거나 게임을 만들기 위해 요청하세요—어 vielleicht Pong? Aider AI 문서는 더 많은 팁으로 가득하니 계속 탐색해보세요. 당신의 첫 번째 Aider AI 프로젝트는 무엇이 될까요? 그리고 apidog.com에서 API를 테스트하는 것 잊지 마세요, 당신의 개발 도구 키트를 보완하기 위해서요.

button