먼저 볼 카드 — 제품 지도
개념 Surfaces
Claude Code 창구 고르기
Claude Code는 터미널·편집기 확장·데스크탑 앱·웹 네 갈래로 열립니다. 안에서 도는 엔진은 같고, 규칙 파일(CLAUDE.md)과 설정도 창구를 가리지 않고 함께 쓰입니다.
창구는 코드가 내 컴퓨터에서 도는가, 앤트로픽 클라우드에서 도는가로 갈립니다.
- 내 컴퓨터에서 도는 창구 — 터미널 CLI, 데스크탑 앱의 로컬 세션, VS Code·JetBrains 확장
- 클라우드에서 도는 창구 — 웹, 데스크탑 앱의 클라우드 세션
창구별로 되는 것
| 할 수 있나요 | 터미널 CLI | 데스크탑 앱 | 웹 |
|---|---|---|---|
| 내 컴퓨터 파일을 직접 고치기 | 됩니다 | 로컬 세션에서 됩니다 | 안 됩니다, 클라우드 복사본을 고칩니다 |
| 창을 닫아도 계속 진행 | 안 됩니다 | 클라우드 세션에서 됩니다 | 됩니다 |
| GitHub 연결이 있어야 함 | 필요 없습니다 | 클라우드 세션에만 필요합니다 | 필요합니다 |
| 다른 프로그램에 끼워 자동 실행 | 됩니다 | 안 됩니다, 대화 전용입니다 | 안 됩니다 |
| 고를 수 있는 권한 모드 | 전부 | 5개 | 3개 |
네 창구 모두 유료 구독(Pro·Max·Team·Enterprise)이나 Console 계정이 필요합니다. 무료 플랜에는 Claude Code가 없습니다.
모바일은 조금 다릅니다
폰의 Claude 앱은 코드가 도는 자리가 아니라 작업을 여는 창입니다. 클라우드 세션을 시작하고 진행을 보고 방향을 바꾸거나, 내 컴퓨터에서 돌고 있는 작업을 원격 조종합니다. 폰 안에서 코드가 실행되지는 않습니다.
터미널과 데스크탑 앱은 무엇이 다른가요
데스크탑 앱에서 로컬 세션을 고르면 터미널과 같은 폴더의 같은 파일을 고칩니다. 능력 차이가 아니라 보는 방식 차이입니다.
이미지와 PDF도 양쪽에서 읽을 수 있습니다. 터미널에서는 파일을 끌어다 놓거나 붙여넣거나 경로를 적고, 앱에서는 첨부 버튼을 누릅니다.
| 다른 것 | 터미널 CLI | 데스크탑 앱 로컬 세션 |
|---|---|---|
| 바뀐 내용 검토 | 터미널 안에 글자로 나옵니다 | 화면 diff에서 줄마다 코멘트를 답니다 |
| 만든 화면 확인 | 브라우저를 직접 엽니다 | 앱 안 브라우저 창에서 바로 봅니다 |
| 여러 작업 동시에 | 터미널 창을 여러 개 엽니다 | 사이드바 탭으로 열고 작업 폴더가 자동 분리됩니다 |
| 정해둔 시각에 반복 | 별도 도구를 붙입니다 | 예약 작업 기능이 들어 있습니다 |
다른 프로그램에 끼워 자동 실행하는 건 위 표대로 터미널만 됩니다. 터미널에만 더 있는 것은 권한 모드 전체와 세션끼리 메시지를 주고받는 방식입니다. 둘 다 처음 배우는 단계에서는 쓰지 않습니다.
하던 작업 옮기기
- 터미널에서 데스크탑 앱으로 — 채팅창에
/desktop을 입력하면 대화가 그대로 앱에서 열립니다. - 웹에서 터미널로 — 터미널에서
claude --teleport를 실행하면 클라우드에서 하던 작업을 내 컴퓨터로 가져옵니다. 저장하지 않은 변경이 없어야 하고, 같은 저장소여야 합니다. - 터미널에서 웹으로는 바로 옮길 수 없습니다.
claude --cloud는 새 클라우드 작업을 시작하는 명령이고, 하던 대화를 그대로 웹으로 보내는 것은 데스크탑 앱에서만 됩니다.
지금 하려는 일 하나를 정해서, 아래 실습으로 어느 창구가 맞는지 직접 물어보세요.
직접 해보기
지금 이 대화는 어느 창구에서 돌고 있어? 코드가 내 컴퓨터에서 실행되는지 클라우드에서 실행되는지, 내 폴더의 파일을 직접 고칠 수 있는지 3줄로 알려 줘.
대괄호 안은 실제 값으로 바꿔서 붙여넣습니다.
내가 자주 하는 일은 [한 줄로 설명]이야. 이 일을 터미널 CLI·데스크탑 앱·웹 중 어디서 하는 게 맞는지, 이유를 한 줄씩 붙여 추천해 줘.
지금 하던 작업을 다른 창구로 옮기려면 어떤 명령이나 절차가 필요한지, 옮길 수 없는 조건이 있다면 그것도 함께 알려 줘.
지금 쓰는 창구에서 위 프롬프트를 실행하고, 답이 아래 표와 맞는지 대조해 보세요.
헷갈리기 쉬운 것
웹에서 여는 클라우드 세션은 GitHub에 올라간 내용만 받아 갑니다. 내 컴퓨터에만 있는 설정(개인 계정 폴더의 규칙 파일, `claude mcp add`로 붙인 연결)은 따라가지 않습니다. 클라우드에서도 쓰려면 그 설정을 저장소 안에 넣고 커밋합니다. 데스크탑 앱은 로컬 세션이어도 터미널 설정을 전부 물려받지 않아서, 터미널에서 되던 명령이 앱에서 "그런 명령 없음"으로 실패할 수 있습니다. 이때는 앱의 환경 설정에 직접 넣습니다.
용어 풀이
전체 용어집 →- 클라우드 세션
- 내 컴퓨터가 아니라 앤트로픽이 관리하는 서버에서 도는 작업입니다. 창을 닫아도 계속 진행됩니다.
- 원격 조종
- 내 컴퓨터에서 돌고 있는 작업을 폰이나 다른 기기에서 조작하는 기능입니다. 일은 여전히 내 컴퓨터에서 합니다.
- diff
- 고치기 전과 후를 나란히 놓고 바뀐 줄만 보여주는 화면입니다.
- Console 계정
- claude.ai 개인 구독과 별도로 API 사용량과 요금을 관리하는 Anthropic Console의 계정입니다.
2026-07-25 기준 · 출처 · Overview, Platforms and integrations, Desktop application, Use Claude Code on the web, Claude Code on mobile, Common workflows — Work with images, Feature availability