커서 AI 한글 설정: 한글 파일명·IME·가격 확인까지

커서 AI란 무엇인가#

Cursor는 코드를 읽고 수정하거나 터미널 명령을 실행할 수 있는 에이전트를 제공하는 편집기입니다. 한국어 입력 가능 여부와 메뉴가 한국어로 표시되는지는 서로 다른 문제입니다. 아래 표는 공식 문서에서 확인한 범위와 직접 점검할 항목을 구분합니다.

Plan Mode는 여러 파일에 걸치거나 조사가 필요하거나 코딩 전에 승인이 필요한 큰 변경에 쓰라고 시작 안내가 소개하는 모드입니다. Shift+Tab으로 켜면 Cursor가 코드베이스를 조사하고 질문한 뒤 구현 계획을 만들고, 승인을 기다립니다. 계획 단계라도 명령 승인 설정은 따로 확인하세요. 이 글의 승인 설명은 로컬 에이전트에 적용됩니다. 실행 모드 문서는 클라우드 에이전트가 자체 머신에서 실행되며 행동마다 승인을 요청하지 않는다고 설명하므로, 클라우드 에이전트에는 같은 기준을 그대로 적용하지 마세요.

공식 자료 확인일: 2026-11-03(보안 안내, 실행 모드, 시작 안내, 요금 페이지, 사용 한도 안내, 개인정보 처리방침과 데이터 사용 안내).

추가 검증 필요: 실제 설치 과정과 인증, 한국어 입력·IME 및 한글 파일명 처리, 첫 작업과 권한 승인·중단 결과에 대한 기록은 아직 없습니다.

설치 전 확인: 계정·권한·비용#

공식 요금 안내에서 현재 요금제와 사용 한도를 살펴보고, 회사 계정이라면 관리자 정책도 확인하세요. 연습에는 비밀키나 개인 정보가 없는 별도 폴더를 사용하세요. 파일이 자동으로 바뀔 수 있으므로 기존 작업은 백업하거나 버전 관리로 보존하는 편이 안전합니다.

요금 페이지는 2026-11-03에 확인한 내용으로 개인 요금제를 Free(월 $0, 제한된 AI 사용), Plus($8), Premium($30), Super($100), Ultra($200)로 나열합니다. Premium은 Plus보다 4배, Super는 15배, Ultra는 50배 많은 사용량을 제공한다고 적혀 있습니다. 팀 요금제는 사용자당 월 $30부터이며, 기업 요금제는 문의를 거쳐 정해집니다. 가격에는 세금과 수수료가 빠져 있고, 가격은 바뀔 수 있다고 명시되어 있습니다.

사용 한도 안내는 요금제를 두 체계로 나눕니다. The X Subscription(무료, Plus, Premium, Super, Ultra, Teams 좌석)은 매주 갱신되는 사용량 풀 하나를 쓰고, 기존 요금제(Hobby, Start, Pro, Pro+, Ultra, Teams Standard·Premium 좌석)는 월 단위로 Cursor 모델 풀과 기타 모델 풀 두 개를 씁니다. Ultra라는 이름이 두 체계에 모두 있으므로, 결제 화면에 표시된 요금제 이름이 어느 체계인지부터 확인하세요.

사용량은 The X Subscription이면 grok.com 대시보드의 Usage에서, 기존 요금제면 대시보드의 Spending 탭에서 확인합니다. 편집기 설정에서도 남은 사용량을 볼 수 있습니다. 포함 사용량은 The X Subscription에서는 주간으로, 기존 요금제에서는 결제 주기에 맞춰 초기화되며, 쓰지 않은 포함 사용량은 이월되지 않습니다. 개인 요금제에서 자신의 API 키로 보낸 요청은 포함 사용량이나 선결제 크레딧에서 차감되지 않고 제공자가 직접 청구합니다.

