Cursor

​

빠른 설정

​

1. 설정 열기

​

2. API 설정

• OpenAI API Key: APIYI 키를 입력합니다(기본 token을 직접 사용할 수 있습니다)
• Override OpenAI Base URL: 체크한 뒤 https://api.apiyi.com/v1를 입력합니다
• Verify를 클릭하여 구성을 검증합니다

​

3. 모델 설정

​

권장 모델 설정

• claude-sonnet-4-20250514 - Claude 4 Sonnet, 프로그래밍에 가장 강함
• gpt-4.1 - 속도가 빠르고 전반적 성능이 뛰어남
• deepseek-v3 - 중국어 프로그래밍에 뛰어나고 가성비가 높음

• gpt-4.1-mini - 가볍지만 성능이 충분함
• claude-3-haiku - Claude 시리즈에서 가장 저렴함
• gemini-2.5-flash - Google의 빠른 응답 모델

• o4-mini - 프로그래밍 작업용 첫 번째 선택 추론 모델
• o3 - 복잡한 추론과 알고리즘 문제

​

사용자 지정 모델 추가

claude-sonnet-4-20250514
gpt-4.1
deepseek-v3
o4-mini
gemini-2.5-pro

​

사용 모드 설명

​

채팅 모드 워크플로

1. 대화로 코드 생성
   • Ctrl/Cmd + L를 사용하여 채팅을 엽니다
   • 요구 사항을 설명하고 AI가 코드를 생성하도록 합니다
   • 생성된 코드 스니펫을 확인합니다
2. 코드를 수동으로 적용
   • 채팅 창에서 코드를 복사합니다
   • 대상 파일에 붙여넣습니다
   • 또는 “Apply” 버튼을 사용합니다(사용 가능한 경우)
3. 반복 및 최적화
   • 대화를 계속 이어가며 수정을 요청합니다
   • 적용 과정을 반복합니다

​

대안 비교

​

핵심 기능

​

스마트 코드 완성

• Tab Completion: Tab을 눌러 AI 제안을 수락합니다
• Multi-line Completion: 함수 수준의 코드 생성을 지원합니다
• Context Aware: 프로젝트 구조를 기반으로 제안을 제공합니다

​

AI 대화

• Ctrl/Cmd + K: 명령 팔레트를 엽니다
• Ctrl/Cmd + L: 사이드바 대화를 엽니다
• Code Explanation: 코드를 선택하고 AI에 질문합니다

​

코드 편집

• Generate Code: 요구 사항을 설명하면 AI가 자동으로 생성합니다
• Refactoring Suggestions: 최적화 권장 사항을 받습니다
• Error Fixing: AI가 오류를 찾고 수정하는 데 도움을 줍니다

​

키보드 단축키

​

사용 팁

​

1. 명확한 컨텍스트 제공

// @context: React component for user authentication
// @requirements: Need to support OAuth2 login
// @constraints: Compatible with NextJS 13+

// AI will generate more accurate code based on this information

​

2. 프롬프트 최적화

// Bad prompt
"Fix this function"

// Good prompt
"Fix floating point precision issue in calculateTotal function, ensure amount calculation accurate to 2 decimal places"

​

3. Chat 모드 최대 활용

• AI가 전체 파일 내용을 생성하도록 할 수 있습니다
• AI에 상세한 수정 지침을 제공해 달라고 요청할 수 있습니다
• 코드 리뷰와 리팩터링 제안을 위해 AI를 사용할 수 있습니다

​

문제 해결

​

연결 시간 초과

1. 네트워크 연결을 확인합니다
2. API 주소를 확인합니다: https://api.apiyi.com/v1
3. API 키 유효성을 확인합니다

​

모델이 응답하지 않음

1. 계정 잔액을 확인합니다
2. 다른 모델로 전환해 봅니다
3. Cursor를 다시 시작합니다

​

코드 제안 품질이 낮음

1. 더 많은 프로젝트 컨텍스트를 제공합니다
2. 더 구체적인 prompt를 사용합니다
3. 다른 모델을 시도해 봅니다

​

모범 사례

​

프로젝트 수준 설정

{
  "model": "gpt-4.1",
  "temperature": 0.7,
  "contextFiles": ["README.md", "package.json"],
  "rules": [
    "Use TypeScript strict mode",
    "Follow ESLint standards",
    "Add appropriate comments"
  ]
}

​

코드 표준

• TypeScript를 사용합니다
• Airbnb 표준을 따릅니다
• JSDoc 주석을 추가합니다
• 함수형 스타일을 사용합니다

​

보안 인식

• 코드에 민감한 정보를 포함하지 않습니다
• AI가 생성한 코드를 검토합니다
• 서드파티 종속성의 보안을 확인합니다

​

통합 워크플로

​

Git 통합

# AI generates commit message
git add .
# Use Cursor AI to generate descriptive commit message

​

테스트 주도 개발

1. 테스트 케이스를 먼저 작성합니다
2. AI가 구현 코드를 생성하도록 합니다
3. 테스트를 실행하여 검증합니다
4. 반복하면서 최적화합니다

​

코드 리뷰

Please review this code, focusing on:
1. Performance issues
2. Security vulnerabilities
3. Code standards
4. Best practices

​

Agent 모드가 필요하신가요?