서드파티 클라이언트
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-5.6-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-5.6-sol을 입력하고Add Custom Model을 클릭합니다. - Chat 또는 Agent에서
gpt-5.6-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-sonnet-4-6 같은 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-5.6-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 공식 도움말과 직원 안내를 확인했습니다.