요금 페이지는 구독을 공식 웹사이트를 통해서만 판매한다고 밝히며, 재판매처나 제3자 판매자를 승인하지 않는다고 적습니다. 다른 경로에서 산 구독은 승인되지 않은 것일 수 있으므로, 결제 전에 공식 사이트의 요금제 화면과 대조하세요.

결제 수단으로는 주요 신용카드와 체크카드를 받습니다. 송장 결제나 송금은 기업 요금제 문의로 처리되며, 갱신 최소 24시간 전에 취소하면 추가 요금을 피할 수 있다고 요금 페이지는 적습니다.

한도에 도달하면 편집기에 알림이 나타납니다. The X Subscription 사용자는 선결제 크레딧을 계속 쓰거나, 주간 풀이 초기화되기를 기다리거나, 상위 요금제를 고를 수 있습니다. 기존 요금제 사용자는 사용량 과금을 켜거나 상위 요금제를 고를 수 있습니다. 선결제 크레딧은 주간 풀과 함께 초기화되지 않으며, 구매 뒤 365일이 지나면 만료됩니다(현재 기준). Max Mode는 현재 요금제에 포함되지 않고, 기존 요청 기반 요금제에서는 모델 API 요율에 20%를 더해 청구됩니다.

기존 요금제의 팀 좌석은 모든 구성원의 사용량이 팀 결제 주기에 맞춰 함께 초기화되며, 관리자는 관리자 대시보드에서 조직 사용량을 볼 수 있습니다. 제3자 모델은 포함 사용량에 들어가지 않으며, Premium 이상에서는 API 목록 가격으로 선결제 크레딧에서 청구됩니다.

설치와 인증#

Cursor 시작 안내에서 운영체제에 맞는 설치 방법을 확인하고, 설치 후 로그인하세요.

시작 안내는 macOS 12(Monterey) 이상과 Windows 10 이상을 설치 대상으로 적고, macOS는 .dmg, Windows는 .exe 설치 파일로 제공하며 Apple Silicon과 Intel을 모두 지원한다고 설명합니다. Linux에서는 Debian·Ubuntu의 apt 저장소를 권장하고, RHEL·Fedora는 yum 저장소를 등록한 뒤 dnf로 설치합니다. AppImage는 휴대용 방식으로 소개되며, apt와 yum 패키지가 데스크톱 아이콘, 자동 업데이트, CLI 도구를 함께 제공하므로 더 권장된다고 씁니다.

설치 후에는 폴더를 고르고 Cmd I 또는 Ctrl I로 Agent를 여세요. 시작 안내는 코드베이스 설명 요청, 작은 개선 제안, 에이전트 변경의 diff 검토, 프로젝트가 이미 쓰는 검사 실행을 순서대로 권합니다. diff 보기에는 에이전트가 만든 변경이 나타나고, 검사에는 테스트, 타입 검사, 린트, 로컬 빌드가 포함될 수 있습니다. 좋은 첫 작업으로는 문구 개선이나 작은 UI 문제 수정처럼 위험이 낮은 작업을 듭니다. 이미 바꿀 내용을 안다면 원하는 결과를 설명하며 직접 요청하라고 시작 안내는 덧붙입니다.

첫 작업: 수정하지 말라고 요청하기#

요청과 파일 내용이 모델 제공자에게 전달될 수 있습니다. 실제 코드를 사용하기 전에 Cursor 개인정보 처리방침과 데이터 사용 안내, 사용 중인 계정·조직·모델 제공자에 적용되는 보존·학습 및 데이터 처리 조건을 확인하세요.

연습 폴더에서 파일의 내용을 설명만 해 달라고 요청하고, 수정이나 명령 실행은 요청하지 마세요. 다만 이런 요청만으로 실제 읽기 전용 권한이 보장되지는 않습니다. 변경은 저장 단계 없이 디스크에 즉시 반영되므로, 예상과 다른 파일 변경이나 명령이 나타나면 작업을 멈추고 확인하세요.

