자체 API 게이트웨이를 통한 Claude와 GPT 연동: OpenAI 호환 방식 vs Anthropic, 그리고 /v1의 함정

curl https://api.apivai.com/v1/models \
  -H 

1. **API 제공업체(API Provider)**를 **Anthropic**으로 설정합니다.
2. 키를 **Anthropic API Key**에 붙여넣습니다.
3. **사용자 지정 기본 URL 사용(Use custom base URL)**을 체크하고 `https://api.apivai.com`을 입력합니다.
4. 드롭다운 메뉴에서 Claude 모델을 선택합니다.

여기서 `/v1`를 추가하지 마십시오. Cline의 Anthropic 클라이언트는 자동으로 `/v1/messages`를 붙이므로, `https://api.apivai.com/v1`은 `/v1/v1/messages`가 되어 404 오류를 반환합니다. 원하는 Claude 모델이 아직 Cline 목록에 없다면, OpenAI 호환 제공업체를 사용하고 ID를 직접 입력하십시오.

## 작업별 적합한 모델 선택

Cline은 대화 내용과 읽은 모든 파일을 각 단계마다 재전송하므로, 입력 토큰(input tokens)이 빠르게 쌓이고 채팅 앱보다 토큰당 비용이 더 중요합니다. 실질적인 분배는 다음과 같습니다:

-   일상 코딩: `claude-sonnet-4-6` 또는 `claude-sonnet-5-5`
-   어려운 버그 및 대규모 리팩토링, Sonnet이 계속 순환하는 경우: `claude-opus-5-5`
-   이름 변경, 주석 추가, 작은 수정: `claude-haiku-4-5`
-   두 번째 의견: `gpt-5.5` (OpenAI 호환 전용)

## 일반적인 오류

-   **401 / invalid key**: 키가 불완전하거나 삭제된 경우입니다. Anthropic 제공업체를 사용할 때는 **사용자 지정 기본 URL 사용**이 체크되어 있는지, 또는 Cline이 키를 Anthropic에 직접 보내는 것인지도 확인하십시오.
-   **402 / insufficient_quota**: 키의 예산이 소진되었거나, 남은 금액으로는 고비용 모델(Opus, Sonnet 4.6)에 대한 요청 한 번을 처리하기에 너무 적은 경우입니다. 키에 예산을 추가하거나 더 저렴한 모델로 전환하십시오.
-   **404**: 거의 항상 `/v1` 문제입니다. OpenAI 호환 방식은 `https://api.apivai.com/v1` (슬래시 하나만 있는 `/v1`, `/chat/completions` 아님)가 필요하고, Anthropic은 `/v1` 없이 `https://api.apivai.com`이 필요합니다.
-   **Model not found**: 표시 이름이 아닌 정확한 ID(예: `claude-sonnet-4-6`)를 사용하십시오.
-   **Empty or cut-off replies**: 생각하기 기능(thinking)은 기본적으로 켜져 있으며 출력 토큰을 사용합니다. **최대 출력 토큰(Max Output Tokens)**을 8192로 높이십시오 (최소 4096). 
-   **429**: 기본 제한은 키당 분당 60회 요청입니다. 긴 에이전트 실행 시 이 제한에 도달할 수 있으니, 잠시 기다리거나 작업을 여러 키에 걸쳐 분산시키십시오.

## 비용 정보

작성 시점 기준으로 APIVAI의 대부분 Claude 모델은 Anthropic 공식 가격 대비 56–62% 저렴하며, GPT 모델은 OpenAI 공식 가격 대비 최대 86% 저렴합니다. 예를 들어, Claude Sonnet 4.6은 공식 $3 / $15 대비 입력/출력 백만 토큰당 $1.15/$5.74입니다. 이는 구독 방식이 아닌 선불 및 토큰별 청구 방식이며, 전체 가격표는 [https://apivai.com/pricing](https://apivai.com/pricing)에서 확인할 수 있습니다.

댓글로 질문을 환영합니다.