APIMaster.ai
APIMaster.ai 문서
Quick startAPIMaster.aiMarketplace

Cursor API 키 설정 — APIMaster 타사 키 가이드

Cursor에서 APIMaster.ai API 키를 사용하여 DeepSeek, GPT, Claude를 활용하는 방법. 설정 커스텀 모델, GPT/Claude 함정, 공식 Codex / Claude Code 확장 워크플로우를 다룹니다.

Cursor 는 AI 기반 코드 편집기입니다. APIMaster.ai는 OpenAI 호환 및 Claude Messages API를 제공합니다. Cursor의 내장 타사 키 설정 또는 공식 확장을 통해 연결할 수 있습니다.

API 키 받기부터 시작하세요. 키는 본인 기기에만 보관하고 채팅이나 스크린샷에서 공유하지 마세요.

어떤 방법을 사용할까

목표 권장 방법
Cursor에 내장되지 않은 모델 (예: DeepSeek) Cursor 설정 → 모델 + 커스텀 모델 ID
APIMaster를 통해 결제되는 GPT-5.4 / GPT-5.5 Codex 확장 + ~/.codex 설정
APIMaster를 통해 결제되는 Claude Sonnet / Opus Claude Code 확장 + ~/.claude 설정
일반 코딩 에이전트 Cline (OpenAI 호환) 도 사용 가능

사전 준비 사항

  1. Cursor 설치 (Windows / macOS / Linux).
  2. Cursor의 타사 API 키 기능은 Cursor Pro가 필요합니다.
  3. 콘솔에서 APIMaster API 키.
  4. 마켓플레이스의 대상 모델 ID.

방법 1: Cursor 설정 (DeepSeek 등에 적합)

Cursor가 기본 제공하지 않는 모델 ID(예: deepseek-v4-pro)에 작동합니다.

1단계: API 키 및 Base URL

  1. Cursor 설정 → 모델(또는 API 키)을 엽니다.

  2. OpenAI API 키를 활성화하고 APIMaster 키를 붙여넣습니다.

  3. OpenAI Base URL 재정의를 활성화합니다:

    https://apimaster.ai/v1

    /v1 접미사를 포함해야 합니다.

Cursor 설정: API 키 및 Base URL 재정의

2단계: 커스텀 모델 추가

  1. 모델 추가를 클릭합니다.
  2. 마켓플레이스 모델 ID를 입력합니다 (예: deepseek-v4-pro).
  3. 활성화하고 채팅 모델 선택기에서 선택합니다.

deepseek-v4-pro 추가 및 활성화

3단계: 테스트

Cursor 채팅에서 메시지를 보냅니다. 하단에 deepseek-v4-pro가 표시되고 응답이 오면 트래픽이 APIMaster를 통해 전달되는 것입니다.

방법 1의 한계: 내장 GPT 및 Claude

동일한 설정 타사 키로 GPT와 Claude 이름은 종종 다르게 동작합니다:

1. 내장 이름 중복 추가 불가

gpt-5.4, gpt-5.5 또는 일부 Claude ID를 추가하면 실패할 수 있습니다. Cursor가 이미 해당 슬롯을 공식 Cursor 경로로 예약하고 있기 때문입니다.

해결책: APIMaster에서 GPT 및 Claude는 방법 2(Codex / Claude Code 확장)를 사용하세요.

2. APIMaster 설정 후 내장 GPT 오류

Base URL 재정의가 APIMaster를 가리키는 상태에서 Cursor의 내장 GPT-5.4 / GPT-5.5를 선택하면 오류가 발생할 수 있습니다. 내장 경로가 커스텀 Base URL과 충돌하기 때문입니다.

해결책: 내장 GPT 모델 대신 Codex 사이드 패널을 사용하세요.

3. 내장 Claude는 Cursor Pro 할당량 사용

메인 채팅의 내장 Claude/Sonnet은 일반적으로 Cursor Pro에 청구되며 APIMaster 키를 사용하지 않습니다.

해결책: Claude Code 확장 패널을 사용하세요.

방법 2: Codex 및 Claude Code 확장 (GPT 및 Claude)

공식 확장을 설치하고 CLI와 동일한 설정 파일을 통해 APIMaster를 가리키도록 구성합니다.

설치

  • Codex – OpenAI 코딩 에이전트 (openai)
  • Claude Code for VS Code (Anthropic)

마켓플레이스에서 Codex 설치

마켓플레이스에서 Claude Code 설치

APIMaster 설정

확장 가이드 파일 Base URL
Codex (GPT) Codex 설정 ~/.codex/config.toml, auth.json https://apimaster.ai/v1
Claude Code Claude Code 설정 ~/.claude/settings.json https://apimaster.ai (/v1 없음)

각 가이드에서 전체 파일 내용과 백업 방법을 확인하세요.

Cursor에서 사용

CODEX 또는 CLAUDE CODE 활동 표시줄 아이콘을 열고 그곳에서 채팅하면 됩니다. 청구는 Cursor의 내장 모델과 별도로 APIMaster를 사용합니다.

Cursor의 Codex 패널

Cursor의 Claude Code 패널

문제 해결

문제 해결 방법
API 키 / 재정의 옵션 없음 Cursor Pro 필요
401 오류 키 확인; 추가 공백 없음
404 모델 마켓플레이스 ID와 정확히 일치하는지 확인
gpt-5.4 추가 불가 Codex 확장 사용
Claude가 여전히 Pro 할당량 사용 Claude Code 패널 사용
Codex가 OpenAI에 접속 가이드에 따라 ~/.codex 설정 전체 파일 교체

관련 문서