데이터 사용 안내는 2026-09-03 최종 수정으로 표시되어 있습니다. 설정에서 Privacy Mode를 켜면 Cursor는 고객 데이터를 학습에 쓰지 않고, 모든 제공자와 제로 데이터 보존(ZDR) 계약을 맺으며, 모델 제공자도 데이터를 저장하거나 학습하지 않는다고 설명합니다. 다만 위험 분류기가 남용 탐지 과정에서 프롬프트를 검사할 수 있고, 탐지된 대화는 조사를 위해 저장되었다가 제공자 보존 정책에 따라 삭제될 수 있습니다. Privacy Mode를 끄면 코드베이스 데이터, 프롬프트, 편집 동작, 코드 조각을 AI 기능 개선과 모델 학습에 쓸 수 있다고 명시되어 있습니다. ZDR이 아닌 모델은 그렇다고 표시되거나 관리자가 워크스페이스에서 허용해야 쓸 수 있습니다. Privacy Mode는 설정에서 켤 수도 있고 팀 관리자가 켤 수도 있습니다.

API 키를 쓰더라도 요청은 Cursor 백엔드를 거쳐 최종 프롬프트가 만들어집니다. 파일 내용은 서버에 잠시 캐시되며, 요청 동안만 존재하는 키로 암호화되고, Privacy Mode가 켜져 있으면 학습 데이터로 쓰이지 않습니다.

민감한 파일은 .cursorignore로 에이전트 접근을 막을 수 있으며, 여기에 적힌 파일은 에이전트에서 차단됩니다. 무시 파일 안내는 Cursor가 .env 파일, .git/ 폴더, 잠금 파일을 기본으로 제외한다고 설명합니다. 다만 터미널 명령과 MCP 도구는 Cursor의 파일 접근 통제 밖에서 실행되므로 무시된 파일을 읽을 수 있습니다. 연습 폴더에는 실제 비밀 값을 두지 마세요.

Cursor는 .gitignore도 자동으로 따르며, git이 무시하는 파일은 AI 맥락에서도 제외됩니다. .cursorignore는 .gitignore가 다루지 않는 항목을 추가로 제외하는 곳입니다.

실행하지 않은 제안입니다. 연습 폴더에 가짜 값만 든 .env 파일을 만들고 .cursorignore에 그 파일을 넣은 뒤, 에이전트에게 그 파일의 내용을 말해 달라고 요청해 볼 수 있습니다. 거부되는지, 같은 내용을 터미널 명령으로 요청했을 때 승인 화면이 나오는지를 각각 기록하면 무시 설정이 어디까지 막는지 구분할 수 있습니다.

작업 공간 신뢰 기능은 기본적으로 꺼져 있습니다. 켜면 새 작업 영역마다 일반 모드와 제한 모드 중 하나를 고르게 되고, 제한 모드에서는 AI 기능이 동작하지 않습니다. 신뢰하지 않는 저장소는 기본 텍스트 편집기로 열라는 것이 보안 안내의 권고입니다. 설정 파일에서 security.workspace.trust.enabled를 true로 두면 켜지며, 조직은 MDM으로 이 설정을 강제할 수 있습니다.

보안 안내는 파일 읽기와 코드 검색에 승인이 필요 없다고 설명합니다. 실행 모드 문서는 읽기 접근의 기본값을 System으로 두어, 작업 영역 밖의 파일도 승인 없이 읽을 수 있다고 설명합니다. Cursor 3.23부터는 Workspace 모드를 고르면 작업 영역 밖 읽기에 승인이 필요하고, 읽기 허용 목록에 있는 경로만 예외가 됩니다. 설정 위치는 Settings > Agents > Approvals & Execution > Read Access이며, 허용 목록에는 절대 경로 폴더, *가 든 글롭 패턴, 홈 디렉터리 경로(~)를 넣을 수 있습니다.

권한 승인과 중단#

