Cmd. /terminal-setup
Shift+Enter 등 줄바꿈 단축키를 터미널에 맞게 자동 구성하는 명령
핵심 요약
/terminal-setup은 Shift+Enter 등 멀티라인 줄바꿈 단축키를 현재 터미널에 맞는 키 바인딩으로 자동 구성합니다.- 설정이 필요한 터미널(VS Code, Cursor, Windsurf, Alacritty, Zed)에서만
/목록에 뜨는 조건부 명령입니다. - 인자·별칭이 없으며, 적용 후 터미널 재시작이 필요할 수 있습니다.
- 단축키를 직접 커스터마이즈하려면
/keybindings, Vim 등 편집 모드는/config→ Editor mode로 분리되어 있습니다.
명령어 원본 선언
/terminal-setup공식 설명 요약
/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가 잘 동작하는 환경(예: 일부 기본 터미널)에서는 / 목록에 아예 안 보이기도 합니다.
최소 지원 버전
v1.0.110이상- 공식 명령어 레퍼런스에는 별도의 최소 버전 표기가 없습니다. 위 값은 Changelog에서 확인된 등장 시점 기준이며, 환경에 따라 노출 여부가 달라질 수 있습니다.
사용법
/terminal-setup- 인자(arguments)는 받지 않습니다. 명령만 입력하면 현재 터미널을 감지해 적절한 키 바인딩을 구성합니다.
- 별칭(alias)은 없습니다.
좋은 사용 예
- 새 개발 머신 세팅 직후 한 번 실행해 줄바꿈 단축키를 맞춰 둔다
- VS Code, Cursor, Windsurf 등 IDE 내장 터미널에서 Shift+Enter가 동작하지 않을 때 실행한다
- 팀 온보딩 시 동일한 터미널 입력 환경을 갖추도록 안내한다
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/terminal-setup | 터미널에 맞는 Shift+Enter 등 키 바인딩 자동 구성 | 멀티라인 줄바꿈 단축키가 안 먹힐 때 |
/keybindings | 키 바인딩 설정 파일을 열거나 생성 | 단축키를 직접 커스터마이즈하고 싶을 때 |
/config | 설정 화면(테마·모델·Editor mode 등) 열기 (별칭 /settings) | 편집 모드(Vim 등)나 일반 환경설정을 바꿀 때 |
활용 사례
- 온보딩 초기 환경 점검 체크리스트에 포함
- IDE 내장 터미널과 외부 터미널 간 입력 동작 통일
- 멀티라인 프롬프트를 자주 쓰는 워크플로에서 줄바꿈 단축키 안정화
주의사항
- 이 명령은 설정이 필요한 터미널에서만 표시됩니다. 목록에 없다면 현재 터미널은 이미 정상 동작하는 것으로 간주된 상태입니다.
- 셸과 터미널 조합에 따라 적용 결과가 다르고, 설정 후 터미널을 재시작해야 할 때도 있습니다.
- 단축키를 더 세밀하게 바꾸려면
/keybindings로 키 바인딩 파일을 직접 편집하세요. - 참고: Vim/편집 모드 전환은
/vim명령이 v2.1.92에서 제거되었고, 이제/config→ Editor mode로 설정합니다.
출처
- Commands(공식 명령어 레퍼런스): https://code.claude.com/docs/en/commands
- Interactive mode: https://docs.claude.com/en/docs/claude-code/interactive-mode
- Changelog: https://raw.githubusercontent.com/anthropics/claude-code/refs/heads/main/CHANGELOG.md