메인 콘텐츠로 건너뛰기
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 "사용자 인증 구현"
옵션 2: 커맨드라인 플래그
cursor-agent --api-key your_api_key_here "사용자 인증을 구현해줘"

인증 상태

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

문제 해결

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