Claude Desktop에서 코딩 작업을 처음 시작하려면 Code 탭 → Local → Select folder → Manual 권한 모드 순서로 설정합니다. 첫 요청은 파일을 바꾸지 않는 읽기 작업으로 제한합니다. 수정 제안이 생기면 diff를 확인한 뒤 Accept 또는 Reject를 사람이 결정합니다. 공식 문서가 안내하는 지원 구독과 현재 계정 화면도 먼저 확인합니다. 배포·커밋·외부 전송은 첫 세션의 완료 범위에서 제외합니다.

• Code 탭과 Chat·Cowork의 차이
• 공식 문서가 확인한 구독 및 운영체제 경계
• Local 환경과 Select folder를 고르는 순서
• Manual 권한 모드에서 첫 읽기 요청을 보내는 법
• 변경 제안의 diff를 검토하고 승인 지점을 지키는 법

Claude Code Desktop의 Code 탭은 선택한 프로젝트 폴더에 접근해 코드를 읽고 변경을 제안하며 명령을 실행할 수 있는 대화형 코딩 화면입니다. 일반 대화를 위한 Chat 탭과 달리 실제 파일을 작업 범위로 삼습니다. Cowork는 별도 환경에서 더 긴 작업을 처리하는 화면입니다.

이 글은 로컬 소스 파일을 직접 검토하는 Code 탭만 다룹니다.

공식 빠른 시작 문서에 따르면 데스크톱 앱에는 Claude Code가 포함됩니다. Code 탭을 쓰기 위해 Node.js나 터미널용 Claude Code CLI를 별도로 설치할 필요는 없습니다.

다만 터미널에서 claude 명령을 사용하려면 CLI를 따로 설치해야 합니다.

Code 탭의 대화 하나는 세션입니다. 각 세션은 대화 맥락, 선택한 프로젝트 폴더, 코드 변경을 따로 추적합니다. 따라서 시작 화면에서 어떤 환경과 폴더를 선택했는지가 이후 작업 범위를 결정합니다.

이미 내 컴퓨터에 있고 구조를 알고 있는 작은 프로젝트를 점검할 때 Local 세션이 알맞습니다. README 확인, 테스트 실행 방법 찾기, 한 파일의 역할 설명처럼 결과를 원본과 바로 대조할 수 있는 작업부터 시작하는 편이 좋습니다.

앱을 닫아도 계속 돌아가야 하는 장시간 작업은 공식 문서의 Remote 또는 Cloud 경로에 해당합니다. 다른 서버의 파일을 다뤄야 한다면 SSH가 별도 선택지입니다. 이 글은 그 환경을 서로 연결하거나 자동 전환하는 방법을 다루지 않습니다.

실전 기준: 처음부터 운영 저장소나 홈 폴더 전체를 열지 않습니다. 공개돼도 문제가 없는 작은 연습 프로젝트나 승인된 작업용 복사본 하나를 씁니다. 여기서 Code 탭의 범위와 승인 흐름부터 확인합니다.

공식 quickstart는 Claude Code에 Pro, Max, Team 또는 Enterprise 구독이 필요하다고 안내합니다. Code 탭을 눌렀을 때 업그레이드나 온라인 로그인 안내가 보인다면 현재 계정의 제공 조건을 먼저 확인합니다. 조직 계정이라면 관리자가 허용한 권한 모드가 개인 화면과 다를 수 있습니다.

공식 빠른 시작의 설치 경로는 macOS와 Windows를 안내합니다. Windows Local 세션에는 Git 설치가 필요하다고 명시돼 있습니다. 설치 문서와 앱 화면은 바뀔 수 있습니다.

이 글에 없는 운영체제나 장치로 일반화하지 말고 현재 공식 다운로드 화면을 확인합니다.

첫 실습 폴더에는 비밀키, 고객 정보, 운영 데이터가 없어야 합니다. .env 같은 민감 파일을 단순히 프롬프트에서 제외한다고 해서 접근 자체가 차단되는 것은 아닙니다.

가장 안전한 방법은 필요한 비민감 파일만 넣은 별도 복사본을 Select folder로 지정하는 것입니다. 이는 Claude Desktop이 자동으로 만들어 주는 백업이 아니라 사용자가 준비하는 내부 검토 규칙입니다.

목표: 선택한 테스트 프로젝트의 구조와 로컬 실행 방법을 읽기 전용으로 파악합니다.

허용 입력: README, package 설정 파일, 테스트 설정 파일, 사용자가 지정한 [검토 파일 목록]만 읽습니다.