Cursor의 보안 안내에 따르면 작업 영역 파일은 승인 없이 수정될 수 있습니다. 다만 설정 파일(예: 워크스페이스 설정)은 이 예외에 해당하며 승인이 먼저 필요합니다. 보안 안내는 이 예시 외에 설정 파일의 전체 목록을 제시하지 않으므로, 승인을 요구받은 경로가 설정 파일처럼 보이면 승인 전에 멈추세요. 명령 실행 모드와 허용 목록에 따라 승인 동작도 달라집니다. 승인 요청이 나타나면 명령과 대상을 읽고, 이해하지 못하는 작업은 승인하지 마세요. 중단 후에도 변경된 파일을 확인하세요.

실행 모드 문서에 따르면 실행 모드는 데스크톱 앱의 Settings > Agents > Approvals & Execution에서 고릅니다. 모드는 Auto-review, Allowlist, Run Everything 세 가지입니다. Auto-review는 허용 목록 항목을 바로 실행하고, 샌드박스가 가능한 셸 명령은 샌드박스에서 돌리며, 나머지는 분류기가 검토합니다. Auto-review는 3.6 버전(2026년 5월 29일)부터 권장 기본값으로 소개됩니다. Allowlist 모드에서는 허용 목록의 동작이 승인 없이 실행되고, 샌드박스를 켜면 지원되는 셸 명령이 샌드박스에서 실행됩니다. Run Everything은 모든 도구 호출을 자동으로 실행하며 샌드박스와 분류기를 쓰지 않습니다. Ask Every Time은 3.5 버전(2026년 5월 22일)에서 폐지되어 새 사용자가 고를 수 없으며, 같은 동작은 빈 허용 목록을 둔 Allowlist로 얻을 수 있습니다.

Auto-review의 분류기는 판단하려고 로컬 머신에서 ReadFile, Grep, Glob, ListDir 같은 읽기 전용 호출을 할 수 있습니다. 분류기가 차단한 호출은 에이전트가 다른 방법을 시도하거나, 에이전트가 그래도 타당하다고 판단하면 승인 요청으로 넘어갑니다.

Auto-review 분류기는 실수할 수 있고, 보안 안내는 실행 모드를 최선의 노력에 기반한 보호 장치로 부르므로 보안 경계로 여기지 마세요. 민감한 데이터를 노출할 수 있는 행동에는 명시적 승인이 필요합니다. 자동 다시 불러오기(auto-reload)가 켜져 있으면 에이전트 변경이 검토 전에 실행될 수 있으므로, 연습 폴더에서는 이 설정부터 확인하세요.

실행 모드와 별도로 브라우저 보호, 파일 삭제 보호, 외부 파일 보호가 자동 실행을 막을 수 있습니다. 브라우저 보호는 브라우저 도구를, 파일 삭제 보호는 rm 명령을 포함한 파일 삭제를, 외부 파일 보호는 작업 영역 밖 파일의 생성·수정·삭제를 자동으로 실행하지 못하게 합니다. MCP 연결은 모두 승인이 필요하고, 연결을 승인한 뒤에도 도구 호출마다 승인을 받으며, 특정 도구만 미리 허용하려면 MCP 허용 목록을 씁니다.

샌드박스는 셸 명령이 작업 영역과 허용된 네트워크 범위 안에서만 움직이도록 제한합니다. macOS는 Seatbelt, Linux는 Landlock과 seccomp를 씁니다. 보안 안내는 기본 설정에서 에이전트가 임의의 네트워크 요청을 보낼 수 없고, 도구의 네트워크 요청은 GitHub, 직접 링크 가져오기, 웹 검색 제공자로 제한된다고 설명합니다. 샌드박스 제한 때문에 권한 오류로 실패한 명령은 에이전트가 샌드박스 밖에서 다시 실행할 수 있으며, 그 재실행도 분류기가 검토합니다. 샌드박스 네트워크 모드는 sandbox.json의 허용 목록만 쓰는 방식, 허용 목록에 Cursor 기본 목록을 더하는 방식, 모든 네트워크를 허용하는 방식 가운데 고르며, 기본값은 기본 목록을 더하는 방식입니다.

