Cursor / Claude Code / Cherry Studio를 커스텀 AI 게이트웨이에 연결하는 가이드

튜토리얼 · 2026-11-20 · 약 7분 읽기

주요 AI 도구는 모두 커스텀 API를 지원합니다——즉, 자신의 게이트웨이(4-4 AI 등)로 방향을 바꿔 키와 과금을 통일할 수 있습니다. 본문은 가장 많이 쓰는 세 도구의 설정 방법과 공통 오류 해결 사고방식을 다룹니다.

전제 조건: API 키가 이미 있어야 합니다. 없다면 먼저《5분 만에 통합 AI API 연결》에서 가입과 키 생성을 마치세요. 본문은 4-4 AI의 Base URL(https://www.4-4.vip/v1)을 예로 하며 다른 OpenAI 호환 게이트웨이도 마찬가지입니다.

Cursor

Cursor의 대화 모델은 커스텀 OpenAI 호환 인터페이스를 사용할 수 있습니다:

  1. Settings → Models 열기(또는 Models 설정 페이지);
  2. OpenAI API Key 영역을 펼쳐 설정: 게이트웨이 키(sk-...) 입력;
  3. Override OpenAI Base URL 체크/입력: https://www.4-4.vip/v1;
  4. 모델 목록에 게이트웨이에서 사용 가능한 모델명 추가(게이트웨이 채널명과 완전히 일치, 대소문자 구분);
  5. Verify 클릭해 검증이 통과되면 대화 하단에서 커스텀 모델로 전환하면 됩니다.

참고: Cursor 내장 Tab 보완, Composer 일부 기능은 Cursor 자체 서비스를 사용하므로 이 설정의 영향을 받지 않습니다. 커스텀 모델은 주로 Chat 대화에 사용됩니다.

Claude Code

Claude Code는 Anthropic 프로토콜을 사용합니다. 게이트웨이 연결의 전제는 게이트웨이가 Anthropic 프로토콜 엔드포인트(/v1/messages)를 지원하는 것입니다——new-api 생태계 기반 게이트웨이(4-4 AI 포함)는 이 프로토콜 변환을 지원하며, Claude 프로토콜 요청은 변환되어 실제 모델 채널로 라우팅됩니다.

환경 변수로 설정합니다(claude를 시작하는 터미널에서):

export ANTHROPIC_BASE_URL="https://www.4-4.vip"
export ANTHROPIC_AUTH_TOKEN="sk-YOUR_GATEWAY_KEY"

# start
claude

Windows PowerShell에서는:

$env:ANTHROPIC_BASE_URL = "https://www.4-4.vip"
$env:ANTHROPIC_AUTH_TOKEN = "sk-YOUR_GATEWAY_KEY"
두 가지 세부 사항: ① ANTHROPIC_BASE_URL에는 /v1 접미사를 붙이지 않음(Anthropic 프로토콜 경로는 도구가 자동 조립); ② Claude Code에 Claude 계열이 아닌 모델을 쓰게 하려면 게이트웨이 채널에 해당 모델 매핑이 설정되어 있는지 확인하고 모델명은 게이트웨이 측 이름을 사용.

Cherry Studio

Cherry Studio는 커스텀 OpenAI 호환 공급자 지원이 가장 직접적입니다:

  1. 설정 → 모델 서비스에서 OpenAI 호환 공급자 추가/선택;
  2. API 주소에 https://www.4-4.vip/v1 입력(일부 버전은 /v1을 자동 보완하니 중복 주의);
  3. API 키에 게이트웨이 키 입력;
  4. 모델 관리에서 사용 가능한 모델명을 수동 추가하고 저장 후 대화에서 선택.

공통 법칙: 모든 OpenAI 호환 도구

시중의 많은 도구(LobeChat, Open WebUI, 몰입형 번역, 각종 IDE 플러그인)의 설정 절차는 같습니다. 세 가지 세트를 기억하세요:

설정 항목값흔한 함정
Base URLhttps://www.4-4.vip/v1도구에 따라 /v1을 붙이는 경우와 붙이지 않는 경우가 있습니다——404가 나오면 먼저 /v1 붙였다 뗐다 해보세요
API Key게이트웨이 키(sk-...)앞뒤 공백, 키 만료, 크레딧 소진
모델명게이트웨이 채널의 이름게이트웨이 측과 완전히 일치해야 하며 도구 프리셋에 없는 이름은 사용 불가

오류 해결 매뉴얼(빠른 참조)

401 Unauthorized

404 Not Found

400 Model Not Found / 사용 가능한 채널 없음

스트리밍 출력 중단 / 무응답

자주 묻는 질문(FAQ)

게이트웨이를 거치면 데이터가 안전한가요?

요청은 게이트웨이를 거쳐 상류 모델 채널로 전달됩니다. 게이트웨이 선택 시 로그와 프라이버시 정책을 확인하고, 민감 데이터는 게이트웨이 측에서 대화 로그 저장을 끄거나 데이터를 저장하지 않는 채널을 사용하세요.

한 도구에서 여러 게이트웨이를 동시에 설정할 수 있나요?

대부분의 도구는 다중 공급자 설정과 즉시 전환을 지원합니다(예: Cherry Studio, Cursor). 도구별로 다른 토큰을 쓰면 사용량 집계와 한도 설정도 분리할 수 있습니다.

도구마다 각 공급자에 직접 연결하는 것보다 통합 게이트웨이를 권하는 이유는?

세 가지 이유: 키 중앙 관리(유출 면 축소), 통합 과금과 사용량 가시화(여러 플랫폼에서 대조 불필요), 모델 언제든 교체(공급자 분리, 전환은 게이트웨이 설정 변경만).

관련 글

4-4 AI 빠른 시작: 5분 만에 통합 AI API 연결 OpenAI 호환 인터페이스로 하나의 키로 GLM·DeepSeek·Qwen 등 주요 모델에 연결. 3개 언어의 실행 가능한 예제 포함. AI 앱 토큰 비용을 줄이는 7가지 엔지니어링 실천 모델 등급 라우팅, 컨텍스트 정리, 프리픽스 캐싱, 예산 가드레일 — 코드로 넣어 오래 효과 있는 7가지 절감 실천을 ROI 순으로, 예제와 함께.
연결할 준비가 되셨나요?

하나의 키로 GLM, DeepSeek, Qwen 등 주요 모델에 통합 연결. 통합 과금과 사용량 시각화를 지원합니다.

모델 및 요금 보기 가입하고 사용하기