Claude Code Desktop에서 코드 작업하기

Claude에게 올바른 컨텍스트를 제공하고, 자동으로 수행할 작업의 양을 제어하고, 변경 사항을 검토합니다.

프롬프트 상자 사용하기

Claude가 수행할 작업을 입력하고 Enter 를 눌러 보냅니다. Claude는 프로젝트 파일을 읽고, 변경 사항을 만들고, 권한 모드에 따라 명령을 실행합니다. 언제든지 Claude를 중단할 수 있습니다: 중지 버튼을 클릭하거나 수정 사항을 입력하고 Enter 를 누릅니다. Claude는 작업을 중지하고 입력에 따라 조정합니다.

프롬프트 상자 옆의 + 버튼을 클릭하면 파일 첨부, skills, 커넥터, 플러그인에 액세스할 수 있습니다.

프롬프트에 파일 및 컨텍스트 추가하기

프롬프트 상자는 외부 컨텍스트를 가져오는 두 가지 방법을 지원합니다:

• @mention 파일: @ 다음에 파일 이름을 입력하여 파일을 대화 컨텍스트에 추가합니다. Claude는 그 파일을 읽고 참조할 수 있습니다. @mention은 원격 세션에서 사용할 수 없습니다.
• 파일 첨부: 첨부 버튼을 사용하여 이미지, PDF 및 기타 파일을 프롬프트에 첨부하거나, 파일을 프롬프트에 직접 드래그 앤 드롭합니다. 이는 버그 스크린샷, 디자인 목업 또는 참고 문서를 공유하는 데 유용합니다.

권한 모드 선택하기

권한 모드는 세션 중에 Claude가 가질 자율성을 제어합니다: 파일 편집, 명령 실행 또는 둘 다 전에 묻는지 여부입니다. 전송 버튼 옆의 모드 선택기를 사용하여 언제든지 모드를 전환할 수 있습니다. Claude가 수행하는 작업을 정확히 보기 위해 권한 요청으로 시작한 다음, 편하면 자동 수락 편집 또는 Plan mode로 이동합니다.

dontAsk 권한 모드는 CLI에서만 사용 가능합니다.

Auto mode는 Max, Team, Enterprise, API 계획에서 사용 가능한 연구 미리보기입니다. Pro 계획 또는 타사 공급자에서는 사용할 수 없습니다. Team, Enterprise, API 계획에서는 Claude Sonnet 4.6, Opus 4.6, Opus 4.7이 필요합니다. Max 계획에서는 Claude Opus 4.7이 필요합니다.

모범 사례

복잡한 작업을 Plan mode에서 시작하여 Claude가 변경하기 전에 접근 방식을 매핑하도록 합니다. 계획을 승인한 후 자동 수락 편집 또는 권한 요청으로 전환하여 실행합니다. 이 워크플로우에 대한 자세한 내용은 먼저 탐색, 그 다음 계획, 그 다음 코드를 참조하세요.

원격 세션은 자동 수락 편집 및 Plan mode를 지원합니다. 권한 요청은 원격 세션이 기본적으로 파일 편집을 자동으로 수락하기 때문에 사용할 수 없으며, 권한 무시는 원격 환경이 이미 샌드박스되어 있기 때문에 사용할 수 없습니다.

엔터프라이즈 관리자는 사용 가능한 권한 모드를 제한할 수 있습니다. 자세한 내용은 엔터프라이즈 구성을 참조하세요.

앱 미리보기

Claude는 개발 서버를 시작하고 임베드된 브라우저를 열어 변경 사항을 확인할 수 있습니다. 이는 프론트엔드 웹 앱뿐만 아니라 백엔드 서버에도 작동합니다: Claude는 API 엔드포인트를 테스트하고, 서버 로그를 보고, 발견한 문제를 반복할 수 있습니다. 대부분의 경우 Claude는 프로젝트 파일을 편집한 후 자동으로 서버를 시작합니다. 언제든지 Claude에게 미리보기를 요청할 수도 있습니다. 기본적으로 Claude는 모든 편집 후 자동으로 변경 사항을 확인합니다.

미리보기 패널은 프로젝트의 정적 HTML 파일, PDF, 이미지 및 비디오도 열 수 있습니다. 채팅에서 HTML, PDF, 이미지 또는 비디오 경로를 클릭하여 미리보기에서 엽니다.

