메인 콘텐츠로 건너뛰기
Aider는 터미널에서 로컬 git 저장소를 편집하는 AI 페어 프로그래밍 도구입니다. Venice는 Aider의 OpenAI 호환 API 지원을 통해 작동합니다 — Venice의 base URL과 API 키를 설정한 뒤 모델 ID 앞에 openai/ 접두사를 붙이세요.

터미널 페어 프로그래밍

CLI에서 Venice 모델로 git 저장소를 편집하세요

OpenAI 호환

Venice의 /chat/completions 엔드포인트 사용

모든 텍스트 모델

어떤 Venice 텍스트 모델 ID로든 교체 가능

​
사전 요구 사항

  • venice.ai/settings/api에서 받은 Venice API 키
  • 시스템에서 사용 가능한 Python 3.9 이상
  • 작업할 git 저장소

​
설정

1

Aider 설치

공식 설치 프로그램으로 Aider를 설치하세요:
다른 설치 방법을 선호하는 경우 Aider 설치 문서를 참조하세요.
2

OpenAI 엔드포인트로 Venice 구성

OpenAI 호환 base URL과 Venice API 키를 설정하여 Aider가 Venice를 향하도록 하세요.Mac / Linux:
Windows (PowerShell):
Windows (명령 프롬프트, 영구 설정):
setx 이후에는 새 변수를 사용할 수 있도록 터미널을 재시작하세요.
3

Venice 모델로 Aider 시작

프로젝트 디렉터리에서 Venice 모델 ID 앞에 openai/를 붙이세요:
처음 시작하기 좋은 다른 모델들:
모델 카탈로그에서 모든 텍스트 모델 ID를 확인할 수 있습니다.

​
.env로 구성 유지

프로젝트 로컬 설정을 위해 git 저장소 루트에 .env 파일을 생성하세요:
그런 다음 평소처럼 Aider를 시작하세요:
Aider는 홈 디렉터리의 .env도 읽습니다. 저장소 루트 값이 홈 디렉터리 값보다 우선합니다. 이 파일을 git에 포함하지 마세요 — 아직 무시되지 않았다면 .gitignore에 .env를 추가하세요.
AIDER_OPENAI_API_BASE와 AIDER_OPENAI_API_KEY도 설정할 수 있습니다. 공식 Aider 문서는 OpenAI 호환 제공자에 대해 여전히 OPENAI_API_BASE와 OPENAI_API_KEY를 문서화하고 있습니다.

​
YAML로 구성 유지

저장소 루트나 홈 디렉터리의 .aider.conf.yml에 동일한 설정을 저장할 수 있습니다:
그런 다음 실행하세요:

​
설정 확인

Aider가 시작된 후, 모델에 도달 가능한지 확인하기 위해 간단한 질문을 던져보세요:
엔드포인트와 키가 올바르다면 Aider는 선택한 Venice 모델로부터 응답을 스트리밍합니다. Aider 외부에서도 API 키를 확인할 수 있습니다:

​
모델 선택

Aider를 시작할 때는 항상 Venice 모델 ID 앞에 openai/를 붙이세요. 이 접두사가 없으면 Aider는 요청을 OpenAI 호환 제공자 경로로 라우팅하지 않습니다. 런타임에 현재 모델 ID를 확인하세요:
또는 text:default와 같은 기본값은 GET /models/traits에서 확인하세요.

​
구성 참고 사항

  • OPENAI_API_BASE는 https://api.venice.ai/api/v1로 설정하세요. /chat/completions를 추가하지 마세요; Aider가 채팅 경로를 스스로 추가합니다.
  • OPENAI_API_KEY에는 Venice API 키를 사용하세요. Venice base URL과 함께 OpenAI 키를 사용하지 마세요.
  • Aider가 모델의 컨텍스트 창이나 비용을 알 수 없다는 경고를 표시할 수 있습니다. 많은 Venice 모델 ID에서 예상되는 경고이며 일반적으로 무시해도 안전합니다. Aider 모델 경고를 참조하세요.
  • 여러 파일 편집에는 유능한 코딩/추론 모델을 선호하세요. 더 작거나 코딩용이 아닌 모델은 Aider의 편집 형식에 어려움을 겪을 수 있습니다.
셸에서 OPENAI_API_BASE와 OPENAI_API_KEY를 설정하면 해당 변수를 읽는 다른 도구들에도 영향을 미칩니다. 동일한 환경에서 OpenAI를 다른 곳에도 사용한다면 프로젝트별 .env 또는 .aider.conf.yml을 선호하세요.

​
문제 해결

OPENAI_API_KEY가 venice.ai/settings/api에서 받은 Venice 키이며 앞뒤 공백이 없는지 확인하세요. Windows에서 setx 이후에는 터미널을 재시작하세요.
텍스트 모델 카탈로그에 모델 ID가 존재하며 예를 들어 openai/zai-org-glm-5-1처럼 openai/ 접두사를 붙여 Aider를 실행했는지 확인하세요.
동일한 셸 세션에서 OPENAI_API_BASE가 정확히 https://api.venice.ai/api/v1인지 확인하세요. echo $OPENAI_API_BASE(또는 PowerShell에서는 $env:OPENAI_API_BASE)로 출력해 보세요.
많은 Venice 모델에서 예상되는 사항입니다. Aider는 합리적인 기본값으로 대체합니다. 이를 숨기려면 Aider 고급 모델 설정에 설명된 대로 모델 메타데이터를 추가하세요.

​
리소스

Venice 텍스트 모델

사용 가능한 Venice 모델 ID를 확인하세요

Aider OpenAI 호환 문서

공식 Aider 제공자 설정

.env로 Aider 구성

API 키와 모델 설정을 유지하세요

Venice API 참조

전체 엔드포인트 및 매개변수 문서