제외 입력: .env, 비밀키, 인증서, 고객 데이터, 운영 로그, 지정하지 않은 상위 폴더는 읽거나 인용하지 않습니다.

출력 형식: 확인한 파일 경로 | 파일에서 확인한 사실 | 실행 후보 명령 | 확인 필요 항목의 4열 검토표로 작성합니다.

완료 기준: 허용 목록의 파일만 근거로 실행 순서 후보를 정리하고 모든 행에 근거 경로를 붙입니다.

추정 금지: 파일에 없는 패키지, 명령, 포트, 계정 조건을 만들지 말고 확인할 수 없으면 확인 필요로 남깁니다.

승인 지점: 파일 수정, 명령 실행, 패키지 설치, 커밋, 배포, 외부 전송은 하지 말고 각각 사람의 별도 승인 전 멈춥니다.

첫 세션의 성패는 Claude가 많은 일을 했는지가 아니라 어디서 멈췄고 무엇을 사람이 확인했는지로 판단합니다. 요청 밖 파일, 근거 없는 실행 명령, 설명되지 않은 삭제 줄 가운데 하나라도 보이면 Reject하는 기준을 미리 정합니다.

변경을 거절할 때는 “다시 해 줘”보다 이유를 구체적으로 적습니다. “README만 대상으로 유지하고 package 설정은 읽지 마”, “파일 수정 없이 실행 후보만 제시해”처럼 다음 제안의 범위를 줄입니다. 이 기록이 AI 답변의 정확성을 증명하지는 않습니다. 다만 사람이 무엇을 승인했는지는 분명해집니다.

완료 기준: 비민감 폴더가 맞습니다. 첫 읽기 결과의 파일 경로가 원본과 일치합니다. 수정 제안이 있다면 diff를 검토해 Accept 또는 Reject를 사람이 결정했습니다. 커밋·배포·외부 공유는 아직 하지 않았습니다.

• Local은 내 컴퓨터의 선택한 파일을 직접 다루는 환경입니다. 테스트용 복사본을 쓰고 원본과 백업을 별도로 유지합니다.
• Manual은 승인 절차를 제공하지만 결과의 사실성이나 코드 품질을 보장하지 않습니다. diff, 테스트, 실제 파일을 각각 확인합니다.
• 프롬프트 안의 제외 문구만으로 접근 통제가 완성되지는 않습니다. 민감 파일은 처음부터 선택 폴더 밖에 둡니다.
• Accept edits나 Bypass permissions로 바꾸면 승인 범위가 달라집니다. 첫 실습에서는 Manual을 유지합니다.
• 계정 업그레이드, 패키지 설치, 커밋, 배포, 원격 전송은 별도 판단이 필요한 작업입니다. 첫 로컬 세션의 완료 기준에 넣지 않습니다.

Q1. Code 탭을 쓰려면 Claude Code CLI도 설치해야 하나요?

아닙니다. 공식 quickstart는 데스크톱 앱에 Claude Code가 포함돼 있어 Code 탭 사용만을 위해 Node.js나 CLI를 별도로 설치할 필요가 없다고 설명합니다. 터미널에서 claude 명령을 쓰려는 경우에는 CLI 설치가 별도입니다.

Q2. 처음부터 운영 프로젝트를 Select folder로 골라도 되나요?

권장하지 않습니다. 먼저 비밀 정보와 운영 데이터가 없는 작은 테스트 프로젝트 또는 승인된 복사본으로 폴더 범위, 권한 요청, diff 흐름을 확인합니다. 기능에 익숙해진 뒤에도 조직 정책과 백업·검토 기준부터 적용합니다.

Q3. Manual이면 Claude가 파일을 절대 바꾸지 않나요?

Manual은 편집이나 명령 실행 전에 묻고 diff를 통해 Accept 또는 Reject를 결정하게 하는 모드입니다. 다만 승인 화면이 있다는 사실이 결과의 정확성을 보장하지는 않습니다. 어떤 행동을 승인했는지 읽고 변경 뒤 실제 파일과 테스트 결과를 확인해야 합니다.

Q4. Local, Remote, SSH 중 무엇을 골라야 하나요?

내 컴퓨터의 승인된 프로젝트를 직접 검토하려면 Local을 고릅니다. 앱을 닫은 뒤에도 이어지는 클라우드 작업과 원격 컴퓨터 연결은 각각 별도 환경입니다. 첫 실습에서는 하나의 Local 경로만 사용하고 환경 간 자동 전환이나 동기화를 가정하지 않습니다.

1. Anthropic Claude Code Docs, Get started with the desktop app
2. Anthropic Claude Code Docs, Desktop application