샌드박스의 기본 설정에서 워크스페이스 파일은 읽고 쓸 수 있지만, 보호 경로로 지정된 .git/config, .git/hooks, .vscode, .cursorignore와 민감한 Cursor 설정 파일은 보호됩니다. 임시 폴더 /tmp와 플랫폼 임시 디렉터리는 sandbox.json에서 끄지 않으면 쓸 수 있습니다. Auto-review 규칙은 ~/.cursor/permissions.json과 프로젝트의 .cursor/permissions.json에 적히며, 두 파일이 있으면 합쳐 적용합니다. 팀 설정이 있으면 사용자 파일과 프로젝트 파일은 무시되며, 엔터프라이즈 관리자는 팀 읽기 정책도 설정할 수 있습니다. 샌드박스 설정은 sandbox.json에 적고, 팀 관리자 정책과 Cursor의 기본 보안 규칙은 로컬 파일로 약화할 수 없습니다. 문서는 원하는 규칙을 에이전트에게 말하면 에이전트가 permissions.json을 고쳐 준다고 설명합니다.

한국어 설정과 한글 파일명#

1. 운영체제에서 한국어 입력기를 선택하고, 연습 파일에 한글 입력 확인을 입력한 뒤 저장하고 다시 열어 글자가 유지되는지 확인합니다.
2. 직접 만든 한글-연습.txt를 열고 파일명 검색을 시도합니다. 검색 결과와 실제 경로가 일치하는지 살펴보세요.
3. 에이전트 입력란에 민감한 정보가 없는 한국어 설명을 입력해 조합 중 글자와 전송 후 문장이 같은지 확인합니다. 응답 언어가 다르면 원하는 언어를 명시해 다시 요청할 수 있지만, 결과는 보장되지 않습니다.
4. 별도로 허용한 연습 파일의 주석을 바꿨다면 diff에서 한글과 변경 범위를 확인합니다. 터미널을 쓴다면 출력도 별도로 살펴보세요.

한국어 UI로 바꾸는 메뉴나 특정 언어 팩의 지원 여부는 확인하지 못했습니다. 위 절차는 독자가 자기 환경에서 확인할 수 있는 방법이지, 호환성 시험 결과가 아닙니다.

Cursor 문서 색인은 문서를 여러 언어로 제공한다고 밝히면서 cn, ru, ja, pt-BR, es만 나열합니다. 한국어는 이 목록에 없습니다. 반면 데이터 사용 안내 페이지 하단의 언어 메뉴에는 한국어가 있습니다. 메뉴 이름은 영어 원문 문서와 실제 화면을 대조해 확인하세요.

한글 파일명 검색 동작에 대한 공식 안내는 확인하지 못했습니다.

같은 지시를 반복해야 한다면 프로젝트 규칙을 쓸 수 있습니다. 규칙은 .cursor/rules 아래 .mdc 파일로 저장하며 버전 관리하고, 적용되면 규칙 내용이 모델 맥락의 앞부분에 포함된다고 규칙 문서는 설명합니다. 간단한 대안으로 AGENTS.md를 쓸 수도 있고, 팀 및 엔터프라이즈 요금제에서는 대시보드에서 팀 규칙을 관리할 수 있습니다.

자주 막히는 지점#

글자가 조합 중 깨지거나 중복되면 다른 입력란과 다른 앱에서도 같은지 비교하고 운영체제·앱·입력기 버전을 기록하세요. 파일명이 검색되지 않으면 실제 파일이 열린 폴더 안에 있는지 먼저 확인하세요. 비밀번호, 토큰, 사설 저장소 내용은 진단 요청에 포함하지 마세요.

