> ## Documentation Index
> Fetch the complete documentation index at: https://docs.elkapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor에서 ElkAPI 사용하기

> Cursor AI 코드 편집기에서 ElkAPI API 서비스를 구성하고 사용하는 방법에 대한 자세한 가이드입니다. 이 가이드는 Cursor에서 ElkAPI API를 구성하여 코드 개발용 풍부한 AI 모델 리소스에 액세스하는 방법을 안내합니다.

## 사전 준비

시작하기 전에 다음을 확인하세요:

1. **Cursor 설치 완료**\
   [Cursor 공식 웹사이트](https://cursor.sh/)에서 운영 체제에 적합한 버전을 다운로드하고 설치하세요

2. **ElkAPI API 키 획득**\
   [ElkAPI 콘솔](https://api.elkapi.com/keys)에 로그인하여 API 키(`sk-`로 시작)를 받으세요

<Note>
  **팁:** ElkAPI 계정이 없는 경우 먼저 [ElkAPI](https://api.elkapi.com)에서 등록하고 API 키를 받으세요.
</Note>

## 1단계: Cursor 설정 열기

Cursor를 실행한 후 설정 페이지로 이동합니다:

1. 오른쪽 상단의 **⚙️ 설정** 아이콘(톱니바퀴 아이콘)을 클릭
2. 또는 키보드 단축키 사용:
   * Windows/Linux: `Ctrl+Shift+J`
   * macOS: `Cmd+Shift+J`

## 2단계: 모델 설정 구성

### 2.1 모델 설정 액세스

설정 페이지에서:

1. 왼쪽 메뉴에서 **Models** 옵션 찾기
2. 클릭하여 모델 설정 페이지로 이동

### 2.2 OpenAI API Key 선택

모델 설정 페이지에서:

1. **OpenAI API Key** 구성 영역 찾기
2. **Add new** 또는 **Override OpenAI Base URL** 옵션 클릭

<Note>
  **중요:** Cursor는 OpenAI 호환 API를 지원하므로 ElkAPI를 사용자 정의 API 공급자로 구성할 수 있습니다.
</Note>

### 2.3 ElkAPI API 정보 구성

다음 구성 입력:

| 필드           | 값                                |
| ------------ | -------------------------------- |
| **API Key**  | ElkAPI API 키 (`sk-xxxxxxxxxxxx`) |
| **Base URL** | `https://api.elkapi.com/v1`      |

<Note>
  **중요:**

  * Base URL에는 `/v1` 접미사가 포함되어야 합니다: `https://api.elkapi.com/v1`
  * API 키는 ElkAPI 콘솔에서 받은 `sk-`로 시작하는 키여야 합니다
  * 구성 후 Cursor는 ElkAPI의 모델을 사용하여 코드 완성 및 채팅을 수행합니다
</Note>

## 3단계: 사용할 모델 선택

### 3.1 모델 선택

모델 설정에서 사용할 모델을 선택할 수 있습니다:

**사용 가능한 모델 유형:**

* **GPT-4/5 시리즈** - 복잡한 코드 생성 및 문제 해결에 적합
  * `gpt-5.5` - 최신 GPT-5 모델
  * `gpt-5.5` - GPT-5.5 모델
  * `gpt-5.4-mini` - 더 빠르고 경제적인 버전

* **Claude 시리즈** - 코드 이해 및 리팩토링에 적합
  * `claude-sonnet-4-6` - Claude Sonnet 4.6
  * `claude-sonnet-4-6` - Claude Opus 4.7

* **기타 모델**
  * `gemini-3.1-flash-lite-preview` - Google Gemini 3.1 Flash Lite

<Tip>
  **추천 모델:**

  * 💰 **코드 완성(가성비):** `gpt-5.4-mini`
  * 🚀 **복잡한 작업(고성능):** `gpt-5.5`, `gpt-5.5-pro`, `claude-sonnet-4-6`
  * ⚡ **빠른 응답:** `gpt-5.4-mini`, `gemini-3.1-flash-lite-preview`
</Tip>

### 3.2 특정 기능에 대한 모델 구성

Cursor를 사용하면 기능마다 다른 모델을 구성할 수 있습니다:

* **Chat** - AI와 대화하는 데 사용
* **Autocomplete** - 코드 자동 완성 제안에 사용
* **Cmd+K (빠른 편집)** - 빠른 코드 편집 및 생성에 사용

필요에 따라 각 기능에 가장 적합한 모델을 선택할 수 있습니다.

## 4단계: 사용 시작

구성 완료 후 Cursor의 AI 기능 사용을 시작할 수 있습니다:

### 4.1 AI 채팅 (Cmd+L / Ctrl+L)

1. `Cmd+L`(macOS) 또는 `Ctrl+L`(Windows/Linux)을 눌러 AI 채팅 패널 열기
2. 질문이나 요청 입력, 예:
   * "퀵소트 알고리즘을 구현하는 방법은?"
   * "이 코드의 성능을 최적화해 주세요"
   * "이 함수가 어떻게 작동하는지 설명해 주세요"

### 4.2 코드 완성

1. 편집기에서 정상적으로 코드 작성
2. Cursor가 자동으로 코드 완성 제안 제공
3. `Tab` 키를 눌러 제안 수락

### 4.3 빠른 편집 (Cmd+K / Ctrl+K)

1. 편집하려는 코드 선택
2. `Cmd+K`(macOS) 또는 `Ctrl+K`(Windows/Linux) 누르기
3. 편집 지침 입력, 예:
   * "오류 처리 추가"
   * "이 함수 리팩토링"
   * "타입 주석 추가"

### 4.4 코드 설명

1. 이해하고 싶은 코드 선택
2. 마우스 오른쪽 버튼을 클릭하고 "Explain with AI" 선택 또는 단축키 사용
3. AI가 코드의 기능과 논리를 자세히 설명합니다

## 자주 묻는 질문

### Q1: ElkAPI 서비스에 연결할 수 없나요?

**해결 방법:**

1. **Base URL 확인**:
   * Base URL이 `https://api.elkapi.com/v1`인지 확인(`/v1` 접미사 주의)
   * 추가 경로를 생략하거나 추가하지 마세요

2. **API Key 확인**:
   * API Key가 올바르고 `sk-`로 시작하는지 확인
   * [ElkAPI 콘솔](https://api.elkapi.com/keys)에서 키가 유효한지 확인

3. **네트워크 연결 확인**:
   * `https://api.elkapi.com`에 액세스할 수 있는지 확인
   * 중국에 있는 경우 프록시 구성이 필요할 수 있습니다

### Q2: AI 응답이 느린가요?

**해결 방법:**

1. **더 빠른 모델로 전환**:
   * `gpt-5.5` 대신 `gpt-5.4-mini` 사용
   * 더 빠른 응답을 위해 `gemini-3.1-flash-lite-preview` 사용

2. **컨텍스트 길이 줄이기**:
   * AI로 전송되는 코드 컨텍스트 제한
   * 더 정확한 질문 설명 사용

3. **네트워크 상태 확인**:
   * 네트워크 지연 테스트
   * 연결 최적화를 위해 프록시 사용 고려

### Q3: API 호출이 실패하거나 오류를 반환하나요?

**일반적인 오류 및 해결 방법:**

| 오류 메시지                      | 원인                   | 해결 방법                    |
| --------------------------- | -------------------- | ------------------------ |
| `401 Unauthorized`          | 유효하지 않거나 만료된 API Key | API Key를 다시 받아 구성 업데이트   |
| `429 Too Many Requests`     | 요청 속도 제한 초과          | 잠시 기다렸다가 재시도 또는 플랜 업그레이드 |
| `500 Internal Server Error` | 임시 서버 문제             | 몇 분 기다렸다가 재시도            |
| `insufficient_quota`        | 계정 잔액 부족             | 콘솔에서 충전                  |

### Q4: API 사용량 및 비용을 어떻게 확인하나요?

[ElkAPI 콘솔](https://api.elkapi.com)에 로그인하여 확인:

* 📊 API 호출 통계
* 💰 비용 세부 정보
* 📈 사용 추세 차트
* 🔍 상세한 요청 로그

## 사용 팁

### 1. 컨텍스트 활용

Cursor는 관련 코드 컨텍스트를 자동으로 포함합니다. 가능한 작업:

* 관련 파일을 열어 AI가 프로젝트 구조를 이해하도록 함
* `@filename`을 사용하여 특정 파일 참조
* `@folder`를 사용하여 전체 폴더 참조

### 2. 명확한 프롬프트 작성

좋은 프롬프트는 더 나은 결과를 가져옵니다:

**❌ 나쁜 프롬프트:**

```
이거 최적화
```

**✅ 좋은 프롬프트:**

```
이 함수의 성능을 최적화해 주세요. 중점:
1. 루프 중첩 줄이기
2. 더 효율적인 데이터 구조 사용
3. 캐싱 메커니즘 추가
```

### 3. 반복적 개발

AI와 협업할 때:

1. 간단한 요구사항부터 시작
2. 점진적으로 개선 및 최적화
3. 즉시 테스트 및 검증
4. 결과에 따라 프롬프트 조정

### 4. 프로젝트 표준 활용

`.cursorrules` 파일을 생성하여 정의:

* 코드 스타일 가이드라인
* 명명 규칙
* 아키텍처 패턴
* 테스트 요구사항

## 기능

Cursor + ElkAPI를 사용하면 다음을 수행할 수 있습니다:

* 💬 **지능형 채팅** - 언제든지 프로그래밍 질문을 하고 상세한 답변 받기
* ⚡ **코드 완성** - 실시간 지능형 코드 제안 및 완성
* ✏️ **빠른 편집** - 자연어를 통해 코드를 빠르게 수정
* 🔍 **코드 이해** - 복잡한 코드의 작동 방식을 깊이 이해
* 🐛 **디버깅 도우미** - 코드 버그를 찾고 수정하는 데 도움
* 📝 **문서 생성** - 코드 주석 및 문서 자동 생성
* 🔄 **코드 리팩토링** - 지능적으로 리팩토링하고 코드 구조 최적화
* 🧪 **테스트 생성** - 단위 테스트 및 테스트 케이스 자동 생성

## 지원 및 도움말

문제가 발생한 경우:

* 📚 [ElkAPI 문서](https://docs.elkapi.com)
* 📧 기술 지원: [support@elkapi.com](mailto:support@elkapi.com)

***

<Card title="ElkAPI 시작하기" icon="rocket" href="https://api.elkapi.com">
  지금 ElkAPI에 등록하고 API 키를 받아 프로그래밍 효율을 높이세요!
</Card>