Cursor CLI는 두 가지 인증 방법을 지원해: 브라우저 기반 로그인(권장)과 API 키. 가장 쉬운 인증을 위해 브라우저 플로우를 사용해:
# 브라우저 플로우로 로그인
cursor-agent login

# 인증 상태 확인
cursor-agent status

# 로그아웃하고 저장된 인증 정보 삭제
cursor-agent logout
login 명령은 기본 브라우저를 열고 Cursor 계정으로 인증하라고 안내해. 완료되면 자격 증명이 로컬에 안전하게 저장돼.

API 키 인증

자동화, 스크립트, 또는 CI/CD 환경에선 API 키 인증을 써.

Step 1: API 키 생성

Cursor 대시보드의 Integrations > User API Keys에서 API 키를 생성해.

Step 2: API 키 설정

API 키는 두 가지 방식으로 설정할 수 있어: 옵션 1: 환경 변수(권장)
export CURSOR_API_KEY=your_api_key_here
cursor-agent "implement user authentication"
옵션 2: 커맨드 라인 플래그
cursor-agent --api-key your_api_key_here "implement user authentication"

인증 상태

현재 인증 상태를 확인해:
cursor-agent status
이 명령은 다음을 보여줘:
  • 인증되어 있는지
  • 계정 정보
  • 현재 엔드포인트 설정

문제 해결

  • “Not authenticated” 오류: cursor-agent login을 실행하거나 API 키가 제대로 설정됐는지 확인해
  • SSL 인증서 오류: 개발 환경에선 --insecure 플래그를 사용해
  • 엔드포인트 문제: 커스텀 API 엔드포인트를 지정하려면 --endpoint 플래그를 사용해