실행 모드 문서에 따르면 Linux에서 샌드박스 조건이 맞지 않으면 Cursor는 명령을 실행하기 전에 승인을 요청하는 쪽으로 돌아갑니다. 샌드박스에는 Landlock v3를 지원하는 커널 6.2 이상과 비권한 사용자 네임스페이스가 필요합니다. 일부 배포판은 AppArmor로 사용자 네임스페이스를 제한하는데, 원격 환경과 독립 CLI에서는 이때 샌드박스 생성이 권한 오류로 실패할 수 있습니다. 이 경우 배포판에 맞는 AppArmor 패키지를 설치하라고 안내합니다. 데스크톱 설치에는 AppArmor 설정이 필요 없고, macOS에서는 Cursor 2.0 이상이면 추가 설정 없이 샌드박스를 쓸 수 있습니다.

터미널 출력이 잘리거나 어긋나면 셸 테마를 먼저 의심하고, 에디터 본문과 터미널을 나눠 확인하세요. 터미널 안내는 Cursor가 셸 명령을 사용자의 터미널에서 직접 실행하며, Powerlevel9k나 Powerlevel10k 같은 테마가 인라인 터미널 출력을 방해할 수 있다고 설명하고, 셸 설정에서 CURSOR_AGENT 환경 변수로 Cursor 실행 중임을 감지해 무거운 테마를 건너뛰게 하는 방법을 제시합니다. 이 설정은 출력 표시 문제를 줄일 뿐 한글 입력 문제를 고치지는 않습니다.

샌드박스 밖에서 실행해야 하는 명령은 Cursor가 표시하고 승인을 요청합니다. 조직 계정에서 Auto-review 항목이 회색으로 보이면 팀 설정에서 분류기에 필요한 모델이 허용되었는지 확인하고, Cursor를 완전히 종료했다가 다시 여세요.

보안 취약점을 발견하면 security-reports@cursor.com으로 세부 내용과 재현 단계를 보내라고 보안 안내는 적고 있습니다. 접수 확인은 영업일 기준 5일 안에 이뤄진다고 적혀 있습니다.

한국어 리뷰 설명의 수용 기준#

리뷰를 한국어로 받을 때도 코드 위치와 근거가 있어야 합니다. “이 부분이 위험하다”는 문장만으로는 무엇을 확인할지 알기 어렵습니다. 어떤 입력과 경로에서 어떤 결과가 생기는지 설명하고 실제 코드와 연결되는지 보세요. 코드 식별자와 오류 원문은 그대로 남기면 검색하기 쉽습니다. 업무 용어를 바꿨다면 팀에서 쓰는 의미와 같은지도 확인합니다. 자연스러운 문체가 사실의 정확성을 보증하지는 않습니다.

리뷰가 제안한 수정은 별도 변경으로 검토합니다. 리뷰를 요청했다는 사실이 자동 수정과 외부 게시까지 허용하는 것은 아닙니다. 필요한 권한과 현재 모드를 확인하고 실제 diff를 읽으세요. 지적이 맞지 않는다면 어느 조건이 다른지 근거로 설명할 수 있습니다. 결과를 전부 채택하거나 무시하기보다 요구사항과 코드에 맞는 제안을 나눠 판단하는 편이 좋습니다.

한글 설정을 바꿨다면 그 효과가 다음 작업에서 그대로 유지되는지 한 번 더 확인하는 편이 안전합니다. 화면 언어와 입력 처리는 환경마다 다를 수 있고, 설정 이름과 실제 결과가 같은 것을 가정하지는 않습니다. 설정을 바꾼 뒤의 첫 작업 결과를 기록해 두면 같은 환경에서 재현할 때 비교 기준이 됩니다.

편집 메모#

편집 메모 (2026-11-02): UI·IME·파일명·승인 조건을 나눈 FAQ와 재현 기록 표를 보충했습니다. 실제 설치·인증·한글 화면·첫 작업 증거는 여전히 없습니다.