미리보기 패널에서 다음을 수행할 수 있습니다:

• 임베드된 브라우저에서 실행 중인 앱과 직접 상호작용
• Claude가 자동으로 자신의 변경 사항을 확인하는 것을 봅니다: 스크린샷을 찍고, DOM을 검사하고, 요소를 클릭하고, 양식을 채우고, 발견한 문제를 수정합니다
• 세션 도구 모음의 Preview 드롭다운에서 서버 시작 또는 중지
• Persist sessions 을 드롭다운에서 선택하여 서버 재시작 시 쿠키 및 로컬 스토리지를 유지하므로 개발 중에 다시 로그인할 필요가 없습니다
• 서버 구성을 편집하거나 모든 서버를 한 번에 중지

Claude는 프로젝트를 기반으로 초기 서버 구성을 만듭니다. 앱이 사용자 정의 개발 명령을 사용하는 경우 .claude/launch.json을 편집하여 설정과 일치시킵니다. 전체 참조는 미리보기 서버 구성을 참조하세요.

저장된 세션 데이터를 지우려면 Settings → Claude Code에서 Persist preview sessions 을 토글 해제합니다. 미리보기를 완전히 비활성화하려면 Settings → Claude Code에서 Preview 를 토글 해제합니다.

diff 보기로 변경 사항 검토하기

Claude가 코드를 변경한 후 diff 보기를 사용하면 pull request를 만들기 전에 파일별로 수정 사항을 검토할 수 있습니다.

Claude가 파일을 변경하면 +12 -1과 같이 추가 및 제거된 줄 수를 표시하는 diff 통계 표시기가 나타납니다. 이 표시기를 클릭하여 diff 뷰어를 열면 왼쪽에 파일 목록이 표시되고 오른쪽에 각 파일의 변경 사항이 표시됩니다.

특정 줄에 댓글을 달려면 diff의 모든 줄을 클릭하여 댓글 상자를 엽니다. 피드백을 입력하고 Enter 를 눌러 댓글을 추가합니다. 여러 줄에 댓글을 추가한 후 모든 댓글을 한 번에 제출합니다:

• macOS: Cmd+Enter 누르기
• Windows: Ctrl+Enter 누르기

Claude는 댓글을 읽고 요청된 변경 사항을 만들며, 이는 검토할 수 있는 새로운 diff로 나타납니다.

코드 검토하기

diff 보기에서 오른쪽 상단 도구 모음의 Review code 를 클릭하여 Claude에게 커밋하기 전에 변경 사항을 평가하도록 요청합니다. Claude는 현재 diff를 검토하고 diff 보기에 직접 댓글을 남깁니다. 모든 댓글에 응답하거나 Claude에게 수정을 요청할 수 있습니다.

검토는 높은 신호 문제에 중점을 둡니다: 컴파일 오류, 명확한 논리 오류, 보안 취약점, 명백한 버그입니다. 스타일, 형식, 기존 문제 또는 linter가 포착할 수 있는 것은 플래그하지 않습니다.

pull request 상태 모니터링하기

pull request를 연 후 CI 상태 표시줄이 세션에 나타납니다. Claude Code는 GitHub CLI를 사용하여 확인 결과를 폴링하고 실패를 표시합니다.

• 자동 수정: 활성화되면 Claude는 실패 출력을 읽고 반복하여 실패한 CI 확인을 자동으로 수정하려고 시도합니다.
• 자동 병합: 활성화되면 모든 확인이 통과하면 Claude가 PR을 병합합니다. 병합 방법은 squash입니다. 자동 병합은 이 작업을 수행하기 위해 GitHub 저장소 설정에서 활성화되어야 합니다.

CI 상태 표시줄의 Auto-fix 및 Auto-merge 토글을 사용하여 옵션을 활성화합니다. Claude Code는 CI가 완료되면 데스크톱 알림도 보냅니다. 세션이 PR을 병합하거나 닫은 후 자동으로 아카이브되도록 하려면 Settings → Claude Code에서 auto-archive를 켭니다.

PR 모니터링에는 GitHub CLI (gh)가 머신에 설치되고 인증되어야 합니다. gh가 설치되지 않은 경우 Desktop은 처음으로 PR을 만들려고 할 때 설치하도록 요청합니다.