Cursor에서 ElkAPI 사용하기

​

사전 준비

1. Cursor 설치 완료
   Cursor 공식 웹사이트에서 운영 체제에 적합한 버전을 다운로드하고 설치하세요
2. ElkAPI API 키 획득
   ElkAPI 콘솔에 로그인하여 API 키(sk-로 시작)를 받으세요

​

1단계: 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 옵션 클릭

​

2.3 ElkAPI API 정보 구성

​

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

​

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

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

​

4단계: 사용 시작

​

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 콘솔에서 키가 유효한지 확인
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 호출이 실패하거나 오류를 반환하나요?

​

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

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

​

사용 팁

​

1. 컨텍스트 활용

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

​

2. 명확한 프롬프트 작성

이거 최적화

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

​

3. 반복적 개발

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

​

4. 프로젝트 표준 활용

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

​

기능

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

​

지원 및 도움말

• 📚 ElkAPI 문서
• 📧 기술 지원: support@elkapi.com