Claude Code 를 설치하자마자 바로 사용을 시작하고 계신가요? 솔직히 말씀드리자면, 그건 위험한 일입니다.
Claude Code 는 파일을 읽고 쓰고, 명령어를 실행하고, 코드를 재작성하고, 심지, Pull Request 까지 생성하는 AI 입니다. 즉, 단순한 대화 상대가 아니라 실제로 PC 에서 작업을 수행하는 존재입니다.
설정을 확인하지 않고 시작하는 것은 신입 직원에게 "특별한 규칙은 없으니 알아서 하세요"라고 말하는 것과 같습니다. 능력 있는 직원일수록 규칙이 없으면 자체 판단에 따라 움직이게 마련입니다. AI 도 마찬가지입니다.
저는 직접 Claude Code 데스크톱 앱의 모든 설정 화면을 열어 하나씩 다시 확인해 봤습니다. 꼭 확인해야 할 설정과 처음부터 건드릴 필요가 없는 설정은 확실히 구분됩니다.
이 글을 읽고 나면 Claude Code 데스크톱 앱 설정에서 어디를 봐야 하는지, 어떤 설정을 변경해야 하는지, 어떤 설정은 무시해도 되는지 알게 될 것입니다.
Claude Code 데스크톱 앱 설정 메뉴에는 많은 항목이 있습니다: General, Notifications, Personalization, Apps, Schedule, Billing, Data Control, Storage, Security, Parental Controls, Account. 그 아래에는 Privacy, Usage, Features, Connectors, Claude Code, Cowork, Claude in Chrome 이 있습니다. 더 아래로 내려가면 "Desktop App" 섹션에 General, Extensions, Developer 가 있습니다.
솔직히 많죠. 하지만 처음에 확인해야 할 곳은 단 네 곳뿐입니다.
- Desktop App "General"
- "Privacy"
- "Claude Code"
- 세션 시작 시 Permission Mode 와 CLAUDE.md
나머지는 처음에 건드릴 필요가 없습니다.
1. Desktop App "General": 안전한 사용을 위한 기초 다지기
왼쪽 메뉴를 "Desktop App" 섹션까지 내려 "General"을 엽니다. 이것이 Claude Code 를 안전하게 사용하기 위한 기초입니다.
Run at Startup
로그인할 때 Claude Code 가 자동으로 실행될지 결정합니다. 지금은 꺼두세요. 매일 사용하기 시작하면 켜도 됩니다.
Quick Access Shortcut
어디서나 Claude 에게 메시지를 보낼 수 있는 단축키입니다. 기본값은 "Option 키 두 번 누르기"입니다. 다른 앱과 충돌하는지 확인하세요.
Voice Shortcut
Claude 와 대화하기 위한 단축키입니다. 기본값은 "None"입니다. 음성 입력은 다음과 같은 자세한 지침을 내릴 때 매우 유용합니다.
- "이 콘텐츠를 확인하되, 아직 변경하지 마세요."
- "무엇이든 변경하기 전에 항상 diff 를 보여주세요."
- "이 오류의 원인만 찾아주세요. 아직 수정은 필요 없어요." 지침이 모호하면 Claude Code 가 너무 지나칠 수 있습니다. 음성으로 자주 지침을 내릴 수 있으면 더 안전합니다.
Menu Bar
메뉴 막대에 Claude 를 표시할지 여부입니다. 켜두는 것이 좋습니다.
Prevent Computer from Sleeping
이것은 놀랍도록 중요합니다. Claude 가 긴 작업을 수행하는 동안 PC 가 절전 모드로 전환되면 작업이 중단됩니다. 다중 파일 검토나 코드 재작성 같은 시간이 오래 걸리는 작업을 처리하도록 할 때는 이 기능을 켜두세요. 기본적으로 켜져 있습니다.
Browser Use
여기부터는 권한 관련 설정입니다. 주의하세요. "모든 브라우저 작업 허용"을 켜면 Claude 가 Chrome 에서 어떤 웹사이트든 확인 없이 탐색하고 조작할 수 있습니다. 설정 화면에서 데이터가 위험에 처할 수 있다고 경고합니다. 처음에는 꺼두는 것이 좋습니다. 켜는 경우 불필요한 탭을 닫고 이메일, 결제, 고객 정보가 표시되는 페이지에서 특히 주의하세요.
Computer Use (Beta)
이것은 매우 중요합니다. 켜면 Claude 가 승인된 앱에서 스크린샷을 찍고 키보드와 마우스를 조작할 수 있습니다. 기본적으로 꺼져 있습니다. 지금은 꺼두세요. 켜는 경우 macOS 에서 "손쉬운 사용" 및 "화면 기록" 권한이 필요합니다.
Denied Apps
Claude 가 액세스하지 못하게 할 앱을 등록합니다. Computer Use 를 사용하는 경우 메일러, 메일러, 비밀번호 관리자, 내부 기밀 도구를 여기에 추가하세요.
2. Privacy: 데이터 처리 확인
Location Metadata
Claude 가 대략적인 위치 데이터를 사용하여 경험을 개선하도록 허용합니다. 선택 사항입니다.
Help Improve Claude
사용자의 채팅 및 코딩 데이터를 Anthropic 모델 학습에 사용하도록 허용합니다. 클라이언트 코드나 기밀 프로젝트를 다루는 경우 이 기능을 끄는 더 안전합니다. 기본적으로 꺼져 있지만 다시 확인하세요.
3. Claude Code: Claude Code: 세션 및 PR 동작 결정
Session State Classification
Claude 가 세션을 차단됨, 검토 보류, 완료됨으로 자동 분류하도록 허용합니다. 여러 병렬 세션을 추적하려면 켜두세요.
Allow Bypass Permission Mode
경고: 모든 권한 확인을 우회합니다. 위험성이 높으며 데이터 손실이나 시스템 손상을 초래할 수 있습니다. 꺼두세요. 샌드박스나 VM 외부에서는 사용하지 마세요.
Worktree Location
데스크톱 앱은 각각의 새 세션에 대해 Git 작업 트리에 작업 복사본을 자동으로 격리합니다. 이렇게 하면 세션 A 의 변경 사항 B의 변경 사항이 서로 영향을 미치지 않습니다. 기본값은 "Inside project (.claude/w...)"입니다.
중요한 점은 .worktreeinclude를 기억하는 것입니다. Git 에서 무시되는 파일 (예: .env)은 작업 트리에 자동으로 복사되지 않습니다. 환경 변수 누락으로 인한 오류가 발생하면 프로젝트 루트에 .worktreeinclude 파일을 만들고 복사할 파일을 지정하세요.
Pull Request Automation
PR 을 자동으로 생성하고 CI 실패를 자동으로 수정하는 설정이 있습니다. 처음에는 꺼두세요. 먼저 PR 내용을 직접 확인하는 것이 더 안전합니다.
Auto-archive after PR Merge/Close
이 기능을 켜는 것이 좋습니다. 완료된 세션이 사이드바를 어지럽히는 것을 방지합니다.
4. Permission Mode 와 CLAUDE.md: 모든 세션 확인
Permission Mode
세션 시작 시 보내기 버튼 옆에서 이 옵션을 선택합니다. Claude 가 스스로 얼마나 많은 작업을 수행할 수 있는지 결정합니다.
- Ask permissions: 모든 파일 편집과 명령어를 확인합니다. Claude 의 작동 방식을 이해하는 데 가장 좋습니다.
- Auto accept edits: 파일 편집 및 기본 작업을 자동으로 수락합니다. Claude 의 판단을 신뢰하게 되면 작업 속도를 높여줍니다.
- Plan mode: 파일을 읽고 명령어를 실행하여 조사하지만 코드는 편집하지 않습니다. 먼저 계획을 수립한 다음 Auto accept edits 로 전환하려면 이 모드를 사용하세요.
- Auto: 거의 완전 자동입니다. Max/Team/Enterprise/API 요금제 전용입니다. 이것부터 시작하지 마세요. Claude 가 지침을 잘못 해석하고 너무 많은 부분을 재작성할 수 있습니다.
CLAUDE.md
Permission Mode 가 "얼마나 할 수 있는지"라면, CLAUDE.md 는 "어떻게 처리하기를 원하는지"입니다. 이 파일을 프로젝트 루트에 배치하세요. Claude 는 모든 세션 시작 시 이를 읽습니다. 다음 용도로 사용하세요.
- 기본 프로젝트 명령어 (빌드, 테스트, 개발)
- 규칙 (예: "변경 전 항상 diff 표시", "파일 구조 변경 금지")
- 수정 규칙 (Claude 가 실수할 때마다 줄을 추가하여 재발 방지)
100 줄 미만으로 유지하세요. 세션에서 /init을 사용하여 자동 생성할 수 있습니다.
요약
Claude Code 는 단순한 채팅 AI가 아니라 PC 에서 작동하는 에이전트입니다. 설정에 10분을 투자하면 AI 에게 통제당하는 것과 스스로 통제하는 것의 차이가 생깁니다. "이거 고쳐줘"라고만 말하지 말고 "이거 확인하고 계획을 제안해줘"부터 시작하세요. 안전이 최우선입니다.
