Claude Code 줄바꿈 설정 방법: /terminal-setup으로 Shift+Enter 처음 쓰는 법
TL;DR
Claude Code의 여러 줄 입력은 터미널에 따라 시작 방법이 다릅니다. iTerm2, WezTerm, Ghostty, Kitty, Warp, Apple Terminal, Windows Terminal에서는 Shift+Enter가 별도 설정 없이 작동합니다.
VS Code, Cursor, Devin Desktop, Alacritty, Zed에서는 Claude Code 대화형 입력창에서
/terminal-setup
을 실행해 바인딩을 설치합니다. 설정을 바꾸기 어렵다면 모든 터미널에서 쓸 수 있는 백슬래시(
\
) 다음 Enter나, 별도 설정이 필요 없는 Ctrl+J를 사용합니다.
핵심 3줄 요약
Shift+Enter 기본 지원 터미널인지 먼저 확인합니다.
VS Code·Cursor·Devin Desktop·Alacritty·Zed에서는 Claude Code 안에서
/terminal-setup
을 실행합니다.비민감 테스트 문장으로 줄바꿈을 확인하고 실패하면
\
+Enter 또는 Ctrl+J를 씁니다.이 글에서 다룰 내용
Claude Code 여러 줄 입력의 한 문장 정의, 터미널별 지원 경계,
/terminal-setup
을 처음 실행하는 6단계, 복사해 쓸 검증 프롬프트, 대체 키, 주의점과 FAQ를 다룹니다.
Claude Code 줄바꿈은 무엇이고 언제 쓰면 좋은가
Claude Code 줄바꿈은 하나의 프롬프트 안에서 목표·범위·금지 조건·완료 기준을 여러 줄로 나누어 입력하는 기능입니다.
Claude Code 줄바꿈은 하나의 프롬프트 안에서 목표·범위·금지 조건·완료 기준을 여러 줄로 나누어 입력하는 기능입니다. 긴 코드 작업을 요청할 때 조건을 한 줄에 몰아쓰지 않아도 됩니다.
Anthropic 공식 interactive mode 문서는 여러 줄 입력 방법을 터미널별로 구분합니다. Shift+Enter가 기본으로 작동하는 앱이 있고
/terminal-setup
으로 바인딩을 설치해야 하는 앱도 있습니다.
/terminal-setup
은 Claude Code의 답변 스타일이나 도구 권한을 바꾸는 명령이 아닙니다.
한 줄 질문에는 굳이 설정할 필요가 없습니다. 수정 범위, 제외할 파일, 검증 명령, 사람 승인 지점을 한 프롬프트에 함께 적을 때 여러 줄 입력이 유용합니다.
시작 전에 터미널과 기능 경계를 확인합니다
운영체제 이름보다 실제로 키 입력을 받는 터미널 애플리케이션부터 확인합니다. 공식 문서는 iTerm2, WezTerm, Ghostty, Kitty, Warp, Apple Terminal, Windows Terminal에서 Shift+Enter가 설정 없이 작동한다고 안내합니다.
VS Code, Cursor, Devin Desktop, Alacritty, Zed를 쓰면
/terminal-setup
으로 바인딩을 설치합니다. 이 목록 밖의 앱이나 현재 동작이 문서와 다르면 지원을 추정하지 말고 현재 공식 문서와 Claude Code 화면의 안내를 확인합니다.
공식 출처에는 이 입력 기능의 플랜, 계정, 지역, 언어, 가격 조건이 따로 적혀 있지 않습니다. 또한
/terminal-setup
은 터미널의 여러 줄 입력 바인딩을 다루며
/keybindings
의 Claude Code 동작 키 설정, 모델 선택, 파일 접근 권한과는 별개입니다.
/terminal-setup으로 Shift+Enter를 처음 쓰는 순서
1. 현재 터미널 앱을 확인합니다
Claude Code를 어디에서 실행하는지 확인합니다. iTerm2·WezTerm·Ghostty·Kitty·Warp·Apple Terminal·Windows Terminal이라면 먼저 Shift+Enter를 시험하고 작동하면
/terminal-setup
을 실행할 필요가 없습니다.
VS Code·Cursor·Devin Desktop·Alacritty·Zed라면 다음 단계에서 바인딩을 설치합니다. 터미널 이름을 모르면 앱의 정보 화면이나 현재 창의 제품명을 확인합니다.
2. Claude Code 대화형 세션을 엽니다
작업할 폴더에서 Claude Code를 시작하고 대화형 입력창이 보이는지 확인합니다.
/terminal-setup
은 일반 셸에서 실행하는 독립 명령이 아니라 Claude Code 안에서 입력하는 슬래시 명령입니다.
첫 검증에는 실제 고객 정보나 비밀값이 없는 폴더와 문장을 사용합니다. 줄바꿈 키를 잘못 눌러 문장이 바로 제출될 가능성까지 고려한 범위입니다.
3. 필요한 터미널에서 /terminal-setup을 실행합니다
Claude Code 입력창에 다음 명령을 입력하고 Enter를 누릅니다.
/terminal-setup
화면에 표시되는 설치 안내를 읽고 현재 터미널용 바인딩을 적용합니다. 공식 문서가 설치 대상이라고 명시한 VS Code·Cursor·Devin Desktop·Alacritty·Zed에서 이 절차를 사용합니다.
4. 비민감 문장으로 Shift+Enter를 시험합니다
입력창에
목표: 테스트 문장을 여러 줄로 입력한다.
라고 쓴 뒤 Shift+Enter를 누릅니다. 문장이 제출되지 않고 새 줄이 생기는지 확인합니다.
두 번째 줄에는
제외: 실제 파일 수정과 명령 실행은 하지 않는다.
를 적습니다. 다시 Shift+Enter로 세 번째 줄을 만든 뒤
완료: 입력 모양만 확인하고 사람이 종료한다.
를 씁니다.
5. 일반 Enter와 줄바꿈 키를 구분합니다
여러 줄이 입력창에 모두 남아 있는지 확인한 다음 일반 Enter로 한 번만 제출합니다. Shift+Enter는 프롬프트 안에 새 줄을 만드는 용도이고 일반 Enter는 작성한 입력을 보내는 용도로 구분해 사용합니다.
테스트가 바로 제출됐다면 같은 민감하지 않은 문장으로 다시 확인합니다. 실제 코드 변경 요청이나 비밀값을 넣은 상태에서 키 설정을 시험하지 않습니다.
6. 실패하면 공식 대체 입력을 사용합니다
공식 문서는 백슬래시(
\
)를 입력한 다음 Enter를 누르는 방법이 모든 터미널에서 작동한다고 안내합니다. Ctrl+J도 별도 설정 없이 모든 터미널에서 쓸 수 있는 대안입니다.
macOS에서는 Option을 Meta로 설정한 뒤 Option+Enter도 사용할 수 있습니다. 설정 변경이 허용되지 않는 조직 장비나 목록 밖 터미널에서는
/terminal-setup
의 동작을 추정하기보다 이 대체 입력을 우선합니다.
그대로 복사해 쓸 검증 프롬프트
허용 입력: 아래의 비민감 테스트 문장과 현재 화면에서 확인되는 줄바꿈 동작.
제외 입력: API 키, 토큰, 비밀번호, 고객 데이터, 내부 URL, 실제 파일 내용, 실제 수정·명령 실행 요청.
출력 형식: 목표 | 제외 | 완료의 세 줄로 입력한다.
완료 기준: Shift+Enter 또는 공식 대체 키로 세 줄이 입력창에 남고 사람이 확인한 뒤 일반 Enter로 한 번만 제출한다.
추정 금지: 터미널 앱, 지원 여부, 설치 결과, 권한 상태를 화면 확인 없이 만들어 내지 않는다.
승인 지점: 바인딩 설치 안내 적용, 터미널 설정 변경, 실제 코드 요청 전송은 사람이 현재 화면을 확인하고 승인한다.
이 프롬프트는 키 동작만 확인합니다. 실제 파일 수정이나 셸 명령 실행은 완료 기준에 넣지 않습니다.
실전 활용 팁
여러 줄의 역할을 고정하면 전송 전 검토가 쉬워집니다. 첫 줄에는 목표, 둘째 줄에는 허용 범위, 셋째 줄에는 제외 범위, 마지막 줄에는 완료 기준과 승인 지점을 둡니다.
백슬래시 다음 Enter는 모든 터미널에서 작동하는 공식 방법이라 팀 문서의 공통 대안으로 적기 좋습니다. Shift+Enter는 각자의 터미널 앱을 확인한 뒤 기본 지원 또는 설치 대상 여부를 함께 기록합니다.
주의할 점
-
/terminal-setup은 VS Code·Cursor·Devin Desktop·Alacritty·Zed에서 Shift+Enter 바인딩을 설치할 때 쓰는 Claude Code 슬래시 명령입니다. - iTerm2·WezTerm·Ghostty·Kitty·Warp·Apple Terminal·Windows Terminal에서는 Shift+Enter가 별도 설정 없이 작동합니다.
- 목록 밖 터미널의 지원 여부와 설치 경로를 임의로 일반화하지 않습니다.
-
/terminal-setup과/keybindings, 모델 설정, 도구 권한은 서로 다른 기능입니다. - 키 검증 중 문장이 바로 제출될 수 있으므로 비밀값과 실제 고객 데이터를 넣지 않습니다.
- 조직 장비의 터미널 설정을 바꾸기 전에는 현재 정책과 승인 절차를 확인합니다.
자주 묻는 질문
모든 터미널에서 /terminal-setup을 먼저 실행해야 하나요?
아닙니다. 공식 문서는 iTerm2, WezTerm, Ghostty, Kitty, Warp, Apple Terminal, Windows Terminal에서 Shift+Enter가 별도 설정 없이 작동한다고 설명합니다. 먼저 Shift+Enter를 시험하고 설치 대상으로 명시된 앱에서만
/terminal-setup
을 사용합니다.
/terminal-setup은 어디에 입력하나요?
Claude Code의 대화형 입력창에 입력합니다. 일반 셸 명령이 아니라 Claude Code 슬래시 명령이므로 Claude Code 세션을 연 뒤
/terminal-setup
을 실행합니다.
Shift+Enter를 쓸 수 없으면 여러 줄 입력이 불가능한가요?
아닙니다. 백슬래시(
\
) 다음 Enter는 모든 터미널에서 작동하고 Ctrl+J도 설정 없이 쓸 수 있다고 공식 문서가 안내합니다. macOS에서는 Option을 Meta로 설정한 뒤 Option+Enter를 사용할 수도 있습니다.
/terminal-setup이 파일 권한이나 모델 동작도 바꾸나요?
공식 문서의 해당 항목은 여러 줄 입력용 Shift+Enter 바인딩 설치를 설명합니다. 파일 접근 권한, 도구 승인, 모델 설정을 바꾸는 기능으로 해석하지 않습니다.
출처
마무리
Claude Code에서 여러 줄 프롬프트를 시작할 때는 현재 터미널부터 확인합니다. 기본 지원 앱이면 Shift+Enter를 바로 시험하고 VS Code·Cursor·Devin Desktop·Alacritty·Zed에서는 Claude Code 안에서
/terminal-setup
을 실행합니다.
설치가 필요 없거나 허용되지 않는 환경에서는
\
+Enter 또는 Ctrl+J를 씁니다. 비민감 문장으로 새 줄이 입력창에 남는지 먼저 확인한 뒤 목표·범위·제외·완료 기준을 나눠 실제 요청을 작성합니다.
