1. API 키 생성
IteraCompute 계정을 생성하거나 로그인한 다음 콘솔에서 키를 생성하세요.
3단계로 연결
2. 기본 URL 구성
OPENAI_API_BASE 및 OPENAI_API_KEY를 설정합니다.openai/ 접두사는 Aider에게 OpenAI 호환 공급자를 사용하도록 지시합니다.
3. 모델을 선택하세요
선택한 모델에 대한 정확한 API 모델 ID를 사용하세요.에이전트 또는 비전 기능을 활성화하기 전에 해당 컨텍스트와 기능을 확인하세요.
모델을 선택하세요
예시 구성
서버 환경이나 도구 자격 증명 저장소에 API 키를 보관하세요.해당하는 경우 예제 키 필드를 사용자 고유의 키로 바꿉니다.
Shell · 프로젝트에서 실행
export OPENAI_API_BASE="https://api.iteracompute.com/v1"
export OPENAI_API_KEY="$ITERACOMPUTE_API_KEY"
aider --model openai/qwen/qwen3.8-27b버전 및 검증
구성 참조 · 2026년 10월 15일에 검토되었습니다.재현 가능한 전체 도구 테스트는 여기에 기록되지 않았습니다.아래 단계를 실행할 때 설치된 버전과 테스트 날짜를 기록하세요.
성공 기준
Aider에게 하나의 작은 추적 파일을 변경하도록 요청하세요.결과 diff와 통과한 테스트 명령을 확인하세요.
설치된 버전 기록
aider --version아래 API 확인 후 구성된 도구 자체를 테스트해 보세요.HTTP 200 또는 cURL 결과만으로는 해당 도구를 확인할 수 없습니다.
연결 테스트
cURL · 채팅 완료
# Bash / zsh / WSL; set ITERACOMPUTE_API_KEY in your environment first.
curl --fail-with-body https://api.iteracompute.com/v1/chat/completions \
-H "Authorization: Bearer $ITERACOMPUTE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"qwen/qwen3.8-27b","messages":[{"role":"user","content":"Reply with exactly: Hello!"}],"max_tokens":512}'choice[0].message.content에 보이는 텍스트가 포함되어 있는지 확인하세요.HTTP 200만으로는 부족합니다.추론은 출력 예산을 소비할 수 있습니다.무료 Qwen을 사용하려면 다음을 사용하세요. 첫 번째 무료 통화 예시 사고를 비활성화하려면 도구 내부에 메시지를 보내세요.
선택된 모델 기능
선택한 모델의 API 기능입니다.워크플로의 기능 가용성은 도구 및 해당 설정에 따라 달라집니다.추론 제어는 모델에 따라 다릅니다.
- 채팅 완료지원됨
- 도구 호출지원됨
- 추론지원됨
- 이미지 입력지원됨
- 스트리밍지원됨
문제 해결
모델이 인식되지 않음
aider --model openai/qwen/qwen3.8-27b를 사용하고 OPENAI_API_BASE와 OPENAI_API_KEY를 설정하세요.openai/ 접두사는 호환되는 공급자를 선택합니다.
형식 수정이 거부됨
익숙하지 않은 모델에는 명시적인 Aider 모델 메타데이터 또는 편집 형식 설정이 필요할 수 있습니다.광범위한 변경 사항을 적용하기 전에 하나의 작은 추적 파일을 테스트하십시오.
사용할 수 있는 패치가 없습니다.
저장소에서 실행하고 원하는 파일을 추가하세요.실제 차이점을 확인하고 테스트를 실행하세요.성공적인 대화가 성공적인 패치의 증거는 아닙니다.
429 / 요청 제한
계정 전체의 월간 사용량과 TPM을 확인하세요.이후 재시도를 존중하고 병렬 재시도를 방지합니다.무료 Qwen에는 자동으로 지불되는 초과분이 없습니다.다른 모델은 게시된 가격을 사용합니다.
401 / 403 : 키와 모델 권한을 확인하세요.무료 Qwen에는 잔액이나 카드가 필요하지 않습니다.유료 모델의 경우 사용 가능한 잔액도 확인하세요.
