Claude Code 완전 정복 2편 — Mac에서 제대로 쓰기: 터미널 설정과 VS Code·데스크톱 앱·Chrome 연동

설치는 했는데 어딘가 불편하다면

Claude Code를 Mac 터미널에서 처음 쓰면 사소한 불편이 몇 가지 생깁니다. Option 키 단축키가 안 먹고, 긴 작업을 맡겨 두고 다른 창에 가 있으면 끝났는지 알 수 없고, 매번 터미널과 에디터를 오가야 합니다.

이 글은 Claude Code 시리즈 2편으로, Mac에서 Claude Code를 편하게 쓰기 위한 설정과 VS Code, 데스크톱 앱, Chrome, 휴대폰 연동 방법을 정리합니다. 설치와 첫 실행은 1편을 참고하세요.

1. 터미널부터 맞추기

Option 키 단축키 켜기

Claude Code에는 Option 키를 쓰는 단축키가 있습니다. 그런데 Mac의 터미널 앱은 대부분 기본 설정에서 Option을 수정 키로 보내지 않아서, 그대로는 아무 반응이 없습니다.

터미널	설정 위치
기본 터미널(Terminal.app)	Settings → Profiles → Keyboard → "Use Option as Meta Key" 체크 (한국어 메뉴에서도 같은 위치)
iTerm2	Settings → Profiles → Keys → General → Left/Right Option key를 "Esc+"로
VS Code 내장 터미널	설정에 "terminal.integrated.macOptionIsMeta": true 추가

기본 터미널은 Claude Code를 처음 실행할 때 나오는 터미널 설정 안내를 수락했다면 이미 적용되어 있습니다. 나중에 직접 하려면 Claude Code 안에서 /terminal-setup을 실행하면 됩니다.

설정이 끝나면 이런 단축키를 쓸 수 있습니다.

단축키	하는 일
Option+P	모델 바꾸기 (입력 중인 내용은 유지)
Option+Enter	줄바꿈

여러 줄 입력하기

긴 요청을 쓸 때 Enter를 누르면 바로 전송됩니다. 줄을 바꾸는 방법은 여러 가지입니다.

• Shift+Enter: iTerm2, Ghostty, Kitty, WezTerm, Warp, 기본 터미널에서는 설정 없이 동작합니다. VS Code, Cursor, Zed 터미널에서는 /terminal-setup을 한 번 실행해야 합니다.
• \ 입력 후 Enter: 모든 터미널에서 동작합니다.
• Ctrl+J: 설정 없이 어디서나 동작합니다.

작업이 끝나면 알림 받기

Claude가 작업을 마치거나 권한 승인을 기다릴 때 알림을 받을 수 있습니다. Ghostty, Kitty, iTerm2는 기본으로 데스크톱 알림이 옵니다. 다른 터미널에서는 직접 설정해야 합니다.

가장 간단한 방법은 ~/.claude/settings.json에 Notification 훅을 추가해서 Mac 알림을 띄우는 것입니다.

1{
2  "hooks": {
3    "Notification": [
4      {
5        "matcher": "",
6        "hooks": [
7          {
8            "type": "command",
9            "command": "osascript -e 'display notification \"Claude Code needs your attention\" with title \"Claude Code\"'"
10          }
11        ]
12      }
13    ]
14  }
15}

알림이 안 뜬다면 macOS 알림 권한 문제일 가능성이 큽니다. osascript 알림은 "스크립트 편집기(Script Editor)" 앱을 통해 나가는데, 이 앱에 알림 권한이 없으면 에러 없이 조용히 실패합니다. 터미널에서 아래 명령을 한 번 실행한 뒤, 시스템 설정 → 알림에서 스크립트 편집기를 찾아 알림을 허용하세요.

1osascript -e 'display notification "test"'

소리만 원한다면 command에 afplay /System/Library/Sounds/Glass.aiff를 넣는 방법도 있습니다.

2. Mac에서 자주 쓰는 단축키

단축키	하는 일
Esc	Claude의 작업을 중간에 멈추기 (그때까지 한 작업은 유지)
Esc 두 번 (입력창이 비었을 때)	되감기 메뉴 열기 — 이전 시점으로 코드·대화 복원
Shift+Tab	권한 모드 전환
Ctrl+V (iTerm2는 Cmd+V)	클립보드의 이미지 붙여 넣기
Ctrl+R	이전에 입력한 명령 검색
Ctrl+G	긴 프롬프트를 기본 텍스트 에디터에서 편집
Ctrl+B	실행 중인 명령을 백그라운드로 보내기
! (맨 앞에 입력)	셸 명령을 직접 실행하고 결과를 Claude에게 보여 주기
@	파일 경로 자동완성으로 특정 파일 지정
? (입력창이 비었을 때)	단축키 도움말 열기

이미지 붙여 넣기는 특히 쓸모가 많습니다. 디자인 시안이나 깨진 화면을 Cmd+Shift+Control+4로 캡처해서 클립보드에 담은 뒤 붙여 넣고 "이 화면처럼 만들어줘", "이 레이아웃이 왜 깨지는지 봐줘"라고 요청할 수 있습니다.

3. VS Code에서 쓰기

터미널이 익숙하지 않다면 VS Code 확장이 더 편할 수 있습니다. 확장 패널(Cmd+Shift+X)에서 "Claude Code"를 검색해 설치하고, 명령 팔레트(Cmd+Shift+P)에서 "Claude Code"를 입력해 Open in New Tab을 선택하면 됩니다. Cursor에서도 같은 확장을 쓸 수 있습니다.

VS Code 확장의 장점은 이렇습니다.

• 변경 내용을 에디터 안에서 diff로 바로 확인할 수 있습니다.
• 에디터에서 선택한 코드를 Claude가 자동으로 봅니다. Option+K를 누르면 @file.ts#5-10처럼 파일과 줄 번호 참조를 프롬프트에 넣어 줍니다.
• Cmd+Esc로 에디터와 Claude 입력창 사이를 오갈 수 있습니다.
• 계획(plan)을 검토하고 수정한 뒤 승인할 수 있습니다.

4. 데스크톱 앱

Claude 데스크톱 앱에는 Chat, Cowork, Code 세 개의 탭이 있고, Code 탭이 Claude Code입니다. macOS용은 Intel과 Apple Silicon 공용 버전 하나로 배포됩니다.

터미널 없이 쓸 수 있다는 것 외에도 이런 기능이 있습니다.

• 여러 세션을 나란히 띄워 병렬로 작업 (세션마다 git 격리)
• 변경 내용을 시각적인 diff로 검토
• 통합 터미널과 파일 에디터
• 정해진 시간에 반복 실행하는 예약 작업

5. Chrome과 연결하기

프론트엔드 개발자에게 가장 유용한 연동입니다. Claude in Chrome 확장을 설치하면 Claude Code가 브라우저를 직접 조작할 수 있습니다. 페이지를 열고, 클릭하고, 콘솔 로그를 읽고, 화면을 확인하는 식입니다.

1claude --chrome

실행 중인 세션에서는 /chrome으로 연결 상태를 확인하고 권한을 관리할 수 있습니다. Chrome 외에 Edge와 Brave, Arc 같은 Chromium 기반 브라우저도 지원합니다. 단, /login으로 Claude 계정에 로그인한 상태여야 하고, API 키 방식으로 인증했다면 쓸 수 없습니다.

이렇게 활용할 수 있습니다.

1localhost:3000을 열어서 로그인 폼에 잘못된 이메일을 넣고 제출해봐.
2에러 메시지가 제대로 뜨는지 확인하고, 콘솔에 에러가 있으면 원인을 찾아 고쳐줘

코드만 보고 "고쳤습니다"라고 하는 대신, 실제로 브라우저에서 동작을 확인하게 만들 수 있다는 점이 핵심입니다.

6. 휴대폰으로 이어서 하기 (Remote Control)

Mac에서 긴 작업을 걸어 두고 자리를 비워야 할 때 쓸 수 있습니다. 실행 중인 세션에서 아래 명령을 입력하면, 같은 세션을 claude.ai나 Claude 모바일 앱에서 이어서 볼 수 있습니다.

1/remote-control

줄여서 /rc도 됩니다. 처음부터 원격 제어용으로 띄우려면 터미널에서 claude remote-control을 실행합니다. 작업 자체는 계속 내 Mac에서 돌아가고, 휴대폰은 그 세션을 보고 지시하는 창 역할을 합니다. claude.ai 계정으로 로그인한 상태여야 합니다.

핵심 한 줄

Mac에서는 Option 키와 알림 설정만 해 둬도 체감이 크게 달라지고, 상황에 따라 터미널, VS Code, 데스크톱 앱을 골라 쓰면 됩니다. 프론트엔드 작업이라면 Chrome 연동으로 Claude가 직접 화면을 확인하게 하는 것을 꼭 써 보세요.

다음 편에서는 CLAUDE.md, 스킬, 서브에이전트, 훅, MCP로 Claude Code를 내 프로젝트에 맞추는 방법을 다룹니다.

참고 자료

• 터미널 설정
• 대화형 모드와 단축키
• VS Code 확장
• 데스크톱 앱
• Chrome 연동
• Remote Control