Cmd. /terminal-setup
Shift+Enter 등 줄바꿈 단축키를 터미널에 맞게 자동 구성하는 명령
핵심 요약
- terminal별 multiline·clipboard 설정 지원
- 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
terminal별 multiline·clipboard 설정 지원
/terminal-setup사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 내장 명령 |
| 상태 | 현재 공식 표 |
| 별칭 | — |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-09-22 · Claude Code 2.1.278 |
설치본의 명령 메뉴와 계정·조직 설정에 따라 사용할 수 있는 항목이 달라집니다.
사용 예
/terminal-setup- 인자(arguments)는 받지 않습니다. 명령만 입력하면 현재 터미널을 감지해 적절한 키 바인딩을 구성합니다.
- 별칭(alias)은 없습니다.
선택 시점
- 새 개발 머신 세팅 직후 한 번 실행해 줄바꿈 단축키를 맞춰 둔다
- VS Code, Cursor, Windsurf 등 IDE 내장 터미널에서 Shift+Enter가 동작하지 않을 때 실행한다
- 팀 온보딩 시 동일한 터미널 입력 환경을 갖추도록 안내한다
관련 명령 선택
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/terminal-setup | 터미널에 맞는 Shift+Enter 등 키 바인딩 자동 구성 | 멀티라인 줄바꿈 단축키가 안 먹힐 때 |
/keybindings | 키 바인딩 설정 파일을 열거나 생성 | 단축키를 직접 커스터마이즈하고 싶을 때 |
/config | 설정 화면(테마·모델·Editor mode 등) 열기 (별칭 /settings) | 편집 모드(Vim 등)나 일반 환경설정을 바꿀 때 |
실행 결과와 유지 범위
터미널에 맞는 줄바꿈·클립보드 등의 입력 설정을 변경합니다.
/terminal-setup은 Shift+Enter를 비롯한 단축키를 위한 터미널 키 바인딩을 구성합니다.
공식 문서의 설명 그대로 옮기면 다음과 같습니다.
Configure terminal keybindings for Shift+Enter and other shortcuts. Only visible in terminals that need it, like VS Code, Cursor, Windsurf, Alacritty, or Zed.
기본 상태에서는 Enter가 메시지를 전송하므로, 멀티라인 입력에 쓰는 줄바꿈 단축키(Shift+Enter 등)가 터미널 설정과 충돌하거나 먹히지 않곤 합니다. 이 명령이 해당 터미널에 맞는 키 바인딩을 자동으로 적용해 줍니다.
이 명령은 조건부로만 노출됩니다. 설정이 필요한 터미널에서만 나타나죠.
공식 문서가 예로 드는 대상은 VS Code, Cursor, Windsurf, Alacritty, Zed입니다.
이미 Shift+Enter가 잘 동작하는 환경(예: 일부 기본 터미널)에서는 / 목록에 아예 안 보이기도 합니다.
주의사항
- 이 명령은 설정이 필요한 터미널에서만 표시됩니다. 목록에 없다면 현재 터미널은 이미 정상 동작하는 것으로 간주된 상태입니다.
- 셸과 터미널 조합에 따라 적용 결과가 다르고, 설정 후 터미널을 재시작해야 할 때도 있습니다.
- 단축키를 더 세밀하게 바꾸려면
/keybindings로 키 바인딩 파일을 직접 편집하세요. - 참고: Vim/편집 모드 전환은
/vim명령이 v2.1.92에서 제거되었고, 이제/config→ Editor mode로 설정합니다.
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록