한눈에 보기
- 이 글에서 터미널도 VS Code 도 없이, 클로드 데스크톱 앱의 코드(Code) 탭에서 클로드 코드를 쓰는 방법을 처음부터 옮겼어요. 폴더 고르기, 고친 곳 보기, 줄 댓글, 세션 여러 개와 worktree, 터미널 버전과 오가기까지예요.
- 순서 앱을 깔고 로그인 → 위쪽 가운데 Code 탭 → Local 과 Select folder 로 폴더 고르기 → 모드를 Manual 로 두고 요청 → 바뀔 줄을 보고 Accept 나 Reject.
- 주의 코드 탭은 유료 구독(Pro·Max·Team·Enterprise)에서 돼요. 세션마다 복사본을 나누는 worktree 옵션은 Git 저장소에서만 쓰고, 윈도우에서는 Git for Windows 가 있어야 해요.
- 읽는 법 “처음이라면”만 따라 해도 첫 요청까지 가요. “익숙해졌다면”은 매일 쓸 때, “더 깊이”는 여러 일을 나란히 돌리거나 터미널 버전과 함께 쓸 때 보면 돼요.
이 글 순서
클로드 코드를 써 보고 싶은데 까만 터미널 창부터 막막한 분이 많아요. 명령을 외워야 할 것 같고, 무엇이 바뀌었는지 눈으로 보기도 어렵고요. 클로드 데스크톱 앱의 코드 탭은 그 클로드 코드를 마우스로 누르는 창으로 바꿔 줘요. 공식 문서도 첫 줄에 “터미널을 사용하지 않고도” 폴더 속 코드를 맡기고 고친 곳을 검토할 수 있다고 적었어요.
클로드 코드 공식 문서의 데스크톱 시작하기(desktop-quickstart)·데스크톱 앱(desktop)·worktree 문서를 2026년 10월 8일에 읽고 옮겼어요. 캡처는 한국어 문서 화면이고, 메뉴 이름과 버전 번호는 영어 문서와 맞춰 봤어요. 터미널 그림은 이 PC 에서 같은 날 돌린 버전 확인·도움말 출력과, 빈 연습 폴더에서 돌린 git 명령이에요. 데스크톱 앱 화면은 캡처하지 않았어요. 그래서 버튼 이름은 문서에 적힌 영어 그대로 옮기고, 문서에 없는 것은 “미확인”으로 적었어요.
코드 탭이 뭔가요
클로드 코드는 내가 말로 요청한 일을 Claude 라는 AI 가 대신 하는 프로그램이에요. 내 컴퓨터의 폴더를 열어 파일을 읽고, 고치고, 필요하면 명령을 돌려요. 원래는 터미널(마우스 대신 글자로 컴퓨터에 일을 시키는 까만 창)에서 쓰는 프로그램이라 CLI(Command Line Interface, 글자로 주고받는 화면)라고도 불러요.
클로드 데스크톱 앱은 claude.ai 를 윈도우·맥 프로그램으로 깐 거예요. 문서는 이 앱에 탭이 셋 있다고 적었어요.
| 탭 | 하는 일 | 내 파일 |
|---|---|---|
| Chat | claude.ai 처럼 묻고 답하기 | 못 봄 |
| Cowork | 내가 딴 일을 하는 동안 혼자 일을 끝내 둠 | 연결한 폴더 |
| Code | 폴더 속 파일을 같이 고치는 클로드 코드 | 고른 폴더를 바로 |
출처: 클로드 코드 문서 desktop-quickstart, Cowork 의 폴더는 Claude 도움말. 10월 8일 확인.
이 글은 Code 탭만 다뤄요. 다만 앤트로픽이 2026년 9월 16일에 Cowork 와 대화를 “하나의 Claude”로 합친다고 알렸고, 요금제마다 몇 주에 걸쳐 바뀐다고 했어요(PC 앱 설치 글에 적어 둠). 그래서 앱 위쪽 탭 생김새는 계정마다 문서와 다를 수 있어요. 지금 화면은 확인하지 못했어요(미확인).
코드 탭에서 할 수 있는 일은 개발에만 한정되지 않아요. 이런 요청도 돼요.
- 비개발자: “이 폴더의 CSV 파일 세 개를 하나로 합쳐 줘”, “사진 파일 이름을 찍은 날짜 순으로 바꿔 줘”, “이 안내문 글에서 맞춤법 틀린 곳만 고쳐 줘”
- 초급 개발자: “이 오류 메시지가 왜 나는지 봐 줘”, “TODO 주석 하나를 찾아 고쳐 줘”, “main 함수에 테스트 코드를 더해 줘”
처음이라면: 준비물
준비물은 셋이에요.
- 유료 클로드 구독. 문서는 클로드 코드에 Pro, Max, Team, Enterprise 구독이 필요하다고 적었어요. 무료 계정으로 Code 탭을 누르면 업그레이드하라는 안내가 뜬다고 해요. 요금제 고르는 법은 클로드 Pro Max 차이 글에 있어요.
- 윈도우 10 이상 PC 나 맥. 윈도우는 x64(보통 PC)용과 ARM64(ARM 칩 PC)용 설치 파일이 따로 있어요. 리눅스는 베타 버전이에요.
- 연습용 폴더 하나. 문서는 “잘 알고 있는 작은 프로젝트부터” 시작하라고 권해요. 중요한 폴더라면 통째로 복사해 둔 사본으로 시작하세요.
Node.js(자바스크립트 프로그램을 돌리는 런타임)나 터미널용 클로드 코드는 깔지 않아도 돼요. 앱 안에 클로드 코드가 들어 있다고 문서에 적혀 있어요. Git(파일이 바뀐 기록을 남기는 프로그램)도 처음에는 없어도 돼요. 뒤에 나오는 worktree 를 쓸 때만 필요해요.
앱 깔고 코드 탭 열기
- claude.com/download 에서 윈도우용 설치 파일을 받아 실행해요. 자세한 설치 화면과 받는 방법 세 가지는 PC 앱 설치 글에 있어요.
- 시작 메뉴에서 Claude 를 열고, 쓰던 클로드 계정으로 로그인해요.
- 위쪽 가운데의 Code 탭을 눌러요.
Code 탭을 눌렀을 때 나오는 안내에 따라 할 일이 달라요.
| 이런 안내가 나오면 | 할 일 |
|---|---|
| 업그레이드하라는 안내 | 유료 요금제부터 구독 |
| 온라인으로 로그인하라는 안내 | 로그인을 마치고 앱을 다시 켜기 |
| 403 오류 | 아래 “막힐 때”의 순서대로 |
출처: 클로드 코드 문서 desktop-quickstart. 10월 8일 확인.
첫 세션 시작하기
세션은 클로드와 나누는 대화 하나예요. 세션마다 자기 대화 기록과 자기 폴더를 따로 가져요. 첫 메시지를 보내기 전에 입력 칸 주변에서 네 가지를 골라요.
- 환경은 Local. 내 컴퓨터의 파일을 그대로 써요. 문서에는 Cloud(앱을 닫아도 앤트로픽 서버에서 계속 도는 세션), SSH(다른 컴퓨터에 접속해 쓰는 세션), WSL(윈도우 안의 리눅스) 도 있지만 처음에는 Local 이면 돼요.
- Select folder 로 폴더 고르기. 클로드는 고른 폴더 안을 읽고 고쳐요. 폴더(디렉토리)는 파일을 담는 서랍이고, 그 위치를 적은 글자를 경로라고 불러요. 예를 들면 C:\Users\사용자이름\Documents\연습폴더 같은 형식이에요.
- 모델 고르기. 보내기 버튼 옆 목록에서 골라요. 모델은 대답하는 AI 의 종류예요. 일하는 중에도 같은 자리에서 바꿀 수 있어요.
- 권한 모드 고르기. 클로드가 묻지 않고 해도 되는 범위예요. 처음에는 Manual 을 권해요. 이유는 바로 아래에 있어요.
그다음 할 일을 쓰고 Enter 를 눌러요. 문서가 든 예시는 “Find a TODO comment and fix it”, “Create a CLAUDE.md with instructions for this codebase” 같은 영어 문장인데, 한국어로 써도 돼요. “이 폴더에 무엇이 들어 있는지 먼저 설명해 줘”처럼 읽기만 하는 요청으로 시작하면 마음이 편해요.
고친 곳 보고 고르기
요청을 보낸 뒤 무슨 일이 생기는지는 보내기 버튼 옆에 보이는 권한 모드에 따라 달라요.
- Manual: 고치기 전에 바뀔 줄을 보여 주고 기다려요. 이 화면을 diff(바뀌기 전과 뒤를 나란히 비교한 화면)라고 불러요. Accept 를 눌러야 파일이 바뀌고, Reject 를 누르면 Claude 가 대신 어떻게 할지 물어요.
- Auto 나 Accept edits: 묻지 않고 파일을 고친 뒤
+12 -1같은 표시를 띄워요. 12줄을 더하고 1줄을 뺐다는 뜻이고, 누르면 비교 화면이 열려요.
처음에는 Manual 이 좋은 이유가 여기 있어요. 내가 고르기 전에는 아무 파일도 안 바뀌니까요. 모드는 언제든 보내기 버튼 옆 모드 표시에서 바꿔요. 모드 다섯 가지는 아래 “익숙해졌다면”에서 표로 다뤄요. VS Code 확장에서 같은 일을 하는 법은 VS Code 확장 글에 있어요.
익숙해졌다면: 바로잡기
클로드가 엉뚱한 쪽으로 가고 있으면 끝날 때까지 기다리지 않아도 돼요.
- 바로 멈추기: 멈춤 버튼을 누르거나 Esc.
- 멈추지 않고 요청 추가하기: 입력 칸에 “그 파일 말고 2024 폴더 것만”처럼 쓰고 Enter. 지금 하던 동작 하나가 끝나면 그 말을 읽고 다음 단계를 바꾼다고 적혀 있어요.
- 파일 가리키기: 입력 칸에
@를 치고 파일 이름을 이어 쓰면 그 파일을 대화에 넣어요. 이름을 다 안 쳐도 고를 수 있게 목록이 떠요(자동 완성). Cloud·WSL 세션에서는 안 돼요. - 그림·PDF 붙이기: 입력 칸 옆 첨부 버튼이나 드래그 앤 드롭. 오류가 뜬 화면 캡처를 붙이면 말로 설명하는 것보다 빨라요.
답이 끝나면 빈 입력 칸에 다음 요청이 회색 글자로 떠 있을 때가 있어요. Tab 이나 오른쪽 화살표로 수락하고 고쳐 써서 보내면 돼요. 이 제안을 만드는 데도 짧은 요청이 따로 나가서 사용량에 잡힌다고 문서에 적혀 있어요. 끄려면 Settings 의 Claude Code 에서 Sessions 아래 Prompt suggestions 예요.
권한 모드는 다섯 가지예요.
| 모드 | 묻지 않고 하는 것 | 이럴 때 |
|---|---|---|
| Manual | 없음, 고치기·명령 전마다 물음 | 처음 쓸 때 |
| Accept edits | 파일 고치기와 mkdir·touch·mv 같은 파일 명령 | 수정을 믿고 빨리 돌릴 때 |
| Plan | 읽고 살펴보기만, 소스는 안 고침 | 큰 일을 맡기기 전 |
| Auto | 거의 다, 위험한 동작은 뒤에서 걸러 냄 | 목록에 보일 때만 |
| Bypass permissions | 거의 다, 묻지 않음 | 따로 떼어 둔 테스트 환경에서만 |
출처: 클로드 코드 문서 desktop. 10월 8일 확인.
몇 가지 더 적혀 있어요. 고른 모드는 폴더마다 기억되고, Plan 만 그 세션에만 걸려요. 예전 버전의 Code 탭은 같은 모드를 Ask permissions, Auto accept edits, Plan mode 라고 불렀어요. Auto 는 고른 모델이 Opus 4.6·Sonnet 4.6 이상이거나 Haiku 5.5, Fable 모델일 때 목록에 나와요. Bypass permissions 는 Pro·Max 라면 Settings → Claude Code 의 “Allow bypass permissions mode”를 켜야 보이는데, 문서도 따로 떼어 둔 컨테이너나 가상 컴퓨터에서만 쓰라고 해요. 터미널 버전의 Shift+Tab 으로 모드를 돌리는 키는 데스크톱에서는 안 되고, 모드 메뉴는 Ctrl+Shift+M 으로 열어요. 모드마다 무엇을 막는지는 권한 설정 글, auto 모드 글, plan 모드 글에 있어요.
문서는 이름 표기도 둘로 섞여 있어요. 한국어 문서의 기능 비교 표는 같은 모드를 “수동, 편집 수락, 계획 및 자동”으로 옮겼고, 나머지 부분은 Manual 처럼 영어로 적었어요. 앱이 한국어로 나올 때 어느 이름이 보이는지는 확인하지 못했어요(미확인).
줄 댓글과 코드 검토
데스크톱 앱에만 있는 편한 점이 비교 화면 속 줄 댓글이에요.
+12 -1표시를 눌러 비교 화면을 열어요. 왼쪽에 바뀐 파일 목록, 오른쪽에 파일마다 바뀐 줄이 나와요.- 마음에 걸리는 줄을 누르면 댓글 칸이 열려요. “여기는 금액에 쉼표를 넣어 줘”처럼 쓰고 Enter.
- 여러 줄에 댓글을 다 달았으면 Ctrl+Enter 로 한 번에 보내요(맥은 Cmd+Enter).
- Claude 가 댓글을 읽고 고친 결과가 새 비교 화면으로 다시 나와요.
Claude 에게 스스로 검토를 시킬 수도 있어요. 입력 칸에 /code-review 를 치면 검토가 끝난 뒤 파일별로 묶인 Code review 카드가 떠요. Walk through in diff 를 누르면 지적 하나하나를 비교 화면에서 그 줄과 함께 보여 주고, 줄마다 Fix this one 으로 그것만 고치게 할 수 있어요. 남은 지적을 한꺼번에 고치려면 Apply fixes 예요. 이 카드는 Local·SSH·WSL 세션에서 나온다고 적혀 있어요.
창 배치와 단축키
코드 탭은 대화, 비교(diff), 브라우저, 터미널, 파일 같은 창(패널)을 원하는 자리로 드래그해 놓는 구조예요. 창 머리를 잡고 끌면 옮겨지고, 가장자리를 끌면 크기가 바뀌어요. 세션 제목 줄의 Terminal·Changes·Browser 를 누르면 그 창이 열려요. 이 배치·터미널·파일 편집 기능은 데스크톱 앱 1.2581.0 버전부터라서, 안 보이면 Help → Check for Updates 로 앱을 올려요.
- 터미널 창(Ctrl+`): 세션의 폴더에서 열리고 Claude 와 같은 환경을 써요. 터미널이 낯설어도 Claude 가 돌린 명령을 내가 다시 쳐 보는 정도로 쓰면 돼요.
- 파일 창: 대화나 비교 화면 속 파일 경로를 누르면 열려요. 간단히 고치고 Save. HTML·PDF·그림·영상은 브라우저 창에서 열려요.
- 경로 오른쪽 클릭: Attach as context(다음 요청에 첨부), Open in(VS Code 같은 편집기로), Show in Explorer(윈도우 탐색기로), Copy path.
- 보기 모드(Ctrl+O): Normal → Thinking(Claude 의 생각 글까지) → Verbose(모든 단계). Claude 가 왜 그렇게 했는지 궁금할 때 Verbose 로 봐요.
문서 단축키 표를 윈도우 키로 바꾸면 이래요. 문서는 윈도우에서 Cmd 자리에 Ctrl 을 쓰라고 적었어요.
| 키 | 하는 일 |
|---|---|
| Ctrl+/ | 단축키 전부 보기 |
| Ctrl+N · Ctrl+W | 새 세션 · 세션 닫기 |
| Ctrl+Tab · Ctrl+Shift+Tab | 다음·이전 세션 |
| Esc | Claude 의 대답 멈추기 |
| Ctrl+Shift+D · Ctrl+` | 비교 창 · 터미널 창 열고 닫기 |
| Ctrl+; | 사이드 채팅 열기 |
| Ctrl+Shift+M · Ctrl+Shift+I | 권한 모드 메뉴 · 모델 메뉴 |
출처: 클로드 코드 문서 desktop 의 Keyboard shortcuts. 10월 8일 확인.
모델 고르는 칸 옆의 고리 모양 표시를 누르면 이 세션이 컨텍스트 윈도우를 얼마나 썼는지와 요금제 사용량이 나와요. 요금제 사용량은 터미널 버전·VS Code 확장과 같이 깎여요. 사용량을 읽는 법은 사용량 확인 글에 있어요.
옆 질문과 세션 이름
일을 맡겨 둔 채로 “그런데 이 함수는 뭐 하는 거야?”처럼 딴 질문을 하고 싶을 때가 있어요. 그대로 물으면 그 질문이 메인 대화에 섞여요. 이럴 때 쓰는 게 사이드 채팅이에요.
- Ctrl+; 를 누르거나 입력 칸에
/btw를 쳐서 열어요. - 사이드 채팅은 그때까지의 메인 대화를 다 읽고 답하지만, 메인 대화에는 아무것도 추가하지 않아요.
- 앱을 닫으면 사이드 채팅은 사라져요. 디스크에 저장하지 않는다고 적혀 있어요.
세션이 여럿 쌓이면 이름을 붙여 두세요. 열린 세션 위쪽 도구 줄의 세션 제목을 누르면 이름을 바꿀 수 있어요. 대화가 길어져 컨텍스트 윈도우가 차면 Claude 가 알아서 앞 대화를 줄여(요약해) 이어 가고, 그 전에 줄이고 싶으면 /compact 를 쳐요. 줄이기·지우기·되돌리기 차이는 compact·clear·rewind 글에 있어요. 보고 있지 않은 세션이 일을 끝내면 윈도우 알림이 와요.
더 깊이: 세션 여러 개
코드 탭에서는 세션 여러 개를 동시에 돌릴 수 있어요. 한 세션에 보고서 표를 맡기고, 다른 세션에 사진 이름 바꾸기를 맡기는 식이에요.
- 왼쪽 사이드바의 + New session 이나 Ctrl+N 으로 새 세션을 열어요.
- Ctrl+Tab·Ctrl+Shift+Tab 으로 세션 사이를 오가요.
- 두 세션을 나란히 보려면 Ctrl 을 누른 채 사이드바의 세션을 눌러요. 포커스된 창을 닫으려면 Ctrl+\ 예요.
문제는 두 세션이 같은 폴더의 같은 파일을 고칠 때예요. 한쪽이 고친 걸 다른 쪽이 모르고 덮어쓸 수 있어요. 그래서 문서는 Git 저장소(Git 으로 기록을 남기는 폴더)라면 브랜치(같은 폴더 안에서 따로 쌓는 기록 줄기) 이름 옆의 worktree 옵션을 고르라고 해요. 그러면 그 세션은 따로 떨어진 복사본에서 일하고, 커밋(바뀐 것을 기록으로 남기기)하기 전까지 다른 세션에 영향을 주지 않아요.
문서가 적은 worktree 규칙은 이래요.
| 무엇 | 문서 내용 |
|---|---|
| 고를 수 있을 때 | Git 저장소일 때, 브랜치 이름 옆 |
| 두는 곳 | 프로젝트 안 .claude\worktrees\ (Settings 의 Worktree location 에서 바꿈) |
| 브랜치 이름 | 앞에 붙일 말(접두사)을 설정에서 정함 |
| 다 쓰면 | 사이드바 세션 위 보관(archive) 아이콘 → worktree 지움 |
| .env 같은 파일 | .worktreeinclude 파일에 적어야 따라옴 |
출처: 클로드 코드 문서 desktop, worktrees. 10월 8일 확인.
조심할 점이 있어요. 보관 아이콘을 누르면 worktree 가 지워지는데, 그때 커밋하지 않은 변경 사항이 어떻게 되는지는 데스크톱 문서에 적혀 있지 않아요(미확인). 터미널 버전은 나갈 때 남길지 지울지 묻는다고 worktree 문서에 적혀 있지만, 데스크톱도 그렇게 묻는지는 문서에 없어요. 남기고 싶은 변경 사항은 보관 전에 커밋해 두세요. 풀 리퀘스트(내 변경 사항을 합쳐 달라는 요청)가 합쳐지거나 닫히면 세션을 자동으로 보관하는 설정 Auto-archive after PR merge or close 도 있어요.
비개발자가 그냥 만든 폴더라면 보통 Git 저장소가 아니라서 이 옵션이 안 보일 수 있어요. 그럴 때는 세션마다 다른 폴더를 고르는 게 가장 쉬워요. Git 저장소로 만들고 싶다면 Claude 에게 “이 폴더를 git 저장소로 만들고 지금 파일을 첫 기록으로 남겨 줘”라고 요청해도 돼요.
worktree 가 뭔가요
worktree 는 Git 의 기능 이름이에요. 한 저장소에서 작업 폴더를 하나 더 꺼내, 두 폴더가 같은 기록을 같이 쓰게 하는 거예요. 책 한 권을 두 사람이 고칠 때 원본은 하나 두고 각자 복사본에 고친 다음, 고친 내용만 원본 기록에 합치는 것과 비슷해요. 데스크톱 앱이 이걸 대신 만들어 주니 명령을 칠 일은 없지만, 속에서 무슨 일이 생기는지 보려고 빈 연습 폴더에서 git 명령으로 직접 만들어 봤어요.
파일 하나(장부.csv)만 든 연습 저장소에서 돌렸어요. 클로드 코드가 만든 worktree 가 아니고, try-a 라는 이름도 제가 붙였어요. 데스크톱 앱이 실제로 붙이는 브랜치 이름은 문서에 없어서 확인하지 못했어요.
git worktree add .claude/worktrees/try-a -b try-a.claude\worktrees\try-a 폴더에 복사본을 하나 꺼내고, try-a 라는 새 브랜치를 달아요.
git worktree list지금 있는 작업 폴더를 보여 줘요. 원래 폴더(main)와 복사본(try-a) 두 줄이 나왔고, 복사본 안에도 장부.csv 가 그대로 있었어요.
git worktree remove .claude/worktrees/try-a복사본 폴더를 지워요. 그 뒤 git branch -D try-a 로 브랜치까지 지우니 목록에 원래 폴더 한 줄만 남았어요.
터미널 버전 클로드 코드에서는 claude --worktree 이름(줄여서 -w)으로 같은 일을 해요. 문서에 따르면 터미널 버전은 .claude/worktrees/이름 폴더에 worktree-이름 브랜치를 만들어요. 문서는 .claude/worktrees/ 를 .gitignore(Git 이 무시할 파일 목록)에 넣어, 원래 폴더에서 복사본 파일이 “새 파일”로 인식되지 않게 하라고도 권해요.
터미널 버전과 오가기
터미널 버전 클로드 코드를 이미 쓰고 있다면 둘을 같이 써도 돼요. 문서는 데스크톱이 같은 엔진을 그림 화면으로 돌리는 것이고, 한 컴퓨터의 같은 프로젝트에서 둘을 동시에 돌려도 된다고 적었어요. 세션 목록은 따로 갖고, CLAUDE.md(프로젝트 지침 파일)와 설정은 같이 읽어요.
| 하고 싶은 것 | 어디서 | 어떻게 |
|---|---|---|
| 터미널 대화를 앱으로 옮기기 | 터미널 버전 안 | /desktop |
| 터미널에서 앱 바로 열기 | PowerShell | claude --desktop |
| 지난 터미널 대화를 앱에서 열기 | PowerShell | claude --desktop --resume 세션ID |
| 앱에서 터미널 대화 이어 하기 | 앱 입력 칸 | /resume |
출처: 클로드 코드 문서 desktop 의 Coming from the CLI. 10월 8일 확인.
claude --desktop --resume 세션ID지난 터미널 대화를 데스크톱 앱에서 열어요. 세션ID 는 터미널 버전에서 /status 를 치면 나와요. 세션 이름은 ID 대신 쓸 수 없다고 적혀 있어요.
조건이 몇 가지 있어요. /desktop 과 claude --desktop 은 맥과 x64 윈도우에서, 클로드 구독으로 로그인했을 때만 돼요. API 키(프로그램끼리 쓰는 비밀 문자열)로 로그인했다면 안 돼요. claude --desktop 은 클로드 코드 2.1.285 버전부터예요. 다른 터미널에 열려 있거나 뒤에서 아직 돌고 있는 세션은 옮기지 않아요. 앱에서 /resume 으로 이어 가려면 먼저 터미널에서 그 세션을 닫아야 하고, 그러면 복사본이 아니라 같은 세션이 이어져서 나중에 터미널의 claude --resume 에서도 다시 보여요. 터미널 버전에서 대화 이어 하기·이름 붙이기는 클로드 코드 사용법 글에 있어요.
이 PC 의 터미널 버전(2.1.292)에서 claude --help 를 돌려 보면 --desktop 옵션이 “터미널 대신 클로드 데스크톱 앱에서 열기”로 나와요. git --version 은 Git 이 깔렸는지 보는 명령이에요. 버전 번호가 나오면 깔린 거고, 명령을 못 찾는다는 빨간 글이 나오면 아직 없는 거예요. 둘 다 아무것도 바꾸지 않는 읽기 전용 명령이에요. 그림 속 --fork-session 은 지난 대화를 이어 열되 새 세션 번호로 분기해 여는 옵션이라, 원래 대화는 그대로 남아요.
설정은 이렇게 같이 써요. 프로젝트의 CLAUDE.md, ~/.claude.json 이나 .mcp.json 에 적은 MCP 서버(클로드에 다른 도구를 붙이는 연결), 훅·스킬, ~/.claude/settings.json 의 권한 규칙이 데스크톱 세션에도 그대로 걸려요. 여기서 ~ 는 내 사용자 폴더(C:\Users\사용자이름)를 줄여 쓴 표시예요. 데스크톱에서는 MCP 서버를 입력 칸 옆 + 버튼의 Connectors 화면으로도 붙일 수 있어요. 자세한 건 MCP 서버 글과 CLAUDE.md 글에 있어요.
앱에 없는 것
데스크톱이 터미널 버전보다 편한 곳은 파일 첨부(그림·PDF), @ 자동 완성, 세션을 사이드바 탭으로 두는 것, 그리고 정해 둔 때마다 혼자 도는 예약 작업이에요. 거꾸로 데스크톱에는 없는 것도 문서에 적혀 있어요.
- 스크립트로 돌리기:
claude -p처럼 명령 한 줄로 결과만 받는 용도(자동화)는 데스크톱에 없어요. - dontAsk 모드: 미리 허락한 도구만 쓰는 모드는 터미널 버전에만 있어요.
- 에이전트 팀: 에이전트는 혼자 판단하며 일을 이어 가는 AI 를 말해요. 여러 Claude 가 팀장과 팀원처럼 일을 나누는 기능은 터미널 버전에만 있어요.
- 창을 띄우는 명령: /permissions 처럼 터미널에 따로 창을 띄우는 명령은 “isn’t available in this environment”라고 답해요. /config 는 Settings 의 Claude Code 화면을 열어요.
- 코드 자동 완성: 편집기처럼 치는 중에 다음 줄을 제안하는 기능은 없어요.
막힐 때
| 이렇게 되면 | 문서가 권하는 것 |
|---|---|
| Code 탭에서 403·인증 오류 | 앱 메뉴에서 로그아웃 뒤 다시 로그인 → 유료 구독인지 확인 → 창만 닫지 말고 앱을 완전히 끄고 다시 켜기 → 인터넷과 프록시(회사망에서 인터넷을 대신 이어 주는 중간 서버) 설정 확인 |
| “Git is required” | Git for Windows 를 깔고 다시. worktree 를 안 쓰는데도 Git 을 달라면 앱 업데이트(1.49585.0 전 버전) |
| “Failed to load session” | 고른 폴더가 없어졌거나 권한 문제, Git LFS(큰 파일을 따로 맡기는 Git 기능)가 필요한 저장소일 수 있음 → 다른 폴더를 고르거나 앱 다시 켜기 |
| npm·node 같은 명령을 못 찾음 | 보통 터미널에서 되는지 확인 → 앱 다시 켜기 |
| 화면이 비거나 멈춤 | 앱 다시 켜기 → 업데이트 확인 → 이벤트 뷰어의 Windows Logs → Application |
| “설치가 이미 진행 중” 오류 | 설치 파일을 관리자 권한으로 실행 |
출처: 클로드 코드 문서 desktop 의 Troubleshooting. 10월 8일 확인.
윈도우에서 하나 더 알아 둘 게 있어요. 앱은 윈도우의 사용자·시스템 환경 변수(프로그램들이 같이 읽는 설정 값)는 물려받지만, PowerShell 프로필에 적은 값은 읽지 않는다고 적혀 있어요. 터미널에서는 되는데 앱에서 안 되는 값이 있다면 이게 이유일 수 있어요. 앱 쪽 값은 입력 칸의 환경 목록에서 Local 위에 마우스를 올리고 톱니 아이콘을 눌러 넣어요. 앱 버전 번호는 Help → About Claude 에서 봐요.
코덱스·안티그래비티는
다른 회사도 터미널 없이 쓰는 코딩 앱을 내놨어요. OpenAI 는 ChatGPT 데스크톱 앱 안에 코덱스(Codex)를 넣었고, 구글은 안티그래비티 2.0 이라는 앱을 따로 내놨어요. 셋 다 폴더를 고르고 말로 요청하는 흐름은 같고, 세션마다 Git worktree 로 복사본을 나누는 길도 셋 다 있어요.
| 무엇 | 클로드 코드 | 코덱스 | 안티그래비티 |
|---|---|---|---|
| 어디서 | 클로드 데스크톱 앱의 Code 탭 | ChatGPT 데스크톱 앱에서 Codex 고르기 | 안티그래비티 2.0 앱 |
| 윈도우 | x64·ARM64 설치 파일 | Microsoft Store·winget, 윈도우 샌드박스 | 윈도우 10 64비트, x64·ARM64 |
| 요금제 | Pro·Max·Team·Enterprise | 기능 표는 Plus 부터와 API 키, Free·Go 는 “차례로 여는 중” | 무료 포함 모든 요금제, 한도는 요금제별 |
| 폴더 고르기 | Local 과 Select folder | 채팅·프로젝트를 열거나 폴더 열기 | 프로젝트를 만들고 Add Folder(여러 폴더 가능) |
출처: 클로드 코드 문서 desktop-quickstart, OpenAI 문서 ChatGPT desktop app·Windows app·Quickstart·Pricing, 안티그래비티 문서 Getting started·Projects·Plans. 10월 8일 확인.
| worktree | 클로드 코드 | 코덱스 | 안티그래비티 |
|---|---|---|---|
| 켜는 곳 | 브랜치 이름 옆 worktree 옵션 | 입력 칸 아래 Worktree | 시작할 때 New worktree mode |
| 두는 곳 | 프로젝트 안 .claude\worktrees\ | $CODEX_HOME/worktrees | 읽은 문서에 없음(미확인) |
| 원래 폴더로 옮기기 | 문서에 없음, 커밋으로 합침 | Hand off 로 Local ↔ Worktree | 읽은 문서에 없음(미확인) |
| 정리 | 보관 아이콘으로 지움 | 최근 15개만 남기고 자동으로 지움(설정) | 읽은 문서에 없음(미확인) |
| Git 이 빼는 파일 | .worktreeinclude | .worktreeinclude | 읽은 문서에 없음(미확인) |
출처: 클로드 코드 문서 desktop·worktrees, OpenAI 문서 Worktrees, 안티그래비티 문서 Getting started·Projects. 10월 8일 확인.
코덱스의 요금제 칸은 문서 안에서도 갈려요. 요금제 카드의 Free·Go 칸에는 “데스크톱 앱에서 GPT-6 Luna, 차례로 여는 중(subject to rollout)”이라고 적혀 있고, 아래 기능 표에는 Free·Go 칸 자체가 없고 Plus 부터와 API 키만 있어요. 무료로 되는지는 계정마다 다를 수 있다고 보는 게 맞아요. 윈도우 앱은 PowerShell 로 명령을 돌리면서 윈도우 샌드박스(명령이 프로젝트 폴더 밖을 못 건드리게 막는 장치)를 쓰고, 그 샌드박스는 입력 칸 아래 Ask for approval 을 골라야 걸린다고 적혀 있어요. 코덱스는 worktree 를 프로젝트 밖 $CODEX_HOME 아래에 두고, Hand off 로 대화와 고친 코드를 원래 폴더(Local)와 worktree 사이에서 옮겨 준다고 적었어요. 터미널 버전 코덱스 쓰는 법은 코덱스 CLI 사용법 글에 있어요.
안티그래비티 2.0 은 편집기에 붙는 확장이 아니라 따로 받는 앱이에요(문서는 예전 Agent Manager 를 이은 것이라고 소개). 폴더 대신 “프로젝트”를 만들고 거기에 폴더 여러 개를 넣을 수 있는 게 다른 점이에요. 문서의 Projects 부분에는 윈도우에서 터미널 명령을 돌릴 때마다 허락을 묻는다고 적혀 있어요(맥·리눅스 기본값은 샌드박스, 곧 프로그램이 정해진 범위 밖을 못 건드리게 가둔 곳 안에서 묻지 않고 돌림). 같은 문서에 /fork 뒤에 프로젝트 ID 를 붙여 대화를 다른 프로젝트로 복사해 가는 방법도 있어요. 터미널 버전 쓰는 법은 안티그래비티 CLI 사용법 글에 있어요.
제 생각에는 이미 돈을 내는 쪽 앱부터 써 보는 게 덜 헤매요. 셋 다 계정과 요금제가 따로라서요. 고친 곳을 하나하나 보고 수락하는 게 중요하다면 클로드 코드의 Manual 모드와 줄 댓글이 손에 잘 맞고, 무료로 먼저 만져 보고 싶다면 무료 등급이 문서에 적힌 안티그래비티가 문턱이 낮아요. 코덱스는 ChatGPT 앱 하나로 대화·문서 일(Work)·코딩을 오가고 싶은 분께 맞아요.
한국에서 되나
| 질문 | 클로드 코드 | 코덱스 | 안티그래비티 |
|---|---|---|---|
| 한국에서 | 됨(지원 국가에 South Korea) | 됨(ChatGPT 지원 국가에 한국) | 됨(FAQ 나라 목록에 South Korea) |
| 무슨 요금제 | Pro·Max·Team·Enterprise | Plus 부터, Free·Go 는 차례로 | 무료 등급 포함, 18세 이상 |
| 한국어 문서 | 있음(/docs/ko/desktop) | 영어 | 영어 |
| 언제부터 | 문서에 출시일 없음 | 새 앱 7월 9일(OpenAI 릴리스 노트) | 공식 안내 없음 |
출처: anthropic.com 지원 국가 목록, 클로드 코드 문서 desktop-quickstart, OpenAI 문서 Pricing·ChatGPT 지원 국가 도움말·릴리스 노트, 안티그래비티 문서 FAQ·Plans. 10월 8일 확인.
다음에 볼 글
터미널 버전을 깔고 싶다면 클로드 코드 설치 윈도우 초보용, @ 와 CLAUDE.md 같은 기본기는 클로드 코드 사용법 글에 있어요. 데스크톱 코드 탭에서도 그대로 통해요. 편집기 안에서 쓰고 싶다면 VS Code 확장 글, 한 세션 안에서 일을 나눠 맡기려면 서브에이전트 글, 한도가 걱정되면 사용량 아끼는 법 모음을 보세요. 세 도구를 처음부터 고르는 이야기는 터미널 코딩 AI 처음 시작하기에 모아 두었어요.
이 글의 내용은 2026년 10월 8일 공식 문서와 터미널 버전 2.1.292 기준이에요. 데스크톱 앱은 버전마다 창과 메뉴가 자주 바뀌어요. 글과 다르게 보이면 공식 문서의 지금 내용을 먼저 보세요.
같이 보면 좋은 글: 챗GPT PC 버전 설치하는 법: 제미나이 윈도우 앱·클로드 데스크톱 앱과 단축키 차이
같이 보면 좋은 글: 클로드 코드 VS Code 확장 쓰는 법: 설치, 고친 곳 고르기, Alt+K 까지
같이 보면 좋은 글: AI 비교 2026: 클로드·챗GPT·제미나이 요금제·한도·기능 표
같이 보면 좋은 글: 클로드 코드 깃 커밋·PR 맡기는 법: 연습 폴더부터 /diff·push 막기·서명 줄까지
같이 보면 좋은 글: 클로드 코드 예약 작업 하는 법: /loop 반복·데스크톱 예약·루틴 차이와 7일 만료
같이 보면 좋은 글: 클로드 코드 worktree 사용법: claude -w 로 같은 저장소에서 일 두 개 같이 하기
같이 보면 좋은 글: 클로드 코드 Remote Control 사용법: 휴대폰·브라우저로 내 PC 세션 이어 보기, 켜는 명령과 끄는 법
참고한 자료
2026년 10월 8일에 확인했어요. 클로드 코드 문서는 영어 문서와 한국어 문서(/docs/ko/)를 같이 봤어요.
- Get started with the desktop app (클로드 코드 공식 문서, 세 탭·설치·첫 세션·고친 곳 검토)
- Desktop application (클로드 코드 공식 문서, 권한 모드·diff 와 줄 댓글·/code-review·창 배치·단축키·사이드 채팅·세션 여러 개와 worktree·CLI 에서 오기·없는 기능·문제 해결)
- Run parallel sessions with worktrees (클로드 코드 공식 문서, --worktree·.worktreeinclude·나갈 때 정리)
- Claude Desktop 설치 (Claude 한국어 도움말, 요금제별 기능·윈도우 10 이상)
- Cowork is now Claude (Anthropic 공식, 2026년 9월 16일)
- Supported countries (Anthropic, South Korea)
- ChatGPT desktop app (OpenAI 공식 문서, 설치·폴더 열기·Codex 고르기)
- ChatGPT desktop app for Windows (OpenAI 공식 문서, Microsoft Store·winget·윈도우 샌드박스)
- Worktrees (OpenAI 공식 문서, Worktree 고르기·Hand off·$CODEX_HOME/worktrees·15개 정리)
- Pricing (OpenAI 공식 문서, Free·Go 카드와 기능 표)
- 새 ChatGPT 데스크톱 앱으로 전환하기 (OpenAI 한국어 도움말)
- ChatGPT Release Notes (OpenAI 도움말, 2026년 7월 9일 새 데스크톱 앱)
- ChatGPT 지원 국가 (OpenAI 한국어 도움말, 한국)
- Antigravity 2.0 overview (안티그래비티 공식 문서, 따로 받는 앱)
- Getting started (안티그래비티 공식 문서, 윈도우 요구 사항·프로젝트·Local mode 와 New worktree mode)
- Projects (안티그래비티 공식 문서, 여러 폴더·윈도우 명령 허락·/fork)
- Plans (안티그래비티 공식 문서, 모든 요금제 기본 한도)
- FAQ (안티그래비티 공식 문서, 나라 목록·18세)
광고 · 쿠팡 추천 상품
이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다.
