AI 루트
레벨 진단
← Cursor

Cursor Composer로 다중 파일 동시 편집하기

중급약 15분4단계

Cursor의 Composer는 여러 파일을 동시에 수정하는 에이전트 모드입니다. 기능 하나를 추가하면서 관련 파일 10개를 자동으로 업데이트합니다.

따라 하기

1단계 / 4

Composer 모드 열기

  1. Cursor에서 Cmd+I(Mac) 또는 Ctrl+I(Windows)를 누르면 Composer 패널이 열립니다.
  2. ›Composer는 Chat과 달리 여러 파일을 동시에 수정할 수 있어 새 기능 추가나 리팩토링 같은 대규모 변경에 적합합니다.
Cursor 열기
한눈에 정리
# ─── Composer 단축키 ────────────────────────────
Ctrl+I       (Mac: ⌘+I)    # Composer 열기/닫기
Ctrl+Shift+I (Mac: ⌘+⇧+I) # Composer 새 세션 시작

# ─── Composer vs Chat 차이 ────────────────────────
Chat (⌘+L):
  - 1개 파일 컨텍스트
  - 질문·설명·간단 수정
  - 코드 제안 → 수동 Apply

Composer (⌘+I):
  - 다중 파일 동시 수정
  - 전체 기능 구현
  - 변경사항 자동 감지·적용
  - 에이전트가 파일 생성·삭제 가능

# ─── Agent 모드 활성화 ────────────────────────────
Composer 상단 토글 'Agent' 켜기
→ 터미널 명령어 실행 허용
→ 파일 탐색·생성·삭제 자율 수행

이해를 돕는 예시 그림이에요. 실제 화면과 다를 수 있어요.

Cursor — AI Code Editor
탐색기
my-project
index.ts
app.py
utils.py
README.md
app.py
utils.py
1
from flask import Flask, request
2
3
app = Flask(__name__)
4
# Cursor AI: JWT 인증 추가됨
5
@app.route("/api/login", methods=["POST"])
C
Cursor
Chat
Composer
이 Flask 앱에 JWT 인증을 추가해줘
적용 완료
jwt 패키지를 설치하고 /api/login 엔드포인트를 생성했어요. 토큰 만료는 24시간으로 설정했습니다.
변경 파일
app.py +12 -0
requirements.txt +1
코드 질문하기...⌘K

팁 Agent 모드는 Composer의 최상위 단계입니다. 코드 작성뿐 아니라 패키지 설치, 빌드 실행, 테스트까지 자율적으로 수행합니다.

처음이라 잘 모르겠다면

Cursor에서 Ctrl+Shift+I(Mac: Cmd+Shift+I)를 누르면 Composer 패널이 열립니다.

막히면 볼 것

자주 하는 실수 3가지
  1. 1Agent 모드에서 검토 없이 Accept All → 의도치 않은 파일 삭제 — 변경 목록을 반드시 확인 후 파일별로 선택 수락
  2. 2컨텍스트 파일 없이 막연한 요청 → 관련 파일 모르고 새 파일 생성 — @파일명으로 관련 파일을 명시적으로 지정
  3. 3Composer 작업 전 Git commit 생략 → 잘못된 변경 복원 불가 — 큰 작업 전 항상 git commit 으로 안전망 확보
AI 없이 할 때와 뭐가 다른가요?

파일마다 일일이 수정 → Composer로 전체 기능 구현 → 10개 파일 동시 변경

로그인 기능 추가하려면 auth.ts, api/login.ts, middleware.ts, types.ts, page.tsx 등 파일을 하나씩 다 열어서 수정해야 해...
나
여러 파일을 일일이 수정하면 누락이 생기기 쉽습니다.지금까지
Cursor 말고 다른 도구로 하기