Cursor 설정
Cursor는 OpenAI-compatible 설정으로 I Code Easy를 사용할 수 있습니다. 이 설정은 Chat과 Agent에 적용되며 Cursor Tab, Background Agents 같은 Cursor 고유 기능은 사용자가 입력한 API Key로 전환되지 않습니다.
Codex 모델 설정
빠른 설정
| 항목 | 값 |
|---|---|
| Provider | OpenAI |
| API Key | API Keys에서 복사 |
| Override OpenAI Base URL | https://api.icodeeasy.cc/v1 |
| 권장 모델 | gpt-6.1-sol |
기본 도메인이 느리면 https://jp.icodeeasy.cc/v1 또는 https://sg.icodeeasy.cc/v1을 사용하세요.
설정 단계
Cursor Settings → Models → API Keys를 엽니다.OpenAI API Key에 키를 입력하고 Provider를 활성화합니다.Override OpenAI Base URL을 켜고https://api.icodeeasy.cc/v1을 입력합니다.- 모델 검색창에
gpt-6.1-sol을 입력하고Add Custom Model을 클릭합니다. - Chat 또는 Agent에서
gpt-6.1-sol을 선택하고 짧은 메시지를 보냅니다.
Refresh Model List는 Cursor 내장 모델 목록만 갱신하며 사용자 지정 API 서비스의/v1/models를 읽지 않습니다. 정확한 Model ID로 직접 추가하세요.
Claude 모델 설정
Cursor는 현재 OpenAI Base URL Override만 제공하며, 타사 Anthropic-compatible /v1/messages 주소를 입력하는 별도의 Custom Anthropic Base URL 설정을 제공하지 않습니다. 따라서 I Code Easy의 claude-opus-5-5 같은 Claude 모델은 Cursor에 직접 설정할 수 없습니다.
Claude 모델을 사용해야 한다면 사용자 지정 Anthropic Provider를 지원하는 Cherry Studio 또는 TRAE를 사용하세요.
호환성
- Cursor Tab은 항상 Cursor 자체 모델을 사용합니다.
- Agent는 도구 호출과 여러 요청을 사용할 수 있습니다. Chat은 되지만 Agent가 실패하면 Chat에서 기본 연결을 먼저 확인한 뒤 모델 기능과 할당량을 확인하세요.
- BYOK 요청은 최종 프롬프트 구성을 위해 Cursor 백엔드를 거칩니다. Cursor는 Key를 저장하지 않는다고 설명하지만 Zero Data Retention은 BYOK에 적용되지 않습니다.
문제 해결
| 증상 | 해결 방법 |
|---|---|
| 갱신 후 모델이 보이지 않음 | Add Custom Model로 gpt-6.1-sol 직접 추가 |
404 또는 /v1/v1 경로 | Base URL은 https://api.icodeeasy.cc/v1까지만 입력 |
| Chat은 되지만 Tab이 바뀌지 않음 | 정상입니다. Cursor Tab은 BYOK를 사용하지 않습니다 |
| Claude 모델을 설정할 수 없음 | Cursor는 타사 Anthropic Base URL을 지원하지 않습니다 |
공식 참고 자료
2026-07-16에 Cursor 공식 도움말과 직원 안내를 확인했습니다.
관련 가이드
VS Code 설정
VS Code에 Codex 또는 Claude 확장을 설치하고 안전한 인증과 사용자 지정 API 주소를 설정하여 로그인 문제를 해결합니다.
Codex 설정
Codex CLI를 설치하고 auth.json에 API 키를 저장한 뒤 I Code Easy provider와 Base URL을 설정하여 첫 세션을 시작합니다.
Claude Code 설치, API 설정 및 Windows 오류 해결
Claude Code 설치, API 키와 접속 주소 설정, Windows·macOS·Linux 환경 확인부터 인증 오류와 연결 문제 해결까지 안내하고 Desktop·Kimi·GLM 설정을 연결합니다.