Cursor에서 4AICode API 설정

Cursor는 VS Code 기반 AI IDE입니다. OpenAI 호환 설정 또는 Claude Code 확장을 4AICode로 연결하면 팀 토큰, 할당량, 사용량 과금을 함께 쓸 수 있습니다.

시작 전

토큰 관리에서 토큰을 만듭니다(sk-4ai-...).
릴레이 호스트를 고릅니다.
- 중국 본토: https://relay.4aicode.net
- 국제: https://relay.4aicode.com

옵션 A: Cursor 모델 설정(OpenAI 호환)

Cursor 내장 Chat / Agent에서 GPT 계열 모델을 쓸 때 적합합니다.

Cursor Settings → Models를 엽니다.
OpenAI API key / custom base URL 옵션을 켭니다(Cursor 버전마다 라벨이 다를 수 있음).
다음을 설정합니다.
- API Key: sk-4ai-<your-token>
- Base URL: https://relay.4aicode.com/v1(본토 네트워크는 .net)
gpt-6-astra, gpt-5.6-sol 등 지원 모델 ID를 선택합니다. 모델 카탈로그를 참고하세요.
새 채팅에서 ping을 보낸 뒤 사용량에서 호출을 확인합니다.

Cursor Chat과 Claude Code 확장은 서로 독립입니다. Chat은 OpenAI 호환 설정을, Claude Code는 Anthropic Messages 프로토콜을 사용합니다.

옵션 B: Claude Code 확장

VS Code / Cursor / Windsurf 가이드를 따르고 다음을 설정합니다.

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://relay.4aicode.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-4ai-xxxxxxxxxxxxxxxx" }
  ]
}

환경 변수가 다시 로드되도록 Cursor를 완전히 종료한 뒤 다시 엽니다.

문제 해결

여전히 로그인을 요구함: OpenAI 호환 URL에는 /v1이 필요합니다. ANTHROPIC_BASE_URL에는 붙이지 않습니다.
알 수 없는 모델: 모델 카탈로그에서 ID를 그대로 복사하세요.
401 / 429: 401, 429를 참고하세요.