Cursor CLI는 두 가지 인증 방법을 지원해: 브라우저 기반 로그인(권장)과 API 키야.

브라우저 인증 (권장)

가장 간편한 인증을 위해 브라우저 플로우를 사용해:
# 브라우저 플로우로 로그인
cursor-agent login

# 인증 상태 확인
cursor-agent status

# 로그아웃 및 저장된 인증 정보 삭제
cursor-agent logout
login 명령어를 실행하면 기본 브라우저가 열리고 Cursor 계정 인증을 요청해. 인증이 완료되면 자격 증명이 로컬에 안전하게 저장돼.

API 키 인증

자동화, 스크립트, 또는 CI/CD 환경에서는 API 키 인증을 사용해:

1단계: API 키 생성

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

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 플래그를 사용해
  • 엔드포인트 문제: --endpoint 플래그를 사용해서 커스텀 API 엔드포인트를 지정해