Cursor 터미널에서 Claude Code로 원격 서버 작업하기
Cursor의 SSH 연결 기능으로 Ubuntu 서버에 접속한 뒤, 원격 터미널에서 Claude Code를 실행해 서버의 프로젝트를 직접 분석하고 수정하는 방법입니다.
1. 전체 작업 구조
이 방식은 서버의 파일을 로컬 PC로 내려받지 않고도 원격 프로젝트를 직접 열고 작업할 수 있다는 장점이 있습니다.
2. 단계별 설정 방법
① Cursor에서 원격 서버에 SSH 접속
- Cursor를 실행합니다.
Ctrl + Shift + P를 누릅니다.Remote-SSH: Connect to Host를 선택합니다.- SSH 접속 주소를 선택하거나 입력합니다.
ssh ubuntu@서버IP처음 접속하는 서버라면 SSH 설정을 추가하고, 비밀번호 또는 SSH 키로 인증합니다. 접속에 성공하면 원격 서버에 연결된 Cursor 창이 열립니다.
② 원격 서버의 프로젝트 폴더 열기
- 원격 Cursor 창에서 File → Open Folder를 선택합니다.
- 서버에 있는 프로젝트 경로를 입력합니다.
/home/ubuntu/pyDjangoDEV/mdmproj1이제 Cursor에서 원격 서버의 Django 프로젝트 파일을 직접 열고 수정할 수 있습니다.
③ 원격 서버에 Claude Code 설치
Claude Code를 내 PC가 아니라 원격 서버에 설치합니다. Cursor의 원격 터미널에서 Terminal → New Terminal을 선택한 뒤 Node.js와 npm이 설치되어 있는지 확인합니다.
node -v
npm -v설치되어 있지 않다면 먼저 Node.js를 설치합니다. 설치가 되어 있다면 다음 명령으로 Claude Code를 설치합니다.
npm install -g @anthropic-ai/claude-code설치가 완료되면 실행합니다.
claude최초 실행 시 Claude 계정 인증 절차가 진행됩니다. 화면의 안내에 따라 로그인합니다.
④ Claude Code로 서버 프로젝트 작업하기
Claude Code가 실행된 상태에서 자연어로 작업을 요청할 수 있습니다. 예를 들면 다음과 같습니다.
현재 Django 프로젝트의 전체 구조를 분석해 줘.app_news_study 앱의 모든 뷰와 URL 연결 구조를 분석해 줘.현재 프로젝트에서 오류가 발생할 가능성이 있는 코드를 찾아서 설명해 줘.로그인 기능을 분석하고 필요한 부분을 수정해 줘.Claude Code는 현재 작업 디렉터리의 파일을 읽고, 요청에 따라 파일을 수정하거나 터미널 명령을 실행할 수 있습니다.
- 서버에서 직접 작업하므로 운영 중인 Django 프로젝트 파일도 즉시 변경될 수 있습니다.
- 작업 전에 Git으로 현재 상태를 저장하는 것이 좋습니다.
- 운영 서버에서는 서비스 재시작이나 데이터베이스 변경을 신중하게 진행해야 합니다.
- Claude Code가 실행하는 명령과 파일 수정 내용을 확인하고 승인하는 습관을 들이세요.
3. 로컬 실행 방식과 원격 실행 방식 비교
| 구분 | 로컬 Cursor + Claude Code | 원격 Cursor + Claude Code |
|---|---|---|
| Claude Code 설치 위치 | 내 PC | 원격 서버 |
| 프로젝트 파일 | 내 PC에 있는 파일 | 서버에 있는 파일 |
| 파일 수정 | 로컬 파일 수정 | 원격 파일 직접 수정 |
| 서버 명령 실행 | 별도 SSH 접속 필요 | 원격 터미널에서 직접 실행 |
| 서버 환경 분석 | 추가 접속 필요 | 현재 서버 환경에서 바로 분석 |
Ubuntu 서버에서 Django, Apache, mod_wsgi 등을 사용하고 있다면 원격 Cursor와 Claude Code를 함께 사용하는 방식이 편리할 수 있습니다. 서버의 실제 실행 환경에서 문제를 분석하고 수정할 수 있기 때문입니다.
다만 원격 터미널에서 Claude Code를 실행하는 것은 Claude Code가 Cursor의 코드 편집 기능에 내장되는 것과는 다릅니다. Claude Code는 원격 터미널에서 별도의 CLI 프로그램으로 실행됩니다.
로컬 PC의 Cursor와 Claude Code를 유지하면서 SSH로 원격 파일을 편집하는 구성도 가능합니다. 다만 Claude Code가 원격 파일을 직접 다루도록 작업 환경을 별도로 구성해야 하므로, 원격 서버 터미널에서 실행하는 방법이 일반적으로 더 단순합니다.