Aider

환경 변수 두 개와 접두사만 있으면 됩니다. OPENAI_API_BASE를 https://api.kunavo.com/v1로, OPENAI_API_KEY를 sk-kn-… 키로 설정한 다음 --model openai/<id>를 사용해 Aider를 실행하세요. 저장소나 Aider 설치는 변경하지 않습니다.

export OPENAI_API_BASE=https://api.kunavo.com/v1
export OPENAI_API_KEY=sk-kn-...

# The openai/ prefix is required — it tells Aider to speak the OpenAI
# protocol to OPENAI_API_BASE instead of resolving the id as a known model.
aider --model openai/claude-sonnet-5

단계별 안내

1. /app/keys에서 키를 생성해 복사하세요. 키는 한 번만 표시됩니다.
2. Aider를 실행할 셸에서 OPENAI_API_BASE 및 OPENAI_API_KEY를 내보내거나, 아래와 같이 ~/.aider.conf.yml에 입력하세요.
3. 저장소에서 aider --model openai/claude-sonnet-5를 사용해 Aider를 시작하세요.
4. Aider는 시작할 때 확인된 모델을 출력합니다. 해당 줄에 요청한 ID가 표시되면 엔드포인트 연결이 설정된 것입니다.

이 내용에 관한 Aider 자체 안내는 OpenAI 호환 API 페이지를 참조하세요.

셸 프로필에 키를 저장하지 않기

같은 두 값을 Aider 설정 파일에 저장할 수도 있습니다. 프로젝트별로 엔드포인트를 바꿔 사용하는 경우 이 방법이 더 적합합니다.

# ~/.aider.conf.yml — same two values, without exporting them each shell.
openai-api-base: https://api.kunavo.com/v1
openai-api-key: sk-kn-...
model: openai/claude-sonnet-5

Aider를 디버깅하기 전에 확인하세요

요청 한 번이면 문제의 원인이 엔드포인트, 키, Aider의 모델 확인 중 어디에 있는지 판단할 수 있습니다. 이 요청이 모델 ID의 JSON 목록을 반환한다면 Aider에서도 같은 기본 URL과 키를 사용할 수 있으며, 남은 오류는 openai/ 접두사와 관련된 것입니다.

# Settles whether a failure is the endpoint, the key, or Aider.
# A JSON list of model ids means the same base URL will work in Aider.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

선택할 모델

Kunavo의 모든 텍스트 모델은 openai/<id>로 이용할 수 있습니다. 전체 목록은 모델 페이지에서 확인할 수 있으며 GET /v1/models에서 실시간으로 가져옵니다. 요금은 USD 기준 토큰 1백만 개당 입력/출력 가격입니다.