Cursor CLI
메이커링크 터미널에서 Cursor CLI를 설치하고 사용하는 방법을 안내합니다.
Cursor CLI란?
Cursor CLI는 터미널에서 직접 AI 에이전트를 실행할 수 있는 명령줄 도구입니다. 메이커링크 터미널로 원격지 PC에 연결한 뒤, Cursor CLI를 통해 코드 생성, 검색, 리팩터링 등을 수행할 수 있습니다.
설치
macOS / Linux
bash
curl https://cursor.com/install -fsS | bash설치가 완료되면 터미널을 재시작하거나 다음 명령어로 셸을 새로고침합니다.
bash
source ~/.bashrc # bash 사용 시
source ~/.zshrc # zsh 사용 시Windows (PowerShell)
PowerShell을 열고 다음 명령어를 실행합니다.
powershell
irm 'https://cursor.com/install?win32=true' | iex설치 확인
설치 후 다음 명령어로 정상 설치를 확인합니다.
bash
agent --version기본 사용법
에이전트 실행
bash
agent대화형 에이전트 모드로 진입하여 자연어로 요청을 입력할 수 있습니다.
프롬프트를 직접 지정하여 실행할 수도 있습니다.
bash
agent chat "버그를 찾아서 수정해줘"주요 명령어
| 명령어 | 설명 |
|---|---|
agent | 대화형 에이전트 시작 |
agent chat "프롬프트" | 프롬프트 지정 실행 |
agent -p "프롬프트" | 비대화형(헤드리스) 모드 |
agent -p --force "프롬프트" | 파일 수정 허용 헤드리스 모드 |
agent --version | 버전 확인 |
agent --help | 도움말 표시 |
모드 전환
| 모드 | 플래그 / 명령 | 설명 |
|---|---|---|
| Agent | 기본 | 코드 수정 가능 |
| Plan | --mode=plan 또는 /plan | 계획만 제시, 수정 안 함 |
| Ask | --mode=ask 또는 /ask | 질문/답변만 |
Shift+Tab으로 모드를 순환할 수 있습니다.
에이전트 모드 내 단축키
| 키 | 설명 |
|---|---|
/model | AI 모델 변경 |
@파일명 | 특정 파일을 컨텍스트로 지정 |
!명령어 | 셸 명령어 직접 실행 |
Shift+Enter | 줄바꿈 입력 |
Ctrl+R | 변경사항 리뷰 |
Ctrl+C | 현재 작업 중단 |
Ctrl+D | CLI 종료 |
비대화형 (헤드리스) 모드
스크립트나 자동화에서 사용할 때는 -p (print) 플래그를 사용합니다.
bash
agent -p "이 코드를 분석해줘"실제 파일 수정을 허용하려면 --force를 추가합니다.
bash
agent -p --force "ES6+ 스타일로 리팩터링해줘"API 키 인증이 필요한 환경에서는 환경변수로 설정합니다.
bash
export CURSOR_API_KEY=your_api_key_here메이커링크에서 활용하기
메이커링크 터미널은 원격지 PC의 실제 셸에 연결되므로, Cursor CLI를 설치하면 브라우저에서 원격지의 AI 코딩 에이전트를 직접 조작할 수 있습니다.
활용 예시
- 원격 서버에서 코드 수정: 서버에 Cursor CLI를 설치하고, 메이커링크로 접속하여 코드를 수정
- Windows PC를 원격으로 개발: Windows에 메이커링크 에이전트 + Cursor CLI를 설치하고 외부에서 접속
- 팀 환경에서 공유: 공용 개발 서버에 설치하여 팀원들이 브라우저로 AI 코딩
주의사항
- Cursor CLI는 메이커링크와 별개의 제품입니다. Cursor 계정과 구독이 별도로 필요합니다.
- Cursor CLI 사용 시 코드가 Cursor 서버로 전송될 수 있습니다. 보안 정책을 확인하세요.
- 메이커링크의 보안 가드는 Cursor CLI 내부에서 실행되는 명령에는 적용되지 않습니다.
문제 해결
설치 후 agent 명령어를 찾을 수 없음
셸의 PATH에 Cursor CLI 경로가 추가되지 않았을 수 있습니다.
bash
# 설치 경로 확인
which agent # macOS/Linux
where agent # WindowsPATH에 없다면 셸 설정 파일(.bashrc, .zshrc, PowerShell $PROFILE)에 경로를 추가하세요.
Windows에서 실행 정책 오류
PowerShell 실행 정책이 제한되어 있으면 스크립트 설치가 실패할 수 있습니다.
powershell
# 현재 정책 확인
Get-ExecutionPolicy
# 필요 시 변경 (관리자 권한 필요)
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser