Claude Code 사용 가이드
2026-10-20 공식 자료를 확인한 요약본입니다. 항목별 상세 해설은 중국어판에 수록되어 있습니다.
컨텍스트와 실행 위치
Claude Code는 모델, 정보와 도구를 결합합니다. CLI, IDE, 데스크톱과 클라우드가 같은 환경변수나 인증을 읽는다고 가정하지 않습니다.
다섯 가지 원칙
목표, 범위, 근거, 인수 기준을 제시합니다. 실질적인 설계 선택이 있을 때 계획하고 필요한 수정을 검증합니다. 구현 요청은 배포나 메시지 전송의 포괄적 허가가 아닙니다.
변경 사항과 로컬 버전
공식 변경 기록은 2026-10-19의 2.1.304를 확인했습니다. 로컬은 2.1.283이며 업그레이드하지 않았습니다. 새 기능을 로컬 지원으로 단정하지 않습니다.
설치와 확인
OS별 공식 경로를 사용합니다. 네이티브 설치와 Homebrew는 업데이트 방식이 다르며 Windows와 WSL은 도구와 격리 지원이 다릅니다. 로그인 후 /status를 확인합니다.
명령 참고
claude -p는 비대화형입니다. JSON과 stream-json을 구분하고 스키마, 예산, 권한 플래그는 --help를 봅니다. /status는 설정 출처를 표시하지만 키별 최종 출처는 아닙니다.
입력과 단축키
Esc는 중단, Ctrl+O는 기록 펼치기입니다. 모드 전환과 여러 줄 입력은 터미널 설정에 따라 달라 공식 대화 가이드와 호스트 충돌을 확인합니다.
필요에 맞는 확장
규칙은 CLAUDE.md, 절차는 Skills, 외부 도구는 MCP, 독립 탐색은 하위 에이전트, 이벤트는 Hooks, 배포는 플러그인으로 구분합니다.
확장 설정 관계
스킬 frontmatter, Hook 실패 처리, MCP 전송과 OAuth, 역할별 모델과 도구를 확인합니다. 공유 .mcp.json과 개인 설정의 범위는 다르며 옛 중첩·한도 수치를 복사하지 않습니다.
사용량과 비용
/usage와 /context는 다른 지표입니다. 구독이 Console이나 클라우드 API를 무료로 만들지 않으며 /compact는 사용량을 환급하지 않습니다.
이미지, Artifacts, 컴퓨터 조작
웹 Artifacts와 터미널 도구는 다릅니다. 도구, 계정과 실행 컴퓨터를 확인하고 요청한 파일 형식과 상호작용을 검증합니다.
여덟 가지 실무 시나리오
저장소 탐색, 장애 분석, 수정, 기능, 리팩터링, 리뷰, 문서와 CI에는 서로 다른 근거가 필요합니다. 현재 소스와 목표 동작을 검증합니다.
컨텍스트와 메모리
안정적인 규칙은 CLAUDE.md와 rules에 저장합니다. 자동 메모리와 압축은 오래되거나 일부 누락될 수 있으며 새 대화도 한도를 초기화하지 않습니다.
권한과 격리
도구 규칙과 OS 격리는 별개입니다. deny가 allow보다 우선합니다. 현재 auto와 bypassPermissions 기본값은 프로젝트/local 파일에서 활성화할 수 없습니다.
설정과 인증
관리 설정, --settings, 프로젝트 local, 공유 프로젝트, 사용자 순입니다. 환경변수 우선순위는 키별로 다릅니다. 구독, Console, API, 클라우드와 기업 게이트웨이를 구분합니다.
다른 도구와 협업
같은 비교 기준으로 구현자와 리뷰어를 정합니다. 설정과 Hook을 기계적으로 복사하지 않고 claude import codex --dry-run으로 변환을 미리 검토합니다.
자주 하는 실수
설정 삭제나 재로그인 전에 버전과 출처를 확인합니다. URL 변경은 비용이나 자격 증명을 고르지 않습니다. 직접 만든 local 설정의 Git 제외도 확인합니다.
작업 요청 템플릿
목표, 허용 범위, 불변 조건, 근거와 검증을 명시합니다. 리뷰 전용이면 수정 금지와 비교 기준을 함께 제공합니다.
자료와 검증 범위
2026-10-20 공식 자료와 로컬 도움말을 확인했습니다. 개인 설정, 인증, 제공자, 권한과 설치 버전은 변경하지 않았습니다. 실제 연결은 대상 환경 검증이 필요합니다.