메이커링크

Appearance

Cursor CLI ​

메이커링크 터미널, 원격 작업실, 메이커 스튜디오(내 AI 빌드) 에서 Cursor CLI(cursor-agent)를 쓰려면, 연결할 원격 PC에 CLI를 설치·로그인해야 합니다. 브라우저(메이커링크)에서는 원격 PC에 대신 설치할 수 없습니다.

Cursor CLI란? ​

Cursor CLI는 터미널에서 직접 AI 에이전트를 실행할 수 있는 명령줄 도구입니다. 메이커링크로 원격지 PC에 연결한 뒤, Cursor CLI를 통해 코드 생성, 검색, 리팩터링 등을 수행할 수 있습니다.

연결됨 ≠ CLI 설치됨

메이커링크 에이전트가 연결됨 상태와 Cursor CLI 설치·로그인 완료는 별개입니다. 원격 작업실 채팅은 원격 PC의 cursor-agent가 필요합니다.

원격 PC 설치 (원격 작업실 · 내 AI 빌드) ​

아래 순서는 원격 PC에서 진행합니다. 원격 작업실 채팅에 설치 가이드 카드가 뜨면 같은 내용입니다.

Windows (PowerShell) ​

1 · PowerShell 실행 정책

시작 메뉴 → Windows PowerShell 검색 → 관리자 권한으로 실행 후 아래를 입력합니다.

powershell
Set-ExecutionPolicy RemoteSigned

확인 창이 나오면 ([Y] 예(Y) [A] 모두 예(A) [N] 아니요(N)…) Y를 입력하고 Enter를 누르세요. (모두 적용하려면 A도 가능)

2 · Cursor CLI 설치

1번과 같은 PowerShell 창에서 아래 한 줄을 입력합니다.

powershell
irm 'https://cursor.com/install?win32=true' | iex

Happy coding만으로는 미완료

설치 스크립트 끝에 Happy coding 메시지만 보이고 끝나도, 반드시 다음 단계에서 버전 숫자를 확인하세요.

3 · 설치 확인

PowerShell을 새로 연 뒤(일반·관리자 모두 가능) 아래를 입력합니다. 2026.x.x 같은 버전 숫자가 출력되어야 성공입니다.

powershell
cursor-agent --version
cursor-agent status

4 · Cursor CLI 로그인

3번과 같은 PowerShell 창에서:

powershell
agent login

브라우저가 열리면 Cursor 계정으로 로그인한 뒤, 브라우저와 PowerShell 창을 모두 닫으세요.

5 · 메이커링크 에이전트 재시작

원격 PC의 메이커링크 에이전트 앱을 트레이에서 완전히 종료했다가 다시 실행합니다. PATH·로그인 상태가 반영됩니다.

6 · 원격 작업실에서 확인

브라우저 원격 작업실 채팅에서 「설치 후 다시 확인」 을 눌러 주세요.

macOS (Terminal) ​

1 · Cursor CLI 설치

원격 Mac Terminal에서:

bash
curl https://cursor.com/install -fsS | bash

또는 Cursor 앱 → Command Palette (⌘⇧P) → Install cursor command

2 · 설치 확인

Terminal을 새로 연 뒤 버전 숫자가 나오는지 확인합니다.

bash
cursor-agent --version
cursor-agent status

3 · Cursor CLI 로그인

bash
agent login

브라우저에서 Cursor 계정으로 로그인합니다.

4 · 메이커링크 에이전트 재시작

원격 Mac의 메이커링크 에이전트 앱을 종료 후 다시 실행합니다.

5 · 원격 작업실에서 확인

원격 작업실 채팅에서 「설치 후 다시 확인」 을 눌러 주세요.

터미널에서 빠른 설치 (요약) ​

원격 작업실 없이 메이커링크 터미널만 쓸 때도, 연결된 그 PC에서 아래와 같이 설치합니다.

macOS / Linux ​

bash
curl https://cursor.com/install -fsS | bash

설치가 완료되면 터미널을 재시작하거나 다음 명령어로 셸을 새로고침합니다.

bash
source ~/.bashrc   # bash 사용 시
source ~/.zshrc    # zsh 사용 시

Windows (PowerShell) ​

위 원격 PC 설치 (Windows) 와 동일합니다. Set-ExecutionPolicy RemoteSigned → irm 'https://cursor.com/install?win32=true' | iex → cursor-agent --version 확인 → agent login 순서를 권장합니다.

설치 확인

설치 후 다음으로 정상 설치를 확인합니다.

bash
cursor-agent --version
cursor-agent status

기본 사용법 ​

에이전트 실행 ​

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으로 모드를 순환할 수 있습니다.

에이전트 모드 내 단축키 ​

키설명
/modelAI 모델 변경
@파일명특정 파일을 컨텍스트로 지정
!명령어셸 명령어 직접 실행
Shift+Enter줄바꿈 입력
Ctrl+R변경사항 리뷰
Ctrl+C현재 작업 중단
Ctrl+DCLI 종료

비대화형 (헤드리스) 모드 ​

스크립트나 자동화에서 사용할 때는 -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 코딩 에이전트를 직접 조작할 수 있습니다.

활용 예시 ​

  1. 원격 서버에서 코드 수정: 서버에 Cursor CLI를 설치하고, 메이커링크로 접속하여 코드를 수정
  2. Windows PC를 원격으로 개발: Windows에 메이커링크 에이전트 + Cursor CLI를 설치하고 외부에서 접속
  3. 팀 환경에서 공유: 공용 개발 서버에 설치하여 팀원들이 브라우저로 AI 코딩

주의사항

  • Cursor CLI는 메이커링크와 별개의 제품입니다. Cursor 계정과 구독이 별도로 필요합니다.
  • Cursor CLI 사용 시 코드가 Cursor 서버로 전송될 수 있습니다. 보안 정책을 확인하세요.
  • 메이커링크의 보안 가드는 Cursor CLI 내부에서 실행되는 명령에는 적용되지 않습니다.

문제 해결 ​

설치 후 cursor-agent / agent 명령어를 찾을 수 없음 ​

셸의 PATH에 Cursor CLI 경로가 추가되지 않았을 수 있습니다.

bash
# 설치 경로 확인
which cursor-agent    # macOS/Linux
where cursor-agent    # Windows

PATH에 없다면 셸 설정 파일(.bashrc, .zshrc, PowerShell $PROFILE)에 경로를 추가하거나, 메이커링크 에이전트 앱을 재시작하세요.

Windows에서는 %LOCALAPPDATA%\cursor-agent 아래에 설치되는 경우가 많습니다.

Windows에서 실행 정책 오류 ​

PowerShell 실행 정책이 제한되어 있으면 스크립트 설치·agent 실행이 실패할 수 있습니다.

powershell
# 현재 정책 확인
Get-ExecutionPolicy

# 관리자 PowerShell에서 변경 — 확인 창에서 Y
Set-ExecutionPolicy RemoteSigned

1단계(RemoteSigned)를 먼저 완료한 뒤 2단계 설치(irm … | iex)를 입력하세요. 설치 후에도 agent login 등이 막히면 1단계를 다시 확인하세요.

원격 작업실에서 계속 «CLI 미설치»로 나올 때 ​

  1. 원격 PC에서 cursor-agent --version — 버전 숫자 출력 확인 (Happy coding만으로는 부족)
  2. agent login 완료 여부
  3. 메이커링크 에이전트 앱 재시작
  4. 원격 작업실 「설치 후 다시 확인」

참고 ​

메이커링크 - 원격 터미널 플랫폼

© 2026 메이커링크. All rights reserved.