클로드 코드, 터미널 vs 데스크톱 앱: 뭐로 시작해야 할까

클로드 코드가 처음이고 터미널이 낯설다면 데스크톱 앱의 Code 탭으로 시작해도 됩니다. 바뀐 코드와 실행 화면을 한 창에서 확인할 수 있습니다. 다른 프로그램에서 Claude를 호출하거나 결과를 파일로 받아 반복 처리하려면 CLI가 맞습니다.

이 글은 Claude 앱의 일반 Chat과 터미널을 비교하는 글이 아닙니다. 같은 Claude Code를 쓰는 두 화면, 데스크톱 Code 탭과 CLI의 차이를 비교합니다. 데스크톱에도 예약 작업이 있으므로 “자동화는 전부 CLI만 된다”고 구분하면 정확하지 않습니다.

터미널은 글자로 명령을 입력하는 창이고, CLI는 명령줄에서 프로그램을 사용하는 방식입니다. 아래 실제 사용 화면과 비교표에서 내 작업에 필요한 쪽을 고르면 됩니다.

터미널과 데스크톱 앱은 같은 클로드 코드

터미널과 데스크톱 앱은 다른 제품이 아니라 같은 클로드 코드입니다. 한쪽에서 익힌 사용법이 다른 쪽에서도 통합니다.

데스크톱 앱은 Chat(대화), Cowork(에이전트 작업), Code(개발) 세 개 탭으로 되어 있고, 이 중 Code 탭이 클로드 코드입니다. 터미널과 같은 기본 엔진을 사용하며, 개인 Pro·Max 구독으로 두 방식을 이용할 수 있습니다. 로컬 프로젝트에서는 설정 파일과 CLAUDE.md를 함께 읽습니다. 설정 파일은 “내 프로젝트에서는 이런 규칙으로 일해달라”고 클로드에게 미리 적어두는 메모입니다.

다른 것은 화면에서 보여주는 방식입니다. 터미널은 글자로만 보여주고, 데스크톱 앱은 변경 내역·미리보기·파일을 패널로 나눠 보여줍니다. 아래가 데스크톱 앱의 Code 탭입니다.

한눈에 보는 비교표

용어 두 개만 먼저 알아두면 됩니다. diff는 클로드가 어떤 줄을 지우고 어떤 줄을 넣었는지 보여주는 변경 내역이고, SSH는 멀리 있는 서버 컴퓨터에 인터넷으로 접속해 조작하는 방법입니다.

항목	터미널(CLI)	데스크톱 앱 (Code 탭)
설치	명령어 한 줄	설치 파일 다운로드 (맥/윈도우)
시작 장벽	터미널에 익숙해야 함	일반 앱과 같음
코드 변경 확인	텍스트 diff	diff 뷰어 + 줄별 댓글
결과물 확인	브라우저 따로 열기	내장 Browser 패널로 미리보기
여러 작업 동시에	터미널 창 여러 개 (수동)	세션 사이드바로 병렬 실행
외부 스크립트에서 호출	claude -p로 입력·출력 연결	CLI의 비대화형 실행을 대신하는 기능은 없음
정해진 시각에 반복 작업	스케줄러와 CLI를 연결하거나 예약 기능 사용	예약 작업 지원. 로컬 작업은 앱 실행·컴퓨터가 깨어 있는 조건 필요
서버 원격 작업	SSH로 자연스러움	SSH 연결 기능 내장
참고 자료 양	많음	상대적으로 적음

데스크톱 앱이 좋은 지점 3가지

데스크톱 앱은 코드 변경과 미리보기, 여러 세션을 한 창에서 확인하기 편합니다. 다음 세 가지가 화면으로 작업할 때의 장점입니다.

1. diff 뷰어와 줄별 댓글: 클로드가 바꾼 코드를 파일별로 보면서, 마음에 안 드는 줄을 클릭해 댓글을 달면 클로드가 그 부분만 다시 고칩니다. 코드 리뷰를 화면에서 하는 셈입니다.
2. 앱 미리보기: 클로드가 개발 서버를 직접 켜고, 내장 브라우저에서 결과를 보여줍니다. 개발 서버는 만드는 중인 웹사이트를 내 컴퓨터에서만 띄워보는 프로그램입니다. 스크린샷을 찍어 자기가 만든 화면을 스스로 검증하고 고치기도 합니다.
3. 병렬 세션: 사이드바에서 세션(클로드와 주고받는 대화 한 묶음)을 여러 개 띄워 서로 다른 작업을 동시에 시킬 수 있습니다. Git 저장소에서는 worktree를 이용해 작업 사본을 분리할 수 있습니다. 같은 파일에 두 세션이 동시에 쓰지 않는지도 확인해야 합니다. Git은 파일이 바뀐 내역을 버전으로 저장하는 도구입니다.

코드를 읽지 못하는 사람에게는 1번과 2번이 특히 큽니다. 터미널에서는 무엇이 바뀌었는지를 글자로 읽어야 하지만, 데스크톱 앱에서는 화면으로 보고 클릭으로 의견을 남길 수 있으니까요.

터미널이 좋은 지점 3가지

터미널을 쓰면 클로드에게 시키는 일을 자동으로 반복하게 만들고, 내 컴퓨터가 아닌 서버에서도 똑같이 쓸 수 있습니다. 아래가 터미널에서 클로드 코드를 실행한 화면입니다.

