Aider 설치 및 OmniProxy 구성

Aider는 터미널에서 코드 수정을 지원하는 도구입니다. 전체 코드베이스의 지도를 구성하여 모델이 규모가 큰 프로젝트를 이해하도록 돕습니다. Git은 코드 변경 사항을 기록하는 버전 관리 도구로, 차이를 확인하고 변경 내용을 복원할 때 사용할 수 있습니다. Aider에 작업을 맡기면 단계별로 처리하고 커밋 설명을 작성합니다. 변경 내용이 마음에 들지 않으면 /undo로 되돌릴 수 있습니다.

설치 전 준비

일반적으로 다음 두 가지 방법으로 설치할 수 있습니다.

컴퓨터에 Python 3.8부터 3.13까지의 버전이 이미 설치되어 있다면 먼저 aider-install을 설치합니다. Python은 Aider 실행에 필요한 프로그램 환경입니다.
적합한 Python이 없다면 한 줄 설치 명령을 사용합니다. 필요한 경우 Python 3.12도 함께 준비됩니다.

Mac 및 Linux

install.sh

curl 후 sh로 실행
필요하면 Python을 설치함
curl이 없으면 wget 사용 가능

Windows

install.ps1

PowerShell에서 실행
설치 후 터미널 다시 열기
환경 변수에는 setx 사용

Python이 이미 있음

aider-install

먼저 pip로 이 패키지 설치
그다음 aider-install 실행
자체 환경을 생성함

한 줄 설치는 필요한 경우 Python 3.12를 준비합니다. pip로 aider-chat을 직접 설치하는 방법은 안정성이 상대적으로 떨어집니다.

실행 중인 OmniProxy를 준비합니다. 설치가 끝나면 수정하려는 프로젝트 디렉터리로 이동한 다음 Aider를 실행합니다.

설치 및 최초 실행

Python 3.8부터 3.13까지의 버전이 이미 있는 경우

다음 명령을 차례로 실행합니다.

python -m pip install aider-install
aider-install

aider-install은 컴퓨터의 다른 Python 프로젝트와 섞이지 않도록 별도의 Python 환경에 Aider를 설치합니다. 필요한 경우 Aider에서 사용할 Python 3.12도 추가로 설치합니다.

한 줄 설치

Mac과 Linux에서는 다음을 실행합니다.

curl -LsSf https://aider.chat/install.sh | sh

컴퓨터에 curl이 없다면 다음 명령을 대신 사용할 수 있습니다.

wget -qO- https://aider.chat/install.sh | sh

Windows PowerShell에서는 다음을 실행합니다.

powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"

이 한 줄 명령들은 uv를 기반으로 합니다. uv는 Python 도구와 환경을 설치하고 관리하는 프로그램입니다. 다음 명령도 사용할 수 있습니다.

uv tool install --force --python python3.12 --with pip aider-chat@latest

그 밖에 pipx도 사용할 수 있습니다. python -m pip install aider-chat으로 직접 설치할 경우 사용할 수 있는 Python 버전은 3.9부터 3.12까지지만, 이는 기타 설치 방식에 해당하므로 앞에서 설명한 설치 방법을 우선 사용하세요. 시스템 패키지 관리자의 Aider는 종속성이 맞지 않을 수 있으므로 우선적인 설치 방법으로 사용하지 마세요.

2026-10-09에 한 줄 설치 명령으로 Aider v0.86.2가 설치되었습니다. 설치 중 캐시와 대상이 동일한 디스크에 있지 않아 파일 복사 방식으로 전환한다는 메시지가 표시되더라도 설치는 완료됩니다.

설치가 끝나면 프로젝트 디렉터리로 이동합니다. 호환 인터페이스는 OpenAI 형식으로 다른 모델 서비스와 통신하는 인터페이스를 의미하며, 다음 형식으로 실행합니다.

aider --model openai/<model-name>

여기서 <model-name>은 다음 섹션에서 OmniProxy로부터 복사한 전체 모델 ID로 바꿔야 합니다. 모델 ID는 모델을 정확하게 지정하는 이름입니다.

OmniProxy에서 연결 매개변수 가져오기

다음 두 환경 변수를 설정해야 합니다. 환경 변수는 터미널 프로그램이 읽는 연결 설정 모음으로 이해할 수 있습니다.

export OPENAI_API_BASE=https://your-omniproxy-origin.example/v1
export OPENAI_API_KEY=<YOUR_OMNIPROXY_API_KEY>

OPENAI_API_BASE는 인터페이스 주소이며 반드시 /v1까지 입력해야 합니다. OPENAI_API_KEY는 인터페이스에 접근할 때 사용하는 키입니다.

Windows에서는 setx로 변수를 저장합니다. 실행 후 터미널을 다시 열어야 합니다.

setx OPENAI_API_BASE https://your-omniproxy-origin.example/v1
setx OPENAI_API_KEY <YOUR_OMNIPROXY_API_KEY>

모델 이름은 OmniProxy의 현재 목록에서 전체를 복사하고, 모델 ID에 포함된 슬래시도 유지해야 합니다. Aider를 실행할 때 전체 ID 앞에 openai/를 추가합니다.

2026-10-09 기준 공급자 문서에서 확인할 수 있는 두 개의 비교용 ID는 gemini-3.8-flash와 grok-4.7입니다. 현재 목록에 이러한 이름이 없다면 그대로 입력하지 말고 목록에 실제로 존재하는 전체 ID를 사용하세요.

주소

OPENAI_API_BASE

OmniProxy를 가리키도록 설정
/v1까지 입력
저장소에 기록하지 않기

키

OPENAI_API_KEY

게이트웨이에서 발급받은 값 사용
Windows에서는 변경 후 다시 열기
공급자 키는 게이트웨이에 유지

시작

openai/모델

cd로 프로젝트 디렉터리로 이동
모델 이름 앞에 openai/ 추가
이름은 게이트웨이 목록을 기준으로 함

두 환경 변수와 openai/ 접두사가 붙은 모델 이름을 함께 사용하는 것이 호환 인터페이스의 표준 형식입니다.

도구 구성 입력

여기서는 별도의 구성 파일을 만들 필요가 없습니다. 먼저 프로젝트 디렉터리로 이동한 다음 Aider를 실행하고, 모델 ID를 OmniProxy의 현재 목록에 실제로 존재하는 이름으로 바꿉니다.

cd /path/to/your/project
aider --model openai/gemini-3.8-flash

다른 예시 모델로 바꾸려면 다음을 실행합니다.

aider --model openai/grok-4.7

Aider가 알지 못하는 모델을 사용하면 인터페이스에 경고가 표시됩니다. 이 경고 자체가 주소가 잘못되었다는 뜻은 아닙니다. OmniProxy의 호출 기록에서 해당 요청이 발생했는지 확인해야 합니다.

Aider는 Git에서 이미 추적 중인 파일만 컨텍스트에 포함합니다. 컨텍스트란 이번 작업에서 모델이 읽을 수 있는 코드와 정보를 의미합니다. 현재 디렉터리가 아직 Git 저장소가 아니라면 Aider가 저장소를 직접 만들지만, Git에서 추적하지 않는 파일은 여전히 읽을 수 없습니다. 먼저 git add로 파일을 추가하고 커밋한 다음 Aider를 실행하세요.

Aider는 여전히 파일을 수정할 수 있습니다. --no-auto-commits는 자동 커밋만 비활성화하며 파일 수정을 막지는 않습니다. 처음 사용할 때는 중요하지 않은 저장소를 선택하고, 작업이 끝난 후 git diff를 실행하여 실제 변경 내용을 확인하는 것이 좋습니다.

실제 키를 프로젝트 파일이나 공개 페이지에 입력하지 마세요. 공급자 키는 OmniProxy에만 저장합니다. 게이트웨이에서 키를 검증하지 않는 경우 OPENAI_API_KEY에는 로컬에서만 사용하는 임의의 자리표시자 문자열을 입력할 수 있습니다.

실제 작업 검증

먼저 읽을 파일이 Git에 커밋되어 있는지 확인한 다음 프로젝트 디렉터리에서 아래 명령을 실행합니다. 모델 ID는 OmniProxy의 현재 목록에 있는 전체 ID로 바꿔야 합니다.

aider --model openai/gemini-3.8-flash --message "이 파일의 첫 번째 줄은 무엇인가요? 파일을 수정하지 마세요." --no-auto-commits

--message는 Aider에 작업 하나를 직접 전달하는 옵션이며, --no-auto-commits는 이번 실행에서 Git 커밋을 자동으로 만들지 않도록 지정합니다.

2026-10-09에 Aider v0.86.2를 사용하여 추적 중인 파일의 첫 번째 줄을 읽는 데 성공했습니다. 파일이 아직 Git에서 추적되지 않는 경우 Aider는 내용을 볼 수 없다고 답합니다. 이는 인터페이스 주소가 잘못되었다는 뜻이 아닙니다. 질문이 끝나면 OmniProxy의 호출 기록에서 요청 출처와 모델 ID를 확인하세요.

시작

aider가 실행됨

명령을 찾을 수 있음
환경 변수가 적용됨
프로젝트 디렉터리에 위치함

작업

파일을 확인함

특정 파일에 관해 질문하기
설명 확인하기
익숙하지 않은 모델이면 경고가 표시됨

기록

게이트웨이에서 확인 가능

소스가 Aider임
모델 ID가 일치함
키가 페이지에 노출되지 않음

환경 변수가 적용되고 명령을 찾을 수 있는지 확인한 다음 실제 질문을 한 번 완료합니다.

자주 발생하는 오류

aider를 찾을 수 없음: 먼저 터미널을 다시 여세요. pip로 직접 설치했다면 python -m aider를 시도할 수 있습니다.
Windows에서 변수를 변경했지만 계속 이전 주소에 연결됨: setx를 실행한 후에는 반드시 터미널을 다시 열어야 합니다. 새 창에서만 업데이트된 변수를 읽습니다.
모델 이름 앞에 openai/가 없음: 호환 인터페이스에서는 openai/<model-name> 형식으로 입력해야 합니다.
알 수 없는 모델이라는 경고가 표시됨: 정상적으로 표시될 수 있는 안내이며 연결 실패를 뜻하지 않습니다. 이어서 OmniProxy가 요청을 수신했는지 확인하세요.
모델 ID가 유효하지 않음: OmniProxy의 현재 목록에서 전체 ID를 다시 복사하고 openai/ 접두사와 ID에 원래 포함된 슬래시를 유지하세요.
파일 내용이 없다고 표시됨: 파일이 Git에서 추적되고 있는지 먼저 확인하세요. 빈 저장소나 추적되지 않는 파일은 컨텍스트에 포함되지 않습니다.

공식 참고 자료

설치 절차는 Aider installation을 참고하세요. 환경 변수와 모델 접두사는 OpenAI compatible APIs을 참고하세요. 예시에 사용된 모델 ID는 Gemini 모델 목록과 xAI 모델 페이지에서 확인할 수 있습니다.

모든 플레이스홀더를 고유한 OmniProxy 구성의 값으로 바꾸세요. 실제 키를 게시하지 마세요.

저장된 결과나 HTTP 200 만으로는 전체 에이전트 호환성이 입증되지 않습니다. OmniProxy 호출 기록에서 소스와 모델을 확인하세요.

공식 소스 · Aider ↗