/terminal-setup이 동작하지 않는 이유#

Claude Code에는 /terminal-setup이라는 명령이 있습니다. VS Code 계열 터미널에서 Shift+Enter 단축키를 자동으로 잡아주는 기능입니다. 그런데 Antigravity에서 실행하면 이런 메시지가 뜹니다.

1
Terminal setup cannot be run from antigravity.

현재 /terminal-setup 자동 설정 대상은 VS Code, Cursor, Windsurf, Zed, Alacritty 정도입니다. Antigravity는 VS Code 포크 IDE지만 아직 자동 설정 대상에 포함되지 않아서, 수동 설정이 필요합니다.

핵심은 로컬 IDE 키바인딩#

여기서 짚고 넘어갈 포인트가 하나 있습니다. SSH로 원격 서버에 접속해서 Claude Code를 쓰더라도, Shift+Enter 처리는 서버가 아니라 로컬 IDE에서 먼저 잡힙니다. VS Code 계열 IDE는 키 입력을 IDE가 먼저 처리한 뒤 workbench.action.terminal.sendSequence 같은 방식으로 터미널에 시퀀스를 전달하는 구조거든요. 그래서 서버 쪽 .bashrc나 stty 설정을 아무리 바꿔도 소용이 없고, 로컬 Antigravity의 키바인딩을 건드려야 합니다.

Antigravity keybindings.json 수동 설정#

설정 절차는 다음과 같습니다.

1. Antigravity에서 Cmd+Shift+P (macOS) 또는 Ctrl+Shift+P (Linux/Windows) 실행
2. Open Keyboard Shortcuts (JSON) 검색 후 선택
3. 열린 keybindings.json 파일에 아래 항목 추가

1
{
2
  "key": "shift+enter",
3
  "command": "workbench.action.terminal.sendSequence",
4
  "args": { "text": "\u001b\r" },
5
  "when": "terminalFocus"
6
}

이미 keybindings.json에 다른 설정이 있다면, 배열 안에 쉼표를 찍고 이 객체만 추가하면 됩니다.

1
[
2
  {
3
    "key": "ctrl+l",
4
    "command": "workbench.action.terminal.clear"
5
  },
6
  {
7
    "key": "shift+enter",
8
    "command": "workbench.action.terminal.sendSequence",
9
    "args": { "text": "\u001b\r" },
10
    "when": "terminalFocus"
11
  }
12
]

추가한 뒤에는 Antigravity 창을 완전히 닫고 다시 열어야 적용됩니다. Reload Window로도 되는 경우가 있지만, 제 경험상 완전 재시작이 확실하더라고요.

기존 바인딩과 충돌하는 경우#

기존에 shift+enter를 다른 command에 바인딩해 뒀다면 새 바인딩이 제대로 동작하지 않을 수 있습니다. 이 경우 기존 항목을 지우거나 "when" 조건을 좁혀서 충돌을 피해야 합니다. 위 설정은 "when": "terminalFocus" 조건 덕분에 터미널에 포커스가 있을 때만 동작하므로, 대부분의 경우 충돌이 생기지 않습니다.

설정 전에 쓸 수 있는 임시 대안#

설정을 바꾸기 전까지 당장 여러 줄 입력이 필요하면, Claude Code가 기본 제공하는 대안을 쓸 수 있습니다.

• \ + Enter: 백슬래시를 치고 Enter를 누르면 개행으로 처리됩니다.
• Ctrl+J: 멀티라인 입력 전환 단축키로, 일부 터미널에서 바로 동작합니다.

둘 다 Claude Code 공식 문서에 나와 있는 방법입니다.

Antigravity가 /terminal-setup 대상에 포함되면 이 수동 작업이 필요 없어지겠지만, 그 전까지는 keybindings.json 항목 하나로 해결됩니다.