{"content_id":"gqsjob8ujn","slug":"claude-code-setup-permissions-models-context-guide","locale":"ko","schema_type":"TechArticle","category":"tutorial","category_name":"튜토리얼","title":"Claude Code 기초 가이드: 설치·권한·모델·컨텍스트 관리","summary":"Claude Code의 설치와 첫 실행부터 권한 모드, 모델 선택, 컨텍스트 정리, CLAUDE.md 작성법까지 단계별로 설명한다. 원자료에서 단순화된 권한 체계와 비용 관련 내용도 공식 문서 기준으로 바로잡았다.","author":{"name":"인조이스 편집팀","url":"https://injoys.com/ko/about"},"key_points":["Claude Code는 프로젝트 디렉터리의 파일을 읽고 수정하며 터미널 도구를 실행할 수 있는 에이전트형 코딩 도구다.","VS Code는 편리한 선택지이지만 필수 조건은 아니며, 지원되는 터미널 환경에서도 Claude Code를 실행할 수 있다.","초보자는 Plan 모드로 작업 범위를 검토한 뒤 기본 모드나 Accept Edits 모드로 전환하는 편이 안전하다.","비용은 인증 방식과 선택한 모델, 입력 컨텍스트, 작업 반복 횟수에 따라 달라진다.","CLAUDE.md는 대화 기억 저장소가 아니라 프로젝트의 구조와 명령, 규칙을 반복해서 제공하는 지침 파일이다."],"content_markdown":"Claude Code는 Anthropic의 Claude를 터미널과 코드 저장소에서 사용하는 에이전트형 개발 도구다. 단순히 코드 조각을 답변하는 데 그치지 않고, 허용된 범위 안에서 파일 탐색·편집, 명령 실행, 테스트와 오류 분석을 수행한다.\n\n이 가이드는 설치 절차뿐 아니라 권한을 안전하게 설정하는 방법, 작업에 맞는 모델을 고르는 기준, 컨텍스트와 프로젝트 지침을 관리하는 방법을 설명한다. 명령과 지원 환경은 업데이트될 수 있으므로 실제 설치 시에는 공식 설정 문서에 표시되는 최신 명령을 확인해야 한다.\n\n## Claude로 코딩하는 세 가지 방식\n\n각 방식은 결과물보다 **도구가 로컬 프로젝트와 상호작용하는 범위**에서 차이가 난다.\n\n| 방식 | 로컬 파일 접근 | 명령 실행 | 적합한 작업 | 주요 한계 |\n|---|---:|---:|---|---|\n| Claude 웹 | 기본적으로 제한적 | 기본적으로 불가 | 질문, 코드 설명, 짧은 예제, 설계 검토 | 답변을 프로젝트에 직접 반영하려면 복사와 실행이 필요함 |\n| Claude 데스크톱 앱 | 기능·연동·사용자 승인에 따라 다름 | 기능·연동에 따라 다름 | 문서 작업, 대화 중심 업무, 지원되는 로컬 연동 | 모든 설치 환경에서 저장소와 셸을 자동 제어하는 것은 아님 |\n| Claude Code | 프로젝트 범위에서 가능 | 권한 정책에 따라 가능 | 실제 저장소 수정, 테스트, 리팩터링, 장기 프로젝트 | 셸과 파일 권한을 다루므로 검토와 보안 설정이 필요함 |\n\nClaude Code가 전문 개발자만을 위한 것은 아니다. 다만 파일 삭제, 의존성 설치, 빌드 스크립트 실행처럼 시스템에 영향을 주는 작업이 가능하므로 초보자일수록 Plan 모드와 버전 관리를 함께 사용하는 것이 좋다.\n\n## 설치 전 준비 사항\n\n다음 항목을 먼저 준비한다.\n\n- 공식 문서에서 현재 지원되는 운영체제와 셸 환경을 확인한다.\n- Claude Code를 이용할 수 있는 Anthropic 계정 또는 지원되는 인증·결제 환경을 준비한다.\n- 기존 프로젝트라면 Git 저장소를 만들고 변경 사항을 커밋하거나 백업한다.\n- 프로젝트의 테스트, 빌드, 린트 명령을 파악한다.\n- VS Code 같은 편집기를 사용할 수 있지만, VS Code 자체가 Claude Code의 필수 조건은 아니다.\n\nWindows에서는 공식 문서가 안내하는 PowerShell, 명령 프롬프트 또는 WSL 조건을 확인해야 한다. 조직에서 관리하는 컴퓨터라면 설치 권한, 프록시, 방화벽, 데이터 처리 정책도 먼저 점검한다.\n\n## Claude Code 설치와 첫 실행\n\n### 1. 공식 설치 명령 확인\n\nClaude Code 공식 설정 문서에서 운영체제에 맞는 최신 설치 방법을 선택한다. 설치 방식과 명령은 변경될 수 있으므로 오래된 영상이나 블로그의 명령을 그대로 재사용하기보다 공식 문서를 기준으로 삼는다.\n\n### 2. 프로젝트 폴더 열기\n\n새 폴더를 만들거나 기존 저장소로 이동한다. VS Code를 사용한다면 **File \u003e Open Folder**로 폴더를 연 다음 **Terminal \u003e New Terminal**을 선택할 수 있다.\n\n```bash\ncd path/to/project\nclaude\n```\n\n`claude`를 실행하면 필요한 경우 브라우저 인증 절차가 표시된다. 로그인 후 Claude Code는 현재 작업 디렉터리를 기준으로 프로젝트를 파악한다. 따라서 홈 디렉터리나 지나치게 넓은 상위 폴더보다 실제 저장소의 루트에서 실행하는 편이 안전하다.\n\n### 3. 첫 요청은 작게 시작\n\n처음부터 전체 애플리케이션 제작을 맡기기보다 다음과 같이 범위를 나눈다.\n\n1. 프로젝트 구조를 읽고 요약하게 한다.\n2. 구현 계획과 변경 대상 파일을 제시하게 한다.\n3. 한 기능만 구현하게 한다.\n4. 테스트나 정적 분석을 실행하게 한다.\n5. 변경 내역과 남은 위험을 설명하게 한다.\n\n예시 요청:\n\n```text\n이 저장소를 읽고 구조와 실행 방법을 요약해 줘. 아직 파일은 수정하지 말고,\n로그인 폼을 추가하기 위한 계획과 변경 대상 파일만 제안해 줘.\n```\n\n## 권한 모드와 안전한 설정\n\nClaude Code의 권한 모드는 버전과 설정 화면에 따라 표시 문구가 달라질 수 있다. 공식 설정에서 사용하는 대표적인 모드 개념은 다음과 같다.\n\n| 모드 | 동작 | 권장 상황 |\n|---|---|---|\n| Default | 파일 수정이나 위험 가능성이 있는 도구 실행 시 필요에 따라 승인을 요청 | 일반적인 일상 작업 |\n| Accept Edits | 파일 편집은 자동으로 허용하되 다른 도구에는 별도 승인이 적용될 수 있음 | 변경 파일을 Git으로 추적하는 개발 작업 |\n| Plan | 파일을 수정하거나 명령을 실행하지 않고 분석과 계획에 집중 | 저장소 파악, 설계 검토, 초보자의 첫 단계 |\n| Don't Ask | 사전 허용되지 않은 작업을 질문하는 대신 거부하는 비대화형 정책 | 자동화 환경이나 엄격한 허용 목록을 사용할 때 |\n| Bypass Permissions | 권한 확인 절차를 우회 | 격리된 컨테이너 등 위험을 통제한 환경 외에는 지양 |\n\n`Shift+Tab`은 대화형 화면에서 제공되는 일부 권한 상태를 전환하는 데 사용될 수 있다. 그러나 모든 설정이 반드시 이 단축키만으로 순환되는 것은 아니므로 현재 화면의 상태 표시와 공식 권한 문서를 확인해야 한다.\n\n### 초보자에게 권장하는 흐름\n\n1. Plan 모드에서 구현 계획을 받는다.\n2. 변경 파일과 실행할 명령을 검토한다.\n3. Default 또는 Accept Edits 모드에서 구현한다.\n4. 패키지 설치, 데이터베이스 변경, 삭제 명령은 직접 확인한다.\n5. `git diff`와 테스트 결과를 검토한 뒤 커밋한다.\n\nBypass Permissions는 단순히 편리한 고속 모드가 아니다. 잘못된 명령, 과도한 파일 접근, 비밀정보 노출의 피해를 키울 수 있으므로 개인 컴퓨터나 중요한 저장소에서 기본값으로 사용하지 않는다.\n\n## 모델 선택과 비용 관리\n\n대화형 세션에서 `/model`을 사용하면 계정과 환경에서 선택 가능한 모델을 확인하거나 변경할 수 있다. 모델 이름과 별칭, 제공 여부는 시점과 인증 방식에 따라 달라질 수 있으므로 고정된 모델 목록을 전제로 자동화하지 않는 편이 좋다.\n\n```text\n/model\n```\n\n일반적인 선택 원칙은 다음과 같다.\n\n| 작업 유형 | 선택 기준 |\n|---|---|\n| 아키텍처 설계, 어려운 디버깅, 복잡한 추론 | 성능이 높은 모델을 우선 검토 |\n| 일반 구현, 테스트 작성, 반복적인 개발 | 성능과 속도의 균형이 좋은 모델 검토 |\n| 단순 검색, 형식 변환, 짧은 수정 | 계정에서 지원한다면 빠르고 경제적인 모델 검토 |\n\nOpus, Sonnet, Haiku는 모델 계열을 구분하는 이름이지만, 각 계열의 정확한 버전과 Claude Code 지원 여부는 계속 바뀔 수 있다. `/model sonnet`처럼 별칭을 사용할 수 있는 환경도 있지만 현재 세션에서 표시되는 선택지를 확인하는 것이 가장 정확하다.\n\n### 비용을 줄이는 실용적인 방법\n\n- 필요한 하위 디렉터리에서 실행해 불필요한 파일 탐색을 줄인다.\n- 요청에 목표, 제약, 완료 조건을 한 번에 명시해 재작업을 줄인다.\n- 큰 로그 전체보다 오류 주변과 재현 절차를 제공한다.\n- 생성 파일, 빌드 결과, 대형 데이터 등 불필요한 경로를 제외한다.\n- 탐색과 설계가 끝나면 새 작업 단위로 세션을 정리한다.\n- 간단한 작업은 사용 가능한 범위에서 더 빠르고 저렴한 모델로 처리한다.\n- API 기반 이용이라면 비용 관련 명령과 Anthropic Console의 사용량 정보를 함께 확인한다.\n\n비용 구조는 로그인 방식에 따라 다르다. Claude 구독 계정에는 플랜별 사용 한도가 적용될 수 있고, Anthropic API 또는 클라우드 제공업체를 통한 사용은 토큰 기반 청구가 적용될 수 있다. 따라서 특정 모델이 언제나 무료이거나 일정 금액만 든다고 가정해서는 안 된다.\n\n## 컨텍스트 윈도우 관리\n\n컨텍스트 윈도우는 현재 응답을 만들 때 모델이 참고할 수 있는 대화, 파일 내용, 도구 결과, 프로젝트 지침 등의 범위다. 이것은 영구 기억이나 단순한 대화 글자 수와 같지 않다.\n\n### 주요 명령\n\n| 명령 | 용도 | 주의점 |\n|---|---|---|\n| `/context` | 컨텍스트 사용 구성을 확인 | 표시 방식은 버전에 따라 달라질 수 있음 |\n| `/compact` | 현재 대화를 요약해 컨텍스트 공간을 확보 | 세부 정보가 요약 과정에서 축약될 수 있음 |\n| `/clear` | 현재 대화 기록을 지우고 새 대화를 시작 | 필요한 결정과 작업 상태를 먼저 문서에 남겨야 함 |\n\n컨텍스트가 특정 비율을 넘으면 반드시 답변 품질이 떨어진다는 보편적인 기준은 없다. Claude Code가 자동 압축을 수행할 수도 있고, 품질은 포함된 정보의 양뿐 아니라 관련성·중복·충돌 여부에도 영향을 받는다.\n\n다음 신호가 보이면 정리를 고려한다.\n\n- 이미 수정한 요구 사항을 반복해서 놓친다.\n- 오래된 파일 상태를 현재 상태로 오인한다.\n- 서로 다른 기능의 조건을 혼동한다.\n- 같은 파일을 불필요하게 반복해서 읽는다.\n- 대화와 도구 출력이 지나치게 길어졌다.\n\n기능 하나가 끝날 때마다 무조건 `/clear`를 실행할 필요는 없다. 대신 완료된 결정, 미해결 항목, 테스트 결과를 프로젝트 문서나 작업 기록에 남긴 뒤 새 세션으로 넘어가면 정보 손실을 줄일 수 있다.\n\n## CLAUDE.md로 프로젝트 지침 관리\n\n파일명은 일반적으로 대문자를 포함한 `CLAUDE.md`로 작성한다. 이 파일은 Claude의 영구 기억이 아니라, Claude Code가 프로젝트에서 참고하는 지속적인 지침 문서다. 저장소에 포함하면 팀원과 지침을 공유할 수 있지만, 민감한 정보는 기록하면 안 된다.\n\n`/init` 명령으로 프로젝트를 분석해 초기 `CLAUDE.md` 작성을 시작할 수 있으며, 결과는 반드시 사람이 검토해야 한다.\n\n### 포함하면 좋은 내용\n\n- 프로젝트의 목적과 핵심 기능\n- 사용 언어, 프레임워크, 런타임 버전\n- 중요한 디렉터리와 모듈의 역할\n- 설치, 개발 서버, 테스트, 린트, 빌드 명령\n- 코드 스타일과 네이밍 규칙\n- 수정하면 안 되는 파일이나 생성 코드\n- 보안·개인정보 처리 원칙\n- 작업 완료 조건과 검증 절차\n\n예시:\n\n```markdown\n# Project instructions\n\n## Stack\n- TypeScript와 Node.js를 사용한다.\n- 패키지 관리자는 pnpm이다.\n\n## Commands\n- 테스트: `pnpm test`\n- 린트: `pnpm lint`\n- 빌드: `pnpm build`\n\n## Rules\n- `.env`와 실제 자격 증명을 읽거나 커밋하지 않는다.\n- 공개 API의 응답 형식을 바꾸기 전에 먼저 계획을 제시한다.\n- 기능 변경에는 관련 테스트를 추가한다.\n```\n\n`CLAUDE.md`에 공식적인 최대 200줄 제한이 있는 것은 아니다. 그러나 너무 긴 지침은 컨텍스트를 소비하고 규칙 간 충돌을 만들 수 있으므로 짧고 구체적으로 유지하는 것이 실용적이다. 상세한 설계 설명은 별도 문서로 분리하고 필요한 경로를 안내한다.\n\n## 권장 작업 절차\n\n안전성과 결과 품질을 함께 높이는 기본 절차는 다음과 같다.\n\n1. Git 상태가 깨끗한지 확인하고 백업 또는 커밋을 만든다.\n2. 저장소 루트에서 Claude Code를 실행한다.\n3. `CLAUDE.md`와 기존 문서를 점검한다.\n4. Plan 모드에서 목표, 수정 파일, 테스트 계획을 받는다.\n5. 큰 작업을 검토 가능한 작은 단위로 나눈다.\n6. Default 또는 Accept Edits 모드에서 한 단위씩 구현한다.\n7. 설치·삭제·배포·데이터 변경 명령은 직접 검토한다.\n8. 테스트, 린트, 타입 검사와 `git diff`를 확인한다.\n9. 완료 상태와 남은 문제를 문서화한다.\n10. 다음 작업이 이전 대화와 무관하면 `/clear`로 새 세션을 시작한다.\n\n## 보안 체크리스트\n\n- `.env`, API 키, 인증서, 고객 데이터가 프롬프트나 저장소에 노출되지 않게 한다.\n- 프로덕션 서버와 데이터베이스에서 직접 실험하지 않는다.\n- 출처를 모르는 셸 명령이나 설치 스크립트는 실행 전에 읽어 본다.\n- Claude가 작성한 코드도 의존성, 라이선스, 보안 취약점과 테스트를 검토한다.\n- 중요한 작업에서는 최소 권한 원칙과 격리된 개발 환경을 적용한다.\n- 자동 생성된 변경은 Git diff로 확인하고 사람이 최종 책임을 진다.\n\nClaude Code는 개발 과정을 크게 단축할 수 있지만 결과의 정확성과 안전성을 보장하는 자동 장치는 아니다. 가장 안정적인 사용법은 명확한 지침, 제한된 권한, 작은 변경 단위, 자동 테스트와 사람의 검토를 결합하는 것이다.","content_html":"\u003cp\u003eClaude Code는 Anthropic의 Claude를 터미널과 코드 저장소에서 사용하는 에이전트형 개발 도구다. 단순히 코드 조각을 답변하는 데 그치지 않고, 허용된 범위 안에서 파일 탐색·편집, 명령 실행, 테스트와 오류 분석을 수행한다.\u003c/p\u003e\n\u003cp\u003e이 가이드는 설치 절차뿐 아니라 권한을 안전하게 설정하는 방법, 작업에 맞는 모델을 고르는 기준, 컨텍스트와 프로젝트 지침을 관리하는 방법을 설명한다. 명령과 지원 환경은 업데이트될 수 있으므로 실제 설치 시에는 공식 설정 문서에 표시되는 최신 명령을 확인해야 한다.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#claude%EB%A1%9C-%EC%BD%94%EB%94%A9%ED%95%98%EB%8A%94-%EC%84%B8-%EA%B0%80%EC%A7%80-%EB%B0%A9%EC%8B%9D\" class=\"anchor\" id=\"claude로-코딩하는-세-가지-방식\"\u003e\u003c/a\u003eClaude로 코딩하는 세 가지 방식\u003c/h2\u003e\n\u003cp\u003e각 방식은 결과물보다 \u003cstrong\u003e도구가 로컬 프로젝트와 상호작용하는 범위\u003c/strong\u003e에서 차이가 난다.\u003c/p\u003e\n\u003cdiv class=\"overflow-x-auto\"\u003e\u003ctable\u003e\n\u003cthead\u003e\n\u003ctr\u003e\n\u003cth\u003e방식\u003c/th\u003e\n\u003cth\u003e로컬 파일 접근\u003c/th\u003e\n\u003cth\u003e명령 실행\u003c/th\u003e\n\u003cth\u003e적합한 작업\u003c/th\u003e\n\u003cth\u003e주요 한계\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"방식\"\u003eClaude 웹\u003c/td\u003e\n\u003ctd data-label=\"로컬 파일 접근\"\u003e기본적으로 제한적\u003c/td\u003e\n\u003ctd data-label=\"명령 실행\"\u003e기본적으로 불가\u003c/td\u003e\n\u003ctd data-label=\"적합한 작업\"\u003e질문, 코드 설명, 짧은 예제, 설계 검토\u003c/td\u003e\n\u003ctd data-label=\"주요 한계\"\u003e답변을 프로젝트에 직접 반영하려면 복사와 실행이 필요함\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"방식\"\u003eClaude 데스크톱 앱\u003c/td\u003e\n\u003ctd data-label=\"로컬 파일 접근\"\u003e기능·연동·사용자 승인에 따라 다름\u003c/td\u003e\n\u003ctd data-label=\"명령 실행\"\u003e기능·연동에 따라 다름\u003c/td\u003e\n\u003ctd data-label=\"적합한 작업\"\u003e문서 작업, 대화 중심 업무, 지원되는 로컬 연동\u003c/td\u003e\n\u003ctd data-label=\"주요 한계\"\u003e모든 설치 환경에서 저장소와 셸을 자동 제어하는 것은 아님\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"방식\"\u003eClaude Code\u003c/td\u003e\n\u003ctd data-label=\"로컬 파일 접근\"\u003e프로젝트 범위에서 가능\u003c/td\u003e\n\u003ctd data-label=\"명령 실행\"\u003e권한 정책에 따라 가능\u003c/td\u003e\n\u003ctd data-label=\"적합한 작업\"\u003e실제 저장소 수정, 테스트, 리팩터링, 장기 프로젝트\u003c/td\u003e\n\u003ctd data-label=\"주요 한계\"\u003e셸과 파일 권한을 다루므로 검토와 보안 설정이 필요함\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\u003c/div\u003e\n\u003cp\u003eClaude Code가 전문 개발자만을 위한 것은 아니다. 다만 파일 삭제, 의존성 설치, 빌드 스크립트 실행처럼 시스템에 영향을 주는 작업이 가능하므로 초보자일수록 Plan 모드와 버전 관리를 함께 사용하는 것이 좋다.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#%EC%84%A4%EC%B9%98-%EC%A0%84-%EC%A4%80%EB%B9%84-%EC%82%AC%ED%95%AD\" class=\"anchor\" id=\"설치-전-준비-사항\"\u003e\u003c/a\u003e설치 전 준비 사항\u003c/h2\u003e\n\u003cp\u003e다음 항목을 먼저 준비한다.\u003c/p\u003e\n\u003cul\u003e\n\u003cli\u003e공식 문서에서 현재 지원되는 운영체제와 셸 환경을 확인한다.\u003c/li\u003e\n\u003cli\u003eClaude Code를 이용할 수 있는 Anthropic 계정 또는 지원되는 인증·결제 환경을 준비한다.\u003c/li\u003e\n\u003cli\u003e기존 프로젝트라면 Git 저장소를 만들고 변경 사항을 커밋하거나 백업한다.\u003c/li\u003e\n\u003cli\u003e프로젝트의 테스트, 빌드, 린트 명령을 파악한다.\u003c/li\u003e\n\u003cli\u003eVS Code 같은 편집기를 사용할 수 있지만, VS Code 자체가 Claude Code의 필수 조건은 아니다.\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003eWindows에서는 공식 문서가 안내하는 PowerShell, 명령 프롬프트 또는 WSL 조건을 확인해야 한다. 조직에서 관리하는 컴퓨터라면 설치 권한, 프록시, 방화벽, 데이터 처리 정책도 먼저 점검한다.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#claude-code-%EC%84%A4%EC%B9%98%EC%99%80-%EC%B2%AB-%EC%8B%A4%ED%96%89\" class=\"anchor\" id=\"claude-code-설치와-첫-실행\"\u003e\u003c/a\u003eClaude Code 설치와 첫 실행\u003c/h2\u003e\n\u003ch3\u003e\n\u003ca href=\"#1-%EA%B3%B5%EC%8B%9D-%EC%84%A4%EC%B9%98-%EB%AA%85%EB%A0%B9-%ED%99%95%EC%9D%B8\" class=\"anchor\" id=\"1-공식-설치-명령-확인\"\u003e\u003c/a\u003e1. 공식 설치 명령 확인\u003c/h3\u003e\n\u003cp\u003eClaude Code 공식 설정 문서에서 운영체제에 맞는 최신 설치 방법을 선택한다. 설치 방식과 명령은 변경될 수 있으므로 오래된 영상이나 블로그의 명령을 그대로 재사용하기보다 공식 문서를 기준으로 삼는다.\u003c/p\u003e\n\u003ch3\u003e\n\u003ca href=\"#2-%ED%94%84%EB%A1%9C%EC%A0%9D%ED%8A%B8-%ED%8F%B4%EB%8D%94-%EC%97%B4%EA%B8%B0\" class=\"anchor\" id=\"2-프로젝트-폴더-열기\"\u003e\u003c/a\u003e2. 프로젝트 폴더 열기\u003c/h3\u003e\n\u003cp\u003e새 폴더를 만들거나 기존 저장소로 이동한다. VS Code를 사용한다면 \u003cstrong\u003eFile \u0026gt; Open Folder\u003c/strong\u003e로 폴더를 연 다음 \u003cstrong\u003eTerminal \u0026gt; New Terminal\u003c/strong\u003e을 선택할 수 있다.\u003c/p\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003ecd\u003c/span\u003e\u003cspan\u003e path/to/project\n\u003c/span\u003e\u003cspan\u003eclaude\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003cp\u003e\u003ccode\u003eclaude\u003c/code\u003e를 실행하면 필요한 경우 브라우저 인증 절차가 표시된다. 로그인 후 Claude Code는 현재 작업 디렉터리를 기준으로 프로젝트를 파악한다. 따라서 홈 디렉터리나 지나치게 넓은 상위 폴더보다 실제 저장소의 루트에서 실행하는 편이 안전하다.\u003c/p\u003e\n\u003ch3\u003e\n\u003ca href=\"#3-%EC%B2%AB-%EC%9A%94%EC%B2%AD%EC%9D%80-%EC%9E%91%EA%B2%8C-%EC%8B%9C%EC%9E%91\" class=\"anchor\" id=\"3-첫-요청은-작게-시작\"\u003e\u003c/a\u003e3. 첫 요청은 작게 시작\u003c/h3\u003e\n\u003cp\u003e처음부터 전체 애플리케이션 제작을 맡기기보다 다음과 같이 범위를 나눈다.\u003c/p\u003e\n\u003col\u003e\n\u003cli\u003e프로젝트 구조를 읽고 요약하게 한다.\u003c/li\u003e\n\u003cli\u003e구현 계획과 변경 대상 파일을 제시하게 한다.\u003c/li\u003e\n\u003cli\u003e한 기능만 구현하게 한다.\u003c/li\u003e\n\u003cli\u003e테스트나 정적 분석을 실행하게 한다.\u003c/li\u003e\n\u003cli\u003e변경 내역과 남은 위험을 설명하게 한다.\u003c/li\u003e\n\u003c/ol\u003e\n\u003cp\u003e예시 요청:\u003c/p\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003e이 저장소를 읽고 구조와 실행 방법을 요약해 줘. 아직 파일은 수정하지 말고,\n\u003c/span\u003e\u003cspan\u003e로그인 폼을 추가하기 위한 계획과 변경 대상 파일만 제안해 줘.\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003ch2\u003e\n\u003ca href=\"#%EA%B6%8C%ED%95%9C-%EB%AA%A8%EB%93%9C%EC%99%80-%EC%95%88%EC%A0%84%ED%95%9C-%EC%84%A4%EC%A0%95\" class=\"anchor\" id=\"권한-모드와-안전한-설정\"\u003e\u003c/a\u003e권한 모드와 안전한 설정\u003c/h2\u003e\n\u003cp\u003eClaude Code의 권한 모드는 버전과 설정 화면에 따라 표시 문구가 달라질 수 있다. 공식 설정에서 사용하는 대표적인 모드 개념은 다음과 같다.\u003c/p\u003e\n\u003cdiv class=\"overflow-x-auto\"\u003e\u003ctable\u003e\n\u003cthead\u003e\n\u003ctr\u003e\n\u003cth\u003e모드\u003c/th\u003e\n\u003cth\u003e동작\u003c/th\u003e\n\u003cth\u003e권장 상황\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"모드\"\u003eDefault\u003c/td\u003e\n\u003ctd data-label=\"동작\"\u003e파일 수정이나 위험 가능성이 있는 도구 실행 시 필요에 따라 승인을 요청\u003c/td\u003e\n\u003ctd data-label=\"권장 상황\"\u003e일반적인 일상 작업\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"모드\"\u003eAccept Edits\u003c/td\u003e\n\u003ctd data-label=\"동작\"\u003e파일 편집은 자동으로 허용하되 다른 도구에는 별도 승인이 적용될 수 있음\u003c/td\u003e\n\u003ctd data-label=\"권장 상황\"\u003e변경 파일을 Git으로 추적하는 개발 작업\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"모드\"\u003ePlan\u003c/td\u003e\n\u003ctd data-label=\"동작\"\u003e파일을 수정하거나 명령을 실행하지 않고 분석과 계획에 집중\u003c/td\u003e\n\u003ctd data-label=\"권장 상황\"\u003e저장소 파악, 설계 검토, 초보자의 첫 단계\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"모드\"\u003eDon't Ask\u003c/td\u003e\n\u003ctd data-label=\"동작\"\u003e사전 허용되지 않은 작업을 질문하는 대신 거부하는 비대화형 정책\u003c/td\u003e\n\u003ctd data-label=\"권장 상황\"\u003e자동화 환경이나 엄격한 허용 목록을 사용할 때\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"모드\"\u003eBypass Permissions\u003c/td\u003e\n\u003ctd data-label=\"동작\"\u003e권한 확인 절차를 우회\u003c/td\u003e\n\u003ctd data-label=\"권장 상황\"\u003e격리된 컨테이너 등 위험을 통제한 환경 외에는 지양\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\u003c/div\u003e\n\u003cp\u003e\u003ccode\u003eShift+Tab\u003c/code\u003e은 대화형 화면에서 제공되는 일부 권한 상태를 전환하는 데 사용될 수 있다. 그러나 모든 설정이 반드시 이 단축키만으로 순환되는 것은 아니므로 현재 화면의 상태 표시와 공식 권한 문서를 확인해야 한다.\u003c/p\u003e\n\u003ch3\u003e\n\u003ca href=\"#%EC%B4%88%EB%B3%B4%EC%9E%90%EC%97%90%EA%B2%8C-%EA%B6%8C%EC%9E%A5%ED%95%98%EB%8A%94-%ED%9D%90%EB%A6%84\" class=\"anchor\" id=\"초보자에게-권장하는-흐름\"\u003e\u003c/a\u003e초보자에게 권장하는 흐름\u003c/h3\u003e\n\u003col\u003e\n\u003cli\u003ePlan 모드에서 구현 계획을 받는다.\u003c/li\u003e\n\u003cli\u003e변경 파일과 실행할 명령을 검토한다.\u003c/li\u003e\n\u003cli\u003eDefault 또는 Accept Edits 모드에서 구현한다.\u003c/li\u003e\n\u003cli\u003e패키지 설치, 데이터베이스 변경, 삭제 명령은 직접 확인한다.\u003c/li\u003e\n\u003cli\u003e\n\u003ccode\u003egit diff\u003c/code\u003e와 테스트 결과를 검토한 뒤 커밋한다.\u003c/li\u003e\n\u003c/ol\u003e\n\u003cp\u003eBypass Permissions는 단순히 편리한 고속 모드가 아니다. 잘못된 명령, 과도한 파일 접근, 비밀정보 노출의 피해를 키울 수 있으므로 개인 컴퓨터나 중요한 저장소에서 기본값으로 사용하지 않는다.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#%EB%AA%A8%EB%8D%B8-%EC%84%A0%ED%83%9D%EA%B3%BC-%EB%B9%84%EC%9A%A9-%EA%B4%80%EB%A6%AC\" class=\"anchor\" id=\"모델-선택과-비용-관리\"\u003e\u003c/a\u003e모델 선택과 비용 관리\u003c/h2\u003e\n\u003cp\u003e대화형 세션에서 \u003ccode\u003e/model\u003c/code\u003e을 사용하면 계정과 환경에서 선택 가능한 모델을 확인하거나 변경할 수 있다. 모델 이름과 별칭, 제공 여부는 시점과 인증 방식에 따라 달라질 수 있으므로 고정된 모델 목록을 전제로 자동화하지 않는 편이 좋다.\u003c/p\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003e/model\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003cp\u003e일반적인 선택 원칙은 다음과 같다.\u003c/p\u003e\n\u003cdiv class=\"overflow-x-auto\"\u003e\u003ctable\u003e\n\u003cthead\u003e\n\u003ctr\u003e\n\u003cth\u003e작업 유형\u003c/th\u003e\n\u003cth\u003e선택 기준\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"작업 유형\"\u003e아키텍처 설계, 어려운 디버깅, 복잡한 추론\u003c/td\u003e\n\u003ctd data-label=\"선택 기준\"\u003e성능이 높은 모델을 우선 검토\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"작업 유형\"\u003e일반 구현, 테스트 작성, 반복적인 개발\u003c/td\u003e\n\u003ctd data-label=\"선택 기준\"\u003e성능과 속도의 균형이 좋은 모델 검토\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"작업 유형\"\u003e단순 검색, 형식 변환, 짧은 수정\u003c/td\u003e\n\u003ctd data-label=\"선택 기준\"\u003e계정에서 지원한다면 빠르고 경제적인 모델 검토\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\u003c/div\u003e\n\u003cp\u003eOpus, Sonnet, Haiku는 모델 계열을 구분하는 이름이지만, 각 계열의 정확한 버전과 Claude Code 지원 여부는 계속 바뀔 수 있다. \u003ccode\u003e/model sonnet\u003c/code\u003e처럼 별칭을 사용할 수 있는 환경도 있지만 현재 세션에서 표시되는 선택지를 확인하는 것이 가장 정확하다.\u003c/p\u003e\n\u003ch3\u003e\n\u003ca href=\"#%EB%B9%84%EC%9A%A9%EC%9D%84-%EC%A4%84%EC%9D%B4%EB%8A%94-%EC%8B%A4%EC%9A%A9%EC%A0%81%EC%9D%B8-%EB%B0%A9%EB%B2%95\" class=\"anchor\" id=\"비용을-줄이는-실용적인-방법\"\u003e\u003c/a\u003e비용을 줄이는 실용적인 방법\u003c/h3\u003e\n\u003cul\u003e\n\u003cli\u003e필요한 하위 디렉터리에서 실행해 불필요한 파일 탐색을 줄인다.\u003c/li\u003e\n\u003cli\u003e요청에 목표, 제약, 완료 조건을 한 번에 명시해 재작업을 줄인다.\u003c/li\u003e\n\u003cli\u003e큰 로그 전체보다 오류 주변과 재현 절차를 제공한다.\u003c/li\u003e\n\u003cli\u003e생성 파일, 빌드 결과, 대형 데이터 등 불필요한 경로를 제외한다.\u003c/li\u003e\n\u003cli\u003e탐색과 설계가 끝나면 새 작업 단위로 세션을 정리한다.\u003c/li\u003e\n\u003cli\u003e간단한 작업은 사용 가능한 범위에서 더 빠르고 저렴한 모델로 처리한다.\u003c/li\u003e\n\u003cli\u003eAPI 기반 이용이라면 비용 관련 명령과 Anthropic Console의 사용량 정보를 함께 확인한다.\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003e비용 구조는 로그인 방식에 따라 다르다. Claude 구독 계정에는 플랜별 사용 한도가 적용될 수 있고, Anthropic API 또는 클라우드 제공업체를 통한 사용은 토큰 기반 청구가 적용될 수 있다. 따라서 특정 모델이 언제나 무료이거나 일정 금액만 든다고 가정해서는 안 된다.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#%EC%BB%A8%ED%85%8D%EC%8A%A4%ED%8A%B8-%EC%9C%88%EB%8F%84%EC%9A%B0-%EA%B4%80%EB%A6%AC\" class=\"anchor\" id=\"컨텍스트-윈도우-관리\"\u003e\u003c/a\u003e컨텍스트 윈도우 관리\u003c/h2\u003e\n\u003cp\u003e컨텍스트 윈도우는 현재 응답을 만들 때 모델이 참고할 수 있는 대화, 파일 내용, 도구 결과, 프로젝트 지침 등의 범위다. 이것은 영구 기억이나 단순한 대화 글자 수와 같지 않다.\u003c/p\u003e\n\u003ch3\u003e\n\u003ca href=\"#%EC%A3%BC%EC%9A%94-%EB%AA%85%EB%A0%B9\" class=\"anchor\" id=\"주요-명령\"\u003e\u003c/a\u003e주요 명령\u003c/h3\u003e\n\u003cdiv class=\"overflow-x-auto\"\u003e\u003ctable\u003e\n\u003cthead\u003e\n\u003ctr\u003e\n\u003cth\u003e명령\u003c/th\u003e\n\u003cth\u003e용도\u003c/th\u003e\n\u003cth\u003e주의점\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"명령\"\u003e\u003ccode\u003e/context\u003c/code\u003e\u003c/td\u003e\n\u003ctd data-label=\"용도\"\u003e컨텍스트 사용 구성을 확인\u003c/td\u003e\n\u003ctd data-label=\"주의점\"\u003e표시 방식은 버전에 따라 달라질 수 있음\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"명령\"\u003e\u003ccode\u003e/compact\u003c/code\u003e\u003c/td\u003e\n\u003ctd data-label=\"용도\"\u003e현재 대화를 요약해 컨텍스트 공간을 확보\u003c/td\u003e\n\u003ctd data-label=\"주의점\"\u003e세부 정보가 요약 과정에서 축약될 수 있음\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"명령\"\u003e\u003ccode\u003e/clear\u003c/code\u003e\u003c/td\u003e\n\u003ctd data-label=\"용도\"\u003e현재 대화 기록을 지우고 새 대화를 시작\u003c/td\u003e\n\u003ctd data-label=\"주의점\"\u003e필요한 결정과 작업 상태를 먼저 문서에 남겨야 함\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\u003c/div\u003e\n\u003cp\u003e컨텍스트가 특정 비율을 넘으면 반드시 답변 품질이 떨어진다는 보편적인 기준은 없다. Claude Code가 자동 압축을 수행할 수도 있고, 품질은 포함된 정보의 양뿐 아니라 관련성·중복·충돌 여부에도 영향을 받는다.\u003c/p\u003e\n\u003cp\u003e다음 신호가 보이면 정리를 고려한다.\u003c/p\u003e\n\u003cul\u003e\n\u003cli\u003e이미 수정한 요구 사항을 반복해서 놓친다.\u003c/li\u003e\n\u003cli\u003e오래된 파일 상태를 현재 상태로 오인한다.\u003c/li\u003e\n\u003cli\u003e서로 다른 기능의 조건을 혼동한다.\u003c/li\u003e\n\u003cli\u003e같은 파일을 불필요하게 반복해서 읽는다.\u003c/li\u003e\n\u003cli\u003e대화와 도구 출력이 지나치게 길어졌다.\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003e기능 하나가 끝날 때마다 무조건 \u003ccode\u003e/clear\u003c/code\u003e를 실행할 필요는 없다. 대신 완료된 결정, 미해결 항목, 테스트 결과를 프로젝트 문서나 작업 기록에 남긴 뒤 새 세션으로 넘어가면 정보 손실을 줄일 수 있다.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#claudemd%EB%A1%9C-%ED%94%84%EB%A1%9C%EC%A0%9D%ED%8A%B8-%EC%A7%80%EC%B9%A8-%EA%B4%80%EB%A6%AC\" class=\"anchor\" id=\"claudemd로-프로젝트-지침-관리\"\u003e\u003c/a\u003eCLAUDE.md로 프로젝트 지침 관리\u003c/h2\u003e\n\u003cp\u003e파일명은 일반적으로 대문자를 포함한 \u003ccode\u003eCLAUDE.md\u003c/code\u003e로 작성한다. 이 파일은 Claude의 영구 기억이 아니라, Claude Code가 프로젝트에서 참고하는 지속적인 지침 문서다. 저장소에 포함하면 팀원과 지침을 공유할 수 있지만, 민감한 정보는 기록하면 안 된다.\u003c/p\u003e\n\u003cp\u003e\u003ccode\u003e/init\u003c/code\u003e 명령으로 프로젝트를 분석해 초기 \u003ccode\u003eCLAUDE.md\u003c/code\u003e 작성을 시작할 수 있으며, 결과는 반드시 사람이 검토해야 한다.\u003c/p\u003e\n\u003ch3\u003e\n\u003ca href=\"#%ED%8F%AC%ED%95%A8%ED%95%98%EB%A9%B4-%EC%A2%8B%EC%9D%80-%EB%82%B4%EC%9A%A9\" class=\"anchor\" id=\"포함하면-좋은-내용\"\u003e\u003c/a\u003e포함하면 좋은 내용\u003c/h3\u003e\n\u003cul\u003e\n\u003cli\u003e프로젝트의 목적과 핵심 기능\u003c/li\u003e\n\u003cli\u003e사용 언어, 프레임워크, 런타임 버전\u003c/li\u003e\n\u003cli\u003e중요한 디렉터리와 모듈의 역할\u003c/li\u003e\n\u003cli\u003e설치, 개발 서버, 테스트, 린트, 빌드 명령\u003c/li\u003e\n\u003cli\u003e코드 스타일과 네이밍 규칙\u003c/li\u003e\n\u003cli\u003e수정하면 안 되는 파일이나 생성 코드\u003c/li\u003e\n\u003cli\u003e보안·개인정보 처리 원칙\u003c/li\u003e\n\u003cli\u003e작업 완료 조건과 검증 절차\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003e예시:\u003c/p\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003e# Project instructions\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003e## Stack\n\u003c/span\u003e\u003cspan\u003e- TypeScript와 Node.js를 사용한다.\n\u003c/span\u003e\u003cspan\u003e- 패키지 관리자는 pnpm이다.\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003e## Commands\n\u003c/span\u003e\u003cspan\u003e- 테스트: \u003c/span\u003e\u003cspan\u003e`pnpm test`\n\u003c/span\u003e\u003cspan\u003e- 린트: \u003c/span\u003e\u003cspan\u003e`pnpm lint`\n\u003c/span\u003e\u003cspan\u003e- 빌드: \u003c/span\u003e\u003cspan\u003e`pnpm build`\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003e## Rules\n\u003c/span\u003e\u003cspan\u003e- \u003c/span\u003e\u003cspan\u003e`.env`\u003c/span\u003e\u003cspan\u003e와 실제 자격 증명을 읽거나 커밋하지 않는다.\n\u003c/span\u003e\u003cspan\u003e- 공개 API의 응답 형식을 바꾸기 전에 먼저 계획을 제시한다.\n\u003c/span\u003e\u003cspan\u003e- 기능 변경에는 관련 테스트를 추가한다.\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003cp\u003e\u003ccode\u003eCLAUDE.md\u003c/code\u003e에 공식적인 최대 200줄 제한이 있는 것은 아니다. 그러나 너무 긴 지침은 컨텍스트를 소비하고 규칙 간 충돌을 만들 수 있으므로 짧고 구체적으로 유지하는 것이 실용적이다. 상세한 설계 설명은 별도 문서로 분리하고 필요한 경로를 안내한다.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#%EA%B6%8C%EC%9E%A5-%EC%9E%91%EC%97%85-%EC%A0%88%EC%B0%A8\" class=\"anchor\" id=\"권장-작업-절차\"\u003e\u003c/a\u003e권장 작업 절차\u003c/h2\u003e\n\u003cp\u003e안전성과 결과 품질을 함께 높이는 기본 절차는 다음과 같다.\u003c/p\u003e\n\u003col\u003e\n\u003cli\u003eGit 상태가 깨끗한지 확인하고 백업 또는 커밋을 만든다.\u003c/li\u003e\n\u003cli\u003e저장소 루트에서 Claude Code를 실행한다.\u003c/li\u003e\n\u003cli\u003e\n\u003ccode\u003eCLAUDE.md\u003c/code\u003e와 기존 문서를 점검한다.\u003c/li\u003e\n\u003cli\u003ePlan 모드에서 목표, 수정 파일, 테스트 계획을 받는다.\u003c/li\u003e\n\u003cli\u003e큰 작업을 검토 가능한 작은 단위로 나눈다.\u003c/li\u003e\n\u003cli\u003eDefault 또는 Accept Edits 모드에서 한 단위씩 구현한다.\u003c/li\u003e\n\u003cli\u003e설치·삭제·배포·데이터 변경 명령은 직접 검토한다.\u003c/li\u003e\n\u003cli\u003e테스트, 린트, 타입 검사와 \u003ccode\u003egit diff\u003c/code\u003e를 확인한다.\u003c/li\u003e\n\u003cli\u003e완료 상태와 남은 문제를 문서화한다.\u003c/li\u003e\n\u003cli\u003e다음 작업이 이전 대화와 무관하면 \u003ccode\u003e/clear\u003c/code\u003e로 새 세션을 시작한다.\u003c/li\u003e\n\u003c/ol\u003e\n\u003ch2\u003e\n\u003ca href=\"#%EB%B3%B4%EC%95%88-%EC%B2%B4%ED%81%AC%EB%A6%AC%EC%8A%A4%ED%8A%B8\" class=\"anchor\" id=\"보안-체크리스트\"\u003e\u003c/a\u003e보안 체크리스트\u003c/h2\u003e\n\u003cul\u003e\n\u003cli\u003e\n\u003ccode\u003e.env\u003c/code\u003e, API 키, 인증서, 고객 데이터가 프롬프트나 저장소에 노출되지 않게 한다.\u003c/li\u003e\n\u003cli\u003e프로덕션 서버와 데이터베이스에서 직접 실험하지 않는다.\u003c/li\u003e\n\u003cli\u003e출처를 모르는 셸 명령이나 설치 스크립트는 실행 전에 읽어 본다.\u003c/li\u003e\n\u003cli\u003eClaude가 작성한 코드도 의존성, 라이선스, 보안 취약점과 테스트를 검토한다.\u003c/li\u003e\n\u003cli\u003e중요한 작업에서는 최소 권한 원칙과 격리된 개발 환경을 적용한다.\u003c/li\u003e\n\u003cli\u003e자동 생성된 변경은 Git diff로 확인하고 사람이 최종 책임을 진다.\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003eClaude Code는 개발 과정을 크게 단축할 수 있지만 결과의 정확성과 안전성을 보장하는 자동 장치는 아니다. 가장 안정적인 사용법은 명확한 지침, 제한된 권한, 작은 변경 단위, 자동 테스트와 사람의 검토를 결합하는 것이다.\u003c/p\u003e\n","tags":["Claude Code","Anthropic","AI 코딩","개발 도구","CLI"],"faqs":[{"question":"Claude Code를 사용하려면 VS Code가 반드시 필요한가요?","answer":"아니다. VS Code의 통합 터미널을 이용하면 편리하지만 필수 조건은 아니다. 공식 문서에서 지원하는 운영체제와 터미널 환경을 갖췄다면 프로젝트 디렉터리에서 `claude`를 실행할 수 있다."},{"question":"Claude 웹과 Claude Code의 가장 큰 차이는 무엇인가요?","answer":"Claude 웹은 주로 대화와 코드 답변을 제공하는 반면, Claude Code는 허용된 범위에서 실제 프로젝트 파일을 읽고 수정하며 터미널 도구를 실행할 수 있다. 그만큼 생산성이 높지만 파일과 명령 권한을 신중하게 관리해야 한다."},{"question":"초보자는 어떤 권한 모드로 시작해야 하나요?","answer":"먼저 Plan 모드에서 변경 계획과 대상 파일을 검토한 뒤 Default 또는 Accept Edits 모드로 구현하는 흐름이 안전하다. 패키지 설치, 파일 삭제, 데이터베이스 변경 같은 작업은 자동 승인하지 않는 편이 좋다."},{"question":"Don't Ask 모드는 모든 작업을 자동 실행하는 모드인가요?","answer":"아니다. Don't Ask는 일반적으로 사전 허용되지 않은 작업을 사용자에게 질문하는 대신 거부하는 정책이다. 권한 확인을 모두 우회하는 Bypass Permissions와 구분해야 한다."},{"question":"Claude Code에서 모델은 어떻게 변경하나요?","answer":"대화형 세션에서 `/model`을 입력해 현재 계정과 환경에서 사용할 수 있는 모델을 확인하고 선택한다. 모델 버전과 별칭은 변경될 수 있으므로 오래된 목록보다 현재 메뉴를 기준으로 삼아야 한다."},{"question":"Sonnet을 사용하면 항상 비용이 가장 적게 드나요?","answer":"항상 그렇지는 않다. 비용은 모델 단가뿐 아니라 입력 컨텍스트, 출력 길이, 재시도 횟수, 캐시 활용, 인증과 결제 방식에 따라 달라진다. 단순 작업에는 더 경제적인 모델이 유리할 수 있지만, 어려운 작업에서는 성능이 높은 모델이 재작업을 줄여 전체 비용을 낮출 수도 있다."},{"question":"/clear와 /compact의 차이는 무엇인가요?","answer":"`/clear`는 현재 대화 기록을 지우고 새 세션처럼 시작할 때 사용한다. `/compact`는 기존 대화를 요약해 컨텍스트 공간을 확보하지만, 요약 과정에서 일부 세부 정보가 축약될 수 있다."},{"question":"컨텍스트가 80%를 넘으면 답변 품질이 반드시 나빠지나요?","answer":"그런 보편적인 공식 임계치는 없다. 품질은 사용 비율 외에도 정보의 관련성, 반복, 충돌과 도구 출력의 크기에 영향을 받는다. `/context`로 상태를 살피고 오래된 요구 사항을 혼동하는 등의 신호가 나타날 때 정리하는 편이 합리적이다."},{"question":"파일 이름은 claude.md와 CLAUDE.md 중 무엇이 맞나요?","answer":"프로젝트 지침 파일은 공식 문서에서 `CLAUDE.md`로 표기한다. 대소문자를 구분하는 운영체제와 도구가 있으므로 공식 표기를 그대로 사용하는 것이 안전하다."},{"question":"CLAUDE.md는 200줄 이하여야 하나요?","answer":"공식적인 200줄 최대 제한이 있는 것은 아니다. 다만 긴 지침은 컨텍스트를 더 사용하고 규칙 충돌을 일으킬 수 있으므로 핵심 명령과 제약을 간결하게 적고 상세 설명은 별도 문서로 분리하는 것이 좋다."},{"question":"CLAUDE.md에 API 키나 비밀번호를 적어도 되나요?","answer":"안 된다. CLAUDE.md는 저장소에 커밋되어 팀과 공유될 수 있으므로 실제 자격 증명, 고객 데이터, 비밀키를 기록하지 않아야 한다. 비밀정보는 조직이 승인한 환경 변수나 비밀 관리 시스템으로 관리해야 한다."},{"question":"Bypass Permissions는 언제 사용해야 하나요?","answer":"권한 우회로 인한 피해를 제한할 수 있는 격리된 컨테이너나 일회성 샌드박스처럼 통제된 환경에서만 신중하게 검토해야 한다. 개인 컴퓨터, 중요한 저장소, 프로덕션 환경에서는 기본 모드로 사용하지 않는 것이 바람직하다."}],"sources":[{"url":"https://code.claude.com/docs/en/overview","title":"Claude Code overview","type":"source"},{"url":"https://code.claude.com/docs/en/setup","title":"Claude Code setup","type":"source"},{"url":"https://code.claude.com/docs/en/permissions","title":"Claude Code permissions","type":"source"},{"url":"https://code.claude.com/docs/en/model-config","title":"Claude Code model configuration","type":"source"},{"url":"https://code.claude.com/docs/en/costs","title":"Claude Code costs","type":"source"},{"url":"https://code.claude.com/docs/en/memory","title":"Claude Code memory and CLAUDE.md","type":"source"},{"url":"https://code.claude.com/docs/en/interactive-mode","title":"Claude Code interactive mode","type":"source"}],"images":[{"id":617,"url":"https://injoys.com/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6NzQ0NCwicHVyIjoiYmxvYl9pZCJ9fQ==--d808896af034f2719d1a1a65b061553a991d3196/ai-572421ed.webp","is_representative":true,"generation_method":"ai_image","license":"ai_generated","mime_type":"image/webp","translations":{"ko":{"alt":"코드가 표시된 노트북과 파일 트리, 권한 방패, 연결된 작업 흐름을 그린 일러스트","caption":"코드 작업에서 파일, 권한, 컨텍스트가 연결되는 구조를 시각화합니다.","description":null},"en":{"alt":"Illustration of a coding laptop, file tree, permission shield, and connected workflow","caption":"The diagram visualizes how files, permissions, and context connect in a coding workflow.","description":null},"ja":{"alt":"コード画面のノートPC、ファイルツリー、権限シールド、連携ワークフローのイラスト","caption":"コーディング作業でファイル、権限、コンテキストが連携する仕組みを示しています。","description":null},"es":{"alt":"Ilustración de un portátil con código, árbol de archivos, escudo de permisos y flujo conectado","caption":"El diagrama muestra cómo se conectan archivos, permisos y contexto en un flujo de programación.","description":null},"id":{"alt":"Ilustrasi laptop berkode, pohon file, perisai izin, dan alur kerja yang terhubung","caption":"Diagram ini memvisualisasikan hubungan file, izin, dan konteks dalam alur kerja pemrograman.","description":null},"pt":{"alt":"Ilustração de notebook com código, árvore de arquivos, escudo de permissões e fluxo conectado","caption":"O diagrama mostra como arquivos, permissões e contexto se conectam em um fluxo de programação.","description":null},"zh-hant":{"alt":"顯示程式碼的筆電、檔案樹、權限盾牌與連接工作流程的插圖","caption":"此圖呈現程式開發流程中檔案、權限與上下文的連結方式。","description":null},"de":{"alt":"Illustration eines Laptops mit Code, Dateibaum, Berechtigungsschild und vernetztem Arbeitsablauf","caption":"Die Grafik zeigt, wie Dateien, Berechtigungen und Kontext in einem Programmierablauf verbunden sind.","description":null}}},{"id":618,"url":"https://injoys.com/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6NzQ1MCwicHVyIjoiYmxvYl9pZCJ9fQ==--e073adddcaf8ad6bf81bc0a0b0ca1d385d6d6a38/ai-c02b920d.webp","is_representative":false,"generation_method":"ai_image","license":"ai_generated","mime_type":"image/webp","translations":{"ko":{"alt":"중앙 서버에 코드, 권한 잠금, 워크플로, 문서, 데이터베이스, 클라우드가 연결된 그림","caption":"Claude Code의 코드 실행, 권한, 컨텍스트와 데이터 연결 구조를 시각화한 그림입니다.","description":null},"en":{"alt":"Central server linked to code, permission lock, workflow, documents, databases, and cloud services","caption":"The illustration visualizes how Claude Code connects execution, permissions, context, and data.","description":null},"ja":{"alt":"中央サーバーにコード、権限ロック、ワークフロー、文書、データベース、クラウドが接続された図","caption":"Claude Codeにおけるコード実行、権限、コンテキスト、データの連携を表しています。","description":null},"es":{"alt":"Servidor central conectado con código, permisos, flujos, documentos, bases de datos y nube","caption":"La ilustración representa la conexión entre ejecución, permisos, contexto y datos en Claude Code.","description":null},"id":{"alt":"Server pusat terhubung ke kode, kunci izin, alur kerja, dokumen, basis data, dan cloud","caption":"Ilustrasi ini menunjukkan hubungan eksekusi, izin, konteks, dan data dalam Claude Code.","description":null},"pt":{"alt":"Servidor central ligado a código, bloqueio de permissões, fluxos, documentos, bancos de dados e nuvem","caption":"A ilustração mostra a conexão entre execução, permissões, contexto e dados no Claude Code.","description":null},"zh-hant":{"alt":"中央伺服器連接程式碼、權限鎖、工作流程、文件、資料庫與雲端服務","caption":"此圖呈現 Claude Code 中程式執行、權限、上下文與資料的連接關係。","description":null},"de":{"alt":"Zentraler Server mit Code, Zugriffssperre, Abläufen, Dokumenten, Datenbanken und Cloud-Diensten","caption":"Die Grafik zeigt das Zusammenspiel von Ausführung, Berechtigungen, Kontext und Daten in Claude Code.","description":null}}},{"id":619,"url":"https://injoys.com/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6NzQ1NiwicHVyIjoiYmxvYl9pZCJ9fQ==--c00d4710665dc3ff22efd09162384cd883bd9fdc/ai-5fe9a4da.webp","is_representative":false,"generation_method":"ai_infographic","license":"ai_generated","mime_type":"image/webp","visible_locales":["ko"],"translations":{"ko":{"alt":"Claude Code의 시작, 권한, 모델 비용, 컨텍스트, CLAUDE.md를 설명하는 기초 가이드 인포그래픽","caption":"Claude Code 사용법을 다섯 단계와 백업·계획·수정·테스트·기록 흐름으로 정리한 안내입니다.","description":null},"en":{"alt":"Claude Code basics infographic covering setup, permissions, model costs, context, and CLAUDE.md","caption":"The guide summarizes Claude Code in five sections and shows a backup-to-documentation workflow.","description":null},"ja":{"alt":"Claude Codeの開始、権限、モデル費用、コンテキスト、CLAUDE.mdを解説する基礎ガイド","caption":"Claude Codeの基本を5項目とバックアップから記録までの流れで整理しています。","description":null},"es":{"alt":"Guía visual de Claude Code sobre inicio, permisos, costes de modelos, contexto y CLAUDE.md","caption":"La guía resume Claude Code en cinco secciones y un flujo desde la copia de seguridad hasta el registro.","description":null},"id":{"alt":"Infografik dasar Claude Code tentang mulai, izin, biaya model, konteks, dan CLAUDE.md","caption":"Panduan ini merangkum Claude Code dalam lima bagian serta alur dari pencadangan hingga dokumentasi.","description":null},"pt":{"alt":"Guia visual do Claude Code sobre início, permissões, custos de modelos, contexto e CLAUDE.md","caption":"O guia resume o Claude Code em cinco seções e mostra um fluxo do backup ao registro.","description":null},"zh-hant":{"alt":"Claude Code 基礎指南，涵蓋啟動、權限、模型成本、上下文與 CLAUDE.md","caption":"圖表以五個部分整理 Claude Code，並呈現從備份到記錄的工作流程。","description":null},"de":{"alt":"Claude-Code-Grundlagen zu Einstieg, Berechtigungen, Modellkosten, Kontext und CLAUDE.md","caption":"Die Grafik fasst Claude Code in fünf Bereichen und einem Ablauf von der Sicherung bis zur Dokumentation zusammen.","description":null}}}],"published_at":"2026-08-13T12:12:59+09:00","updated_at":"2026-08-13T12:12:59+09:00","license":"cc_by","translation_status":"original","available_locales":["ko","en","ja","es"],"data_locales":["ko","en","ja","es","id","pt","zh-hant","de"],"url":"https://injoys.com/ko/articles/claude-code-setup-permissions-models-context-guide"}