1. 외부 프로그램과 연결: 명령어 한 줄(claude -p "질문")로 클로드를 부를 수 있습니다. 스크립트에서 입력을 전달하고 결과를 받아 다음 작업에 쓰려면 CLI가 맞습니다. 매일 같은 일을 예약하는 것이 목적이라면 데스크톱의 예약 기능부터 확인해도 됩니다.
2. 가벼운 실행: 원격 서버에 SSH로 접속해서도 그대로 쓸 수 있습니다.
3. 풍부한 참고 자료: 클로드 코드 팁과 튜토리얼 대부분이 터미널 기준으로 쓰여 있어서, 막혔을 때 찾을 자료가 많습니다.

뭘로 시작할지 정하는 상황별 추천

자기 상황에 맞는 줄을 찾으면 바로 고를 수 있습니다.

1. 코딩이 처음인 비개발자 → 데스크톱 앱. 터미널 장벽 없이 시작하고, 바뀐 코드를 눈으로 확인할 수 있습니다.
2. 웹사이트·앱을 만들며 화면을 계속 확인하고 싶은 사람 → 데스크톱 앱. 미리보기 패널이 작업 흐름을 크게 줄여줍니다.
3. 반복 업무 자동화가 목표인 사람 → 외부 스크립트와 연결할 때는 CLI. 정해진 시간에 반복하는 작업은 데스크톱의 예약 기능도 확인할 수 있습니다.
4. 둘 다 궁금한 사람 → 같은 계정·같은 요금제로 둘 다 쓸 수 있으니 병행해도 됩니다. 설정 파일도 공유됩니다.

클로드 코드 CLI와 데스크톱, 설정과 대화도 공유되나요?

같은 로컬 프로젝트의 설정과 대화 이력은 구분해야 합니다. 프로젝트의 CLAUDE.md와 공통 설정 파일을 읽더라도 두 화면의 세션 이력은 별개입니다. 같은 폴더를 열었다고 방금 하던 대화가 자동으로 이어지는 것은 아닙니다.

진행 중인 CLI 세션을 데스크톱으로 옮기려면 터미널의 클로드 대화 안에서 /desktop을 입력합니다. 세션을 저장해 앱에서 열고 CLI는 종료됩니다. 공식 문서상 macOS·x64 Windows의 Claude 구독 로그인에서 지원하며, API 키 인증에는 제공되지 않습니다.

MCP 연결도 확인할 부분이 있습니다. MCP는 클로드에 외부 도구를 연결하는 방식입니다. 데스크톱의 로컬 Code 세션은 claude_desktop_config.json에 적은 연결도 읽지만, 별도로 실행하는 CLI는 이 파일을 읽지 않습니다. 앱에서 쓰던 도구가 CLI에 없다면 공식 MCP 설정 공유 안내를 확인하세요.

처음부터 두 환경을 똑같이 꾸밀 필요는 없습니다. 지금 편한 화면에서 한 가지 작업을 끝내고, 옮겨야 할 이유가 생겼을 때 프로젝트 폴더·대화·외부 도구 연결을 확인하면 됩니다.

흔한 질문 정리

정리

1. 터미널과 데스크톱 앱은 같은 클로드 코드입니다. 같은 기본 엔진을 사용하며, 로컬 프로젝트 설정을 함께 사용할 수 있습니다.
2. 데스크톱 앱은 diff 뷰어, 앱 미리보기, 병렬 세션으로 눈으로 확인하는 작업에 강합니다.
3. 터미널은 자동화(claude -p), 원격 서버, 풍부한 참고 자료가 강점입니다.
4. 처음 코딩한다면 데스크톱 앱으로 시작해도 됩니다. 외부 스크립트와 연결할 때 CLI를 선택하고, 반복 예약만 필요하면 앱의 예약 기능도 살펴보세요.
5. 같은 개인 구독으로 두 화면을 사용할 수 있습니다. API 키를 사용하거나 추가 사용량을 켠 경우에는 별도 과금 조건을 확인하세요.

터미널 쪽으로 시작하고 싶다면 클로드 코드 맥 설치 방법 글에 설치부터 첫 실행까지 정리해뒀습니다. 개발에 좀 더 집중하고 싶다면 커서 대신 VS Code에 클로드 코드 세팅하기도 참고해보세요.

두 방식 중 어느 쪽을 쓰고 계신가요? 갈아탄 경험이 있다면 댓글로 이유를 알려주세요.

---

참고 자료: – Claude Code 공식 문서 – Desktop 애플리케이션 – Claude Code 공식 빠른 시작 문서

설치부터 기본 설정과 첫 결과물까지 이어서 보려면 클로드 코드 시작 가이드에서 다음 단계를 고르세요.

선택한 다음 무엇을 하면 되나요?

• 앱으로 시작하기: 데스크톱 설치와 첫 Code 세션
• 터미널로 시작하기: 맥 설치와 첫 실행. 실행되지 않으면 설치 오류 확인 순서
• 설정이 끝났다면: 체크리스트 앱을 만들고 수정하는 첫 실습

검증 기준

• 마지막 업데이트일: 2026-09-08
• 확인 환경: 9월 7일 확인한 macOS CLI 2.1.263과 기존 직접 캡처 2장을 유지했습니다. 9월 8일에는 공식 영문 문서로 설정·세션·MCP 공유 범위와 예약 조건을 재확인했습니다. /desktop 전환, 속도 비교, 예약 작업을 이번에 새로 실행한 것은 아닙니다.
• 주요 근거: 데스크톱과 CLI 비교 · 데스크톱 예약 작업 · 인증 방식