​

Claude Code 문서 지도

모든 Claude Code 문서 페이지와 제목을 포함한 포괄적인 지도로, LLM이 쉽게 탐색할 수 있도록 설계되었습니다.

참고: 이 파일은 GitHub Actions에 의해 자동으로 생성됩니다. 수동으로 편집하지 마십시오. 마지막 업데이트: 2026.02.05 18:34:06 UTC

​

문서 구조

이 지도는 계층적 구조를 사용합니다:

• ## 문서 그룹을 표시합니다 (예: ‘시작하기’)
• ### 개별 문서 페이지를 표시합니다
• 중첩된 글머리 기호 각 페이지 내의 제목 구조를 표시합니다
• 각 페이지 제목은 전체 문서로 연결됩니다

​

시작하기

​

overview

• 30초 안에 시작하기
• Claude Code가 당신을 위해 하는 일
• 개발자들이 Claude Code를 사랑하는 이유
• 어디서나 Claude Code 사용하기
• 다음 단계
• 추가 리소스

​

quickstart

• 시작하기 전에
• 단계 1: Claude Code 설치
• 단계 2: 계정에 로그인
• 단계 3: 첫 번째 세션 시작
• 단계 4: 첫 번째 질문 하기
• 단계 5: 첫 번째 코드 변경 하기
• 단계 6: Claude Code와 함께 Git 사용하기
• 단계 7: 버그 수정 또는 기능 추가
• 단계 8: 다른 일반적인 워크플로우 시도해보기
• 필수 명령어
• 초보자를 위한 팁
• 다음은 무엇인가요?
• 도움말 받기

​

changelog

• (제목 없음)

​

핵심 개념

​

how-claude-code-works

• 에이전트 루프
  • 모델
  • 도구
• Claude가 접근할 수 있는 것
• 세션으로 작업하기
  • 브랜치 간 작업
  • 세션 재개 또는 포크
  • context window
    • context가 가득 찼을 때
    • skills 및 subagents로 context 관리
• checkpoints 및 권한으로 안전하게 유지
  • checkpoints로 변경 사항 취소
  • Claude가 할 수 있는 것 제어
• Claude Code와 효과적으로 작업하기
  • Claude Code에 도움 요청하기
  • 대화입니다
    • 중단 및 방향 조정
  • 처음부터 구체적으로
  • Claude에게 검증할 것을 제공하기
  • 구현하기 전에 탐색하기
  • 지시하지 말고 위임하기
• 다음은 무엇인가요?

​

features-overview

• 개요
• 기능을 목표에 맞추기
  • 유사한 기능 비교
  • 기능이 어떻게 계층화되는지 이해
  • 기능 결합
• context 비용 이해
  • 기능별 context 비용
  • 기능이 어떻게 로드되는지 이해
• 자세히 알아보기

​

common-workflows

• 새로운 코드베이스 이해하기
  • 빠른 코드베이스 개요 얻기
  • 관련 코드 찾기
• 효율적으로 버그 수정하기
• 코드 리팩토링
• 특화된 subagents 사용하기
• Plan Mode를 사용한 안전한 코드 분석
  • Plan Mode를 사용할 때
  • Plan Mode 사용 방법
  • 예: 복잡한 리팩토링 계획
  • Plan Mode를 기본값으로 구성
• 테스트로 작업하기
• pull requests 생성
• 문서 처리
• 이미지로 작업하기
• 파일 및 디렉토리 참조
• 확장 사고 사용 (thinking mode)
  • thinking mode 구성
  • 확장 사고가 어떻게 작동하는지
• 이전 대화 재개
  • 세션 이름 지정
  • 세션 선택기 사용
• Git worktrees를 사용하여 병렬 Claude Code 세션 실행
• Claude를 unix 스타일 유틸리티로 사용
  • 검증 프로세스에 Claude 추가
  • 파이프 인, 파이프 아웃
  • 출력 형식 제어
• Claude의 기능에 대해 물어보기
  • 예제 질문
• 다음 단계

​

best-practices

• Claude에게 작업을 검증할 방법 제공
• 먼저 탐색한 다음 계획한 다음 코드 작성
• 프롬프트에서 구체적인 context 제공
  • 풍부한 콘텐츠 제공
• 환경 구성
  • 효과적인 CLAUDE.md 작성
  • 권한 구성
  • CLI 도구 사용
  • MCP servers 연결
  • hooks 설정
  • skills 생성
  • 사용자 정의 subagents 생성
  • plugins 설치
• 효과적으로 소통하기
  • 코드베이스 질문 하기
  • Claude가 당신을 인터뷰하도록 하기
• 세션 관리
  • 조기에 자주 방향 수정
  • context를 적극적으로 관리
  • 조사를 위해 subagents 사용
  • checkpoints로 되감기
  • 대화 재개
• 자동화 및 확장
  • headless mode 실행
  • 여러 Claude 세션 실행
  • 파일 간 분산
  • Safe Autonomous Mode
• 일반적인 실패 패턴 피하기
• 직관 개발
• 관련 리소스

​

터미널 외부

​

claude-code-on-the-web

• Claude Code on the web이란?
• Claude Code on the web을 누가 사용할 수 있나요?
• 시작하기
• 작동 방식
• diff view로 변경 사항 검토
• 웹과 터미널 간 작업 이동
  • 터미널에서 웹으로
    • 백그라운드 작업 팁
  • 웹에서 터미널로
    • 텔레포팅 요구 사항
  • 세션 공유
    • Enterprise 또는 Teams 계정에서 공유
    • Max 또는 Pro 계정에서 공유
• Cloud 환경
  • 기본 이미지
    • 사용 가능한 도구 확인
    • 언어별 설정
    • 데이터베이스
  • 환경 구성
  • 종속성 관리
    • 로컬 vs 원격 실행
    • 환경 변수 유지
• 네트워크 접근 및 보안
  • 네트워크 정책
    • GitHub 프록시
    • 보안 프록시
  • 접근 수준
  • 기본 허용 도메인
    • Anthropic Services
    • Version Control
    • Container Registries
    • Cloud Platforms
    • Package Managers - JavaScript/Node
    • Package Managers - Python
    • Package Managers - Ruby
    • Package Managers - Rust
    • Package Managers - Go
    • Package Managers - JVM
    • Package Managers - Other Languages
    • Linux Distributions
    • Development Tools & Platforms
    • Cloud Services & Monitoring
    • Content Delivery & Mirrors
    • Schema & Configuration
    • Model Context Protocol
  • 사용자 정의 네트워크 접근을 위한 보안 모범 사례
• 보안 및 격리
• 가격 및 속도 제한
• 제한 사항
• 모범 사례
• 관련 리소스

​

desktop

• 설치 및 설정
• 시작하기
• 할 수 있는 것
  • 권한 모드 선택
  • 세션으로 병렬 작업
  • 원격으로 장기 실행 작업 실행
  • diff view로 변경 사항 검토
• Claude Code 확장
  • 외부 도구 연결
  • 사용자 정의 skills 생성
  • hooks로 워크플로우 자동화
• 환경 구성
• Desktop이 CLI와 어떻게 관련되는지
  • CLI 플래그 동등물
  • 공유 구성
  • 다른 점
• 문제 해결
  • 버전 확인
  • CLI에서 열 때 “Branch doesn’t exist yet”
  • “Failed to load session” 오류
  • 앱이 종료되지 않음
  • Windows 설치 문제
  • 세션이 설치된 도구를 찾지 못함
  • MCP servers가 작동하지 않음 (Windows)
  • Git LFS 오류
• Enterprise 구성
• 관련 리소스

​

chrome

• 기능
• 전제 조건
• CLI에서 시작하기
  • 기본적으로 Chrome 활성화
  • 사이트 권한 관리
• 예제 워크플로우
  • 로컬 웹 애플리케이션 테스트
  • 콘솔 로그로 디버깅
  • 양식 채우기 자동화
  • Google Docs에서 콘텐츠 작성
  • 웹 페이지에서 데이터 추출
  • 다중 사이트 워크플로우 실행
  • 데모 GIF 녹화
• 문제 해결
  • 확장 프로그램이 감지되지 않음
  • 브라우저가 응답하지 않음
  • 긴 세션 중 연결 끊김
  • Windows 특정 문제
  • 일반적인 오류 메시지
• 참고 항목

​

vs-code

• 전제 조건
• 확장 프로그램 설치
• 시작하기
• 프롬프트 상자 사용
  • 파일 및 폴더 참조
  • 이전 대화 재개
  • Claude.ai에서 원격 세션 재개
• 워크플로우 사용자 정의
  • Claude가 어디에 있을지 선택
  • 여러 대화 실행
  • 터미널 모드로 전환
• plugins 관리
  • plugins 설치
  • marketplaces 관리
• Chrome으로 브라우저 작업 자동화
• VS Code 명령어 및 단축키
• 설정 구성
  • 확장 프로그램 설정
• VS Code 확장 프로그램 vs. Claude Code CLI
  • checkpoints로 되감기
  • VS Code에서 CLI 실행
  • 확장 프로그램과 CLI 간 전환
  • 프롬프트에 터미널 출력 포함
  • 백그라운드 프로세스 모니터링
  • MCP로 외부 도구 연결
• git으로 작업
  • commits 및 pull requests 생성
  • 병렬 작업을 위해 git worktrees 사용
• 타사 제공자 사용
• 보안 및 개인정보 보호
• 일반적인 문제 해결
  • 확장 프로그램이 설치되지 않음
  • Spark 아이콘이 보이지 않음
  • Claude Code가 응답하지 않음
• 확장 프로그램 제거
• 다음 단계

​

jetbrains

• 지원되는 IDE
• 기능
• 설치
  • Marketplace 설치
• 사용
  • IDE에서
  • 외부 터미널에서
• 구성
  • Claude Code 설정
  • Plugin 설정
    • 일반 설정
    • ESC 키 구성
• 특수 구성
  • 원격 개발
  • WSL 구성
• 문제 해결
  • Plugin이 작동하지 않음
  • IDE가 감지되지 않음
  • 명령어를 찾을 수 없음
• 보안 고려 사항

​

github-actions

• Claude Code GitHub Actions를 사용하는 이유?
• Claude가 할 수 있는 것?
  • Claude Code Action
• 설정
• 빠른 설정
• 수동 설정
• Beta에서 업그레이드
  • 필수 변경 사항
  • Breaking Changes 참조
  • 이전 및 이후 예제
• 예제 사용 사례
  • 기본 워크플로우
  • skills 사용
  • 프롬프트를 사용한 사용자 정의 자동화
  • 일반적인 사용 사례
• 모범 사례
  • CLAUDE.md 구성
  • 보안 고려 사항
  • 성능 최적화
  • CI 비용
• 구성 예제
• AWS Bedrock & Google Vertex AI와 함께 사용
  • 전제 조건
    • Google Cloud Vertex AI의 경우:
    • AWS Bedrock의 경우:
• 문제 해결
  • Claude가 @claude 명령어에 응답하지 않음
  • CI가 Claude의 commits에서 실행되지 않음
  • 인증 오류
• 고급 구성
  • Action 매개변수
    • CLI 인수 전달
  • 대체 통합 방법
  • Claude의 동작 사용자 정의

​

gitlab-ci-cd

• Claude Code를 GitLab과 함께 사용하는 이유?
• 작동 방식
• Claude가 할 수 있는 것?
• 설정
  • 빠른 설정
  • 수동 설정 (프로덕션에 권장)
• 예제 사용 사례
  • issues를 MRs로 변환
  • 구현 도움 받기
  • 빠르게 버그 수정
• AWS Bedrock & Google Vertex AI와 함께 사용
• 구성 예제
  • 기본 .gitlab-ci.yml (Claude API)
  • AWS Bedrock job 예제 (OIDC)
  • Google Vertex AI job 예제 (Workload Identity Federation)
• 모범 사례
  • CLAUDE.md 구성
  • 보안 고려 사항
  • 성능 최적화
  • CI 비용
• 보안 및 거버넌스
• 문제 해결
  • Claude가 @claude 명령어에 응답하지 않음
  • Job이 comments를 작성하거나 MRs를 열 수 없음
  • 인증 오류
• 고급 구성
  • 일반적인 매개변수 및 변수
  • Claude의 동작 사용자 정의

​

slack

• 사용 사례
• 전제 조건
• Slack에서 Claude Code 설정
• 작동 방식
  • 자동 감지
  • Context 수집
  • 세션 흐름
• 사용자 인터페이스 요소
  • App Home
  • Message actions
  • Repository 선택
• 접근 및 권한
  • 사용자 수준 접근
  • Workspace 수준 접근
  • Channel 기반 접근 제어
• 어디서 무엇에 접근할 수 있는지
• 모범 사례
  • 효과적인 요청 작성
  • Slack vs. web 사용 시기
• 문제 해결
  • 세션이 시작되지 않음
  • Repository가 표시되지 않음
  • 잘못된 repository 선택됨
  • 인증 오류
  • 세션 만료
• 현재 제한 사항
• 관련 리소스

​

Claude Code로 빌드하기

​

sub-agents

• 내장 subagents
• Quickstart: 첫 번째 subagent 생성
• subagents 구성
  • /agents 명령어 사용
  • subagent 범위 선택
  • subagent 파일 작성
    • 지원되는 frontmatter 필드
  • 모델 선택
  • subagent 기능 제어
    • 사용 가능한 도구
    • 권한 모드
    • subagents에 skills 미리 로드
    • 지속적 메모리 활성화
      • 지속적 메모리 팁
    • hooks를 사용한 조건부 규칙
    • 특정 subagents 비활성화
  • subagents에 대한 hooks 정의
    • subagent frontmatter의 hooks
    • subagent 이벤트에 대한 프로젝트 수준 hooks
• subagents로 작업하기
  • 자동 위임 이해
  • foreground 또는 background에서 subagents 실행
  • 일반적인 패턴
    • 대량 작업 격리
    • 병렬 연구 실행
    • subagents 체인
  • subagents와 주 대화 간 선택
  • subagent context 관리
    • subagents 재개
    • 자동 압축
• 예제 subagents
  • Code reviewer
  • Debugger
  • Data scientist
  • Database query validator
• 다음 단계

​

agent-teams

• agent teams를 사용할 때
  • subagents와 비교
• agent teams 활성화
• 첫 번째 agent team 시작
• agent team 제어
  • 표시 모드 선택
  • teammates 및 모델 지정
  • teammates에 대한 계획 승인 요구
  • delegate mode 사용
  • teammates와 직접 대화
  • 작업 할당 및 청구
  • teammates 종료
  • team 정리
• agent teams가 어떻게 작동하는지
  • Claude가 agent teams를 시작하는 방법
  • 아키텍처
  • 권한
  • Context 및 통신
  • Token 사용
• 사용 사례 예제
  • 병렬 code review 실행
  • 경쟁하는 가설로 조사
• 모범 사례
  • teammates에게 충분한 context 제공
  • 작업 크기 적절히 조정
  • teammates가 완료될 때까지 대기
  • 연구 및 검토로 시작
  • 파일 충돌 피하기
  • 모니터링 및 조정
• 문제 해결
  • Teammates가 나타나지 않음
  • 너무 많은 권한 프롬프트
  • Teammates가 오류에서 중지됨
  • Lead가 작업 완료 전에 종료됨
  • 고아 tmux 세션
• 제한 사항
• 다음 단계

​

plugins

• plugins vs 독립 실행형 구성을 사용할 때
• Quickstart
  • 전제 조건
  • 첫 번째 plugin 생성
• Hello Command
  • Plugin 구조 개요
  • 더 복잡한 plugins 개발
    • plugin에 Skills 추가
    • plugin에 LSP servers 추가
    • 복잡한 plugins 구성
    • 로컬에서 plugins 테스트
    • plugin 문제 디버깅
    • plugins 공유
  • 기존 구성을 plugins로 변환
    • 마이그레이션 단계
    • 마이그레이션 시 변경되는 사항
  • 다음 단계
    • plugin 사용자의 경우
    • plugin 개발자의 경우

​

discover-plugins

• marketplaces가 어떻게 작동하는지
• Official Anthropic marketplace
  • Code intelligence
    • Code intelligence plugins에서 Claude가 얻는 것
  • External integrations
  • Development workflows
  • Output styles
• 시도해보기: demo marketplace 추가
• marketplaces 추가
  • GitHub에서 추가
  • 다른 Git hosts에서 추가
  • 로컬 경로에서 추가
  • 원격 URL에서 추가
• plugins 설치
• 설치된 plugins 관리
• marketplaces 관리
  • 대화형 인터페이스 사용
  • CLI 명령어 사용
  • 자동 업데이트 구성
• team marketplaces 구성
• 문제 해결
  • /plugin 명령어가 인식되지 않음
  • 일반적인 문제
  • Code intelligence 문제
• 다음 단계

​

skills

• 시작하기
  • 첫 번째 skill 생성
  • skills이 어디에 있는지
    • 중첩된 디렉토리에서 자동 발견
• skills 구성
  • skill 콘텐츠 유형
  • Frontmatter 참조
    • 사용 가능한 문자열 대체
  • 지원 파일 추가
  • skill을 호출할 수 있는 사람 제어
  • 도구 접근 제한
  • skills에 인수 전달
• 고급 패턴
  • 동적 context 주입
  • subagent에서 skills 실행
    • 예: Explore agent를 사용한 Research skill
  • Claude의 skill 접근 제한
• skills 공유
  • 시각적 출력 생성
• 문제 해결
  • Skill이 트리거되지 않음
  • Skill이 너무 자주 트리거됨
  • Claude가 모든 skills을 보지 못함
• 관련 리소스

​

output-styles

• 내장 output styles
• output styles가 어떻게 작동하는지
• output style 변경
• 사용자 정의 output style 생성
  • Frontmatter
• 관련 기능과의 비교
  • Output Styles vs. CLAUDE.md vs. —append-system-prompt
  • Output Styles vs. Agents
  • Output Styles vs. Skills

​

hooks-guide

• 첫 번째 hook 설정
• 자동화할 수 있는 것
  • Claude가 입력이 필요할 때 알림 받기
  • 편집 후 코드 자동 포맷
  • 보호된 파일에 대한 편집 차단
  • 압축 후 context 다시 주입
• hooks가 어떻게 작동하는지
  • 입력 읽기 및 출력 반환
    • Hook 입력
    • Hook 출력
    • 구조화된 JSON 출력
  • matchers로 hooks 필터링
  • hook 위치 구성
• Prompt 기반 hooks
• Agent 기반 hooks
• 제한 사항 및 문제 해결
  • 제한 사항
  • Hook이 실행되지 않음
  • 출력의 Hook 오류
  • /hooks에 구성된 hooks가 없음
  • Stop hook이 영원히 실행됨
  • JSON 검증 실패
  • 디버깅 기법
• 자세히 알아보기

​

headless

• 기본 사용
• 예제
  • 구조화된 출력 얻기
  • 응답 스트리밍
  • 도구 자동 승인
  • commit 생성
  • 시스템 프롬프트 사용자 정의
  • 대화 계속
• 다음 단계

​

mcp

• MCP로 할 수 있는 것
• 인기 있는 MCP servers
• MCP servers 설치
  • 옵션 1: 원격 HTTP server 추가
  • 옵션 2: 원격 SSE server 추가
  • 옵션 3: 로컬 stdio server 추가
  • servers 관리
  • 동적 도구 업데이트
  • Plugin 제공 MCP servers
• MCP 설치 범위
  • Local scope
  • Project scope
  • User scope
  • 올바른 범위 선택
  • 범위 계층 및 우선순위
  • .mcp.json의 환경 변수 확장
• 실제 예제
  • 예: Sentry로 오류 모니터링
  • 예: code reviews를 위해 GitHub에 연결
  • 예: PostgreSQL 데이터베이스 쿼리
• 원격 MCP servers로 인증
  • 사전 구성된 OAuth 자격 증명 사용
• JSON 구성에서 MCP servers 추가
• Claude Desktop에서 MCP servers 가져오기
• Claude Code를 MCP server로 사용
• MCP 출력 제한 및 경고
• MCP resources 사용
  • MCP resources 참조
• MCP Tool Search로 확장
  • 작동 방식
  • MCP server 작성자의 경우
  • tool search 구성
• MCP prompts를 명령어로 사용
  • MCP prompts 실행
• Managed MCP 구성
  • 옵션 1: managed-mcp.json으로 독점 제어
  • 옵션 2: allowlists 및 denylists를 사용한 정책 기반 제어
    • 제한 옵션
    • 예제 구성
    • 명령어 기반 제한이 어떻게 작동하는지
    • URL 기반 제한이 어떻게 작동하는지
    • Allowlist 동작 (allowedMcpServers)
    • Denylist 동작 (deniedMcpServers)
    • 중요 참고 사항

​

troubleshooting

• 일반적인 설치 문제
  • Windows 설치 문제: WSL의 오류
  • WSL2 sandbox 설정
  • Linux 및 Mac 설치 문제: 권한 또는 명령어를 찾을 수 없음 오류
    • 권장 솔루션: Native Claude Code 설치
  • Windows: “Claude Code on Windows requires git-bash”
  • Windows: “installMethod is native, but claude command not found”
• 권한 및 인증
  • 반복되는 권한 프롬프트
  • 인증 문제
• 구성 파일 위치
  • 구성 재설정
• 성능 및 안정성
  • 높은 CPU 또는 메모리 사용
  • 명령어가 중단되거나 멈춤
  • 검색 및 발견 문제
  • WSL에서 느리거나 불완전한 검색 결과
• IDE 통합 문제
  • WSL2에서 JetBrains IDE가 감지되지 않음
    • WSL2 네트워킹 모드
  • Windows IDE 통합 문제 보고 (native 및 WSL 모두)
  • JetBrains (IntelliJ, PyCharm 등) 터미널에서 Escape 키가 작동하지 않음
• Markdown 포맷팅 문제
  • 코드 블록의 언어 태그 누락
  • 일관되지 않은 간격 및 포맷팅
  • markdown 생성 모범 사례
• 더 많은 도움 받기

​

배포

​

third-party-integrations

• 배포 옵션 비교
• proxies 및 gateways 구성
  • Amazon Bedrock
  • Microsoft Foundry
  • Google Vertex AI
• 조직을 위한 모범 사례
  • 문서 및 메모리에 투자
  • 배포 단순화
  • 안내된 사용으로 시작
  • 보안 정책 구성
  • 통합을 위해 MCP 활용
• 다음 단계

​

amazon-bedrock

• 전제 조건
• 설정
  • 1. 사용 사례 세부 정보 제출
  • 2. AWS 자격 증명 구성
    • 고급 자격 증명 구성
      • 예제 구성
      • 구성 설정 설명
  • 3. Claude Code 구성
  • 4. 모델 구성
  • 5. 출력 token 구성
• IAM 구성
• AWS Guardrails
• 문제 해결
• 추가 리소스

​

google-vertex-ai

• 전제 조건
• Region 구성
• 설정
  • 1. Vertex AI API 활성화
  • 2. 모델 접근 요청
  • 3. GCP 자격 증명 구성
  • 4. Claude Code 구성
  • 5. 모델 구성
• IAM 구성
• 1M token context window
• 문제 해결
• 추가 리소스

​

microsoft-foundry

• 전제 조건
• 설정
  • 1. Microsoft Foundry 리소스 프로비저닝
  • 2. Azure 자격 증명 구성
  • 3. Claude Code 구성
• Azure RBAC 구성
• 문제 해결
• 추가 리소스

​

network-config

• Proxy 구성
  • 환경 변수
  • 기본 인증
• 사용자 정의 CA 인증서
• mTLS 인증
• 네트워크 접근 요구 사항
• 추가 리소스

​

llm-gateway

• Gateway 요구 사항
• 구성
  • 모델 선택
• LiteLLM 구성
  • 전제 조건
  • 기본 LiteLLM 설정
    • 인증 방법
      • 정적 API 키
      • 도우미를 사용한 동적 API 키
    • 통합 엔드포인트 (권장)
    • 제공자별 pass-through 엔드포인트 (대체)
      • LiteLLM을 통한 Claude API
      • LiteLLM을 통한 Amazon Bedrock
      • LiteLLM을 통한 Google Vertex AI
• 추가 리소스

​

devcontainer

• 주요 기능
• 4단계로 시작하기
• 구성 분석
• 보안 기능
• 사용자 정의 옵션
• 예제 사용 사례
  • 안전한 클라이언트 작업
  • Team 온보딩
  • 일관된 CI/CD 환경
• 관련 리소스

​

관리

​

setup

• 시스템 요구 사항
  • 추가 종속성
• 설치
  • 플랫폼별 설정
  • 인증
    • 개인의 경우
    • teams 및 조직의 경우
  • 특정 버전 설치
  • 바이너리 무결성 및 코드 서명
• NPM 설치 (더 이상 사용되지 않음)
• Windows 설정
• Claude Code 업데이트
  • 자동 업데이트
  • 릴리스 채널 구성
  • 자동 업데이트 비활성화
  • 수동으로 업데이트
• Claude Code 제거
  • Native 설치
  • Homebrew 설치
  • WinGet 설치
  • NPM 설치
  • 구성 파일 정리 (선택 사항)

​

authentication

• 인증 방법
  • Claude for Teams 또는 Enterprise
  • Claude Console 인증
  • Cloud provider 인증
• 자격 증명 관리
• 참고 항목

​

security

• 보안에 대한 접근 방식
  • 보안 기초
  • 권한 기반 아키텍처
  • 내장 보호
  • 사용자 책임
• prompt injection으로부터 보호
  • 핵심 보호
  • 개인정보 보호 장치
  • 추가 보호
• MCP 보안
• IDE 보안
• Cloud 실행 보안
• 보안 모범 사례
  • 민감한 코드로 작업
  • Team 보안
  • 보안 문제 보고
• 관련 리소스

​

data-usage

• 데이터 정책
  • 데이터 학습 정책
  • Development Partner Program
  • /bug 명령어를 사용한 피드백
  • 세션 품질 설문 조사
  • 데이터 보존
• 데이터 접근
• Local Claude Code: 데이터 흐름 및 종속성
  • Cloud 실행: 데이터 흐름 및 종속성
• Telemetry services
• API 제공자별 기본 동작

​

monitoring-usage

• 빠른 시작
• Administrator 구성
• 구성 세부 정보
  • 일반적인 구성 변수
  • Metrics cardinality 제어
  • 동적 헤더
    • 설정 구성
    • Script 요구 사항
    • 새로고침 동작
  • Multi-team 조직 지원
  • 예제 구성
• 사용 가능한 metrics 및 events
  • 표준 속성
  • Metrics
  • Metric 세부 정보
    • Session counter
    • Lines of code counter
    • Pull request counter
    • Commit counter
    • Cost counter
    • Token counter
    • Code edit tool decision counter
    • Active time counter
  • Events
    • User prompt event
    • Tool result event
    • API request event
    • API error event
    • Tool decision event
• metrics 및 events 데이터 해석
  • 사용 모니터링
  • 비용 모니터링
  • 경고 및 세분화
  • Event 분석
• Backend 고려 사항
  • Metrics의 경우
  • Events/logs의 경우
• Service 정보
• ROI 측정 리소스
• 보안/개인정보 보호 고려 사항
• Amazon Bedrock에서 Claude Code 모니터링

​

costs

• 비용 추적
  • /cost 명령어 사용
• teams의 비용 관리
  • 속도 제한 권장 사항
  • Agent team token 비용
• Token 사용 감소
  • context를 적극적으로 관리
  • 올바른 모델 선택
  • MCP server 오버헤드 감소
  • 타입이 지정된 언어에 대해 code intelligence plugins 설치
  • hooks 및 skills로 처리 오프로드
  • CLAUDE.md의 지침을 skills로 이동
  • 확장 사고 조정
  • 자세한 작업을 subagents에 위임
  • agent team 비용 관리
  • 구체적인 프롬프트 작성
  • 복잡한 작업에서 효율적으로 작업
• Background token 사용
• Claude Code 동작의 변경 사항 이해

​

analytics

• Teams 및 Enterprise에 대한 analytics 접근
  • 기여도 metrics 활성화
  • 요약 metrics 검토
  • 차트 탐색
    • 채택 추적
    • 사용자당 PRs 측정
    • pull requests 분석 보기
    • 상위 기여자 찾기
  • PR attribution
    • 태깅 기준
    • Attribution 프로세스
    • 시간 창
    • 제외된 파일
    • Attribution 참고 사항
  • analytics에서 최대한 활용
    • 채택 모니터링
    • ROI 측정
    • Power users 식별
    • 프로그래밍 방식으로 데이터 접근
• API 고객을 위한 analytics 접근
  • team insights 보기
• 관련 리소스

​

plugin-marketplaces

• 개요
• 연습: 로컬 marketplace 생성
• marketplace 파일 생성
• Marketplace 스키마
  • 필수 필드
  • Owner 필드
  • 선택적 메타데이터
• Plugin 항목
  • 필수 필드
  • 선택적 plugin 필드
• Plugin 소스
  • 상대 경로
  • GitHub repositories
  • Git repositories
  • 고급 plugin 항목
• marketplaces 호스팅 및 배포
  • GitHub에서 호스팅 (권장)
  • 다른 git services에서 호스팅
  • Private repositories
  • 배포 전에 로컬에서 테스트
  • team에 대해 marketplaces 요구
  • Managed marketplace 제한
    • 일반적인 구성
    • 제한이 어떻게 작동하는지
• Validation 및 테스트
• 문제 해결
  • Marketplace가 로드되지 않음
  • Marketplace validation 오류
  • Plugin 설치 실패
  • Private repository 인증 실패
  • URL 기반 marketplaces에서 상대 경로가 있는 Plugins 실패
  • 설치 후 파일을 찾을 수 없음
• 참고 항목

​

구성

​

settings

• 구성 범위
  • 사용 가능한 범위
  • 각 범위를 사용할 때
  • 범위가 상호 작용하는 방식
  • 범위를 사용하는 것
• Settings 파일
  • 사용 가능한 설정
  • 권한 설정
  • 권한 규칙 구문
  • Sandbox 설정
  • Attribution 설정
  • File suggestion 설정
  • Hook 구성
  • Settings 우선순위
  • 구성 시스템에 대한 주요 포인트
  • System prompt
  • 민감한 파일 제외
• Subagent 구성
• Plugin 구성
  • Plugin 설정
    • enabledPlugins
    • extraKnownMarketplaces
    • strictKnownMarketplaces
  • plugins 관리
• 환경 변수
• Claude가 사용할 수 있는 도구
  • Bash tool 동작
  • hooks로 도구 확장
• 참고 항목

​

permissions

• 권한 시스템
• 권한 관리
• 권한 모드
• 권한 규칙 구문
  • 도구의 모든 사용 일치
  • 세분화된 제어를 위해 specifiers 사용
  • Wildcard 패턴
• 도구별 권한 규칙
  • Bash
  • Read 및 Edit
  • WebFetch
  • MCP
  • Task (subagents)
• hooks로 권한 확장
• 작업 디렉토리
• 권한이 sandboxing과 상호 작용하는 방식
• Managed 설정
  • Managed 전용 설정
• Settings 우선순위
• 예제 구성
• 참고 항목

​

sandboxing

• 개요
• sandboxing이 중요한 이유
• 작동 방식
  • Filesystem 격리
  • Network 격리
  • OS 수준 적용
• 시작하기
  • 전제 조건
  • sandboxing 활성화
  • Sandbox 모드
  • sandboxing 구성
• 보안 이점
  • prompt injection으로부터 보호
  • 공격 표면 감소
  • 투명한 작동
• 보안 제한 사항
• sandboxing이 권한과 어떻게 관련되는지
• 고급 사용
  • 사용자 정의 proxy 구성
  • 기존 보안 도구와의 통합
• 모범 사례
• Open source
• 제한 사항
• 참고 항목

​

terminal-config

• Themes 및 appearance
• Line breaks
• Notification 설정
  • iTerm 2 system notifications
  • 사용자 정의 notification hooks
• 큰 입력 처리
• Vim Mode

​

model-config

• 사용 가능한 모델
  • 모델 aliases
  • 모델 설정
• 특수 모델 동작
  • default 모델 설정
  • opusplan 모델 설정
  • 노력 수준 조정
  • [1m]으로 확장된 context
• 현재 모델 확인
• 환경 변수
  • Prompt caching 구성

​

memory

• 메모리 유형 결정
• CLAUDE.md imports
• Claude가 메모리를 찾는 방법
  • 추가 디렉토리에서 메모리 로드
• /memory로 메모리 직접 편집
• 프로젝트 메모리 설정
• .claude/rules/를 사용한 모듈식 규칙
  • 기본 구조
  • 경로별 규칙
  • Glob 패턴
  • 하위 디렉토리
  • Symlinks
  • 사용자 수준 규칙
• 조직 수준 메모리 관리
• 메모리 모범 사례

​

statusline

• 사용자 정의 status line 생성
• 작동 방식
• JSON Input 구조
• 예제 Scripts
  • Simple Status Line
  • Git-Aware Status Line
  • Python 예제
  • Node.js 예제
  • Helper Function 접근
  • Context Window 사용
• 팁
• 문제 해결

​

keybindings

• 구성 파일
• Contexts
• 사용 가능한 actions
  • App actions
  • History actions
  • Chat actions
  • Autocomplete actions
  • Confirmation actions
  • Permission actions
  • Transcript actions
  • History search actions
  • Task actions
  • Theme actions
  • Help actions
  • Tabs actions
  • Attachments actions
  • Footer actions
  • Message selector actions
  • Diff actions
  • Model picker actions
  • Select actions
  • Plugin actions
  • Settings actions
• Keystroke 구문
  • Modifiers
  • 대문자
  • Chords
  • 특수 키
• 기본 단축키 바인딩 해제
• 예약된 단축키
• 터미널 충돌
• Vim mode 상호 작용
• Validation

​

참조

​

cli-reference

• CLI 명령어
• CLI 플래그
  • Agents 플래그 형식
  • System prompt 플래그
• 참고 항목

​

interactive-mode

• 키보드 단축키
  • 일반 제어
  • 텍스트 편집
  • Theme 및 display
  • Multiline input
  • Quick commands
• 내장 명령어
  • MCP prompts
• Vim editor mode
  • Mode 전환
  • Navigation (NORMAL mode)
  • Editing (NORMAL mode)
  • Text objects (NORMAL mode)
• Command history
  • Ctrl+R로 역방향 검색
• Background bash 명령어
  • backgrounding이 어떻게 작동하는지
  • ! 접두사가 있는 Bash mode
• Prompt suggestions
• Task list
• PR review status
• 참고 항목

​

checkpointing

• checkpoints가 어떻게 작동하는지
  • 자동 추적
  • 변경 사항 되감기
• 일반적인 사용 사례
• 제한 사항
  • Bash 명령어 변경이 추적되지 않음
  • 외부 변경이 추적되지 않음
  • 버전 제어의 대체가 아님
• 참고 항목

​

hooks

• Hook lifecycle
  • hook이 어떻게 해결되는지
• 구성
  • Hook 위치
  • Matcher 패턴
    • MCP 도구 일치
  • Hook handler 필드
    • 일반 필드
    • Command hook 필드
    • Prompt 및 agent hook 필드
  • 경로별 scripts 참조
  • skills 및 agents의 Hooks
  • /hooks 메뉴
  • hooks 비활성화 또는 제거
• Hook input 및 output
  • 일반 input 필드
  • Exit code output
    • 이벤트별 Exit code 2 동작
  • JSON output
    • Decision control
• Hook events
  • SessionStart
    • SessionStart input
    • SessionStart decision control
    • 환경 변수 유지
  • UserPromptSubmit
    • UserPromptSubmit input
    • UserPromptSubmit decision control
  • PreToolUse
    • PreToolUse input
      • Bash
      • Write
      • Edit
      • Read
      • Glob
      • Grep
      • WebFetch
      • WebSearch
      • Task
    • PreToolUse decision control
  • PermissionRequest
    • PermissionRequest input
    • PermissionRequest decision control
  • PostToolUse
    • PostToolUse input
    • PostToolUse decision control
  • PostToolUseFailure
    • PostToolUseFailure input
    • PostToolUseFailure decision control
  • Notification
    • Notification input
  • SubagentStart
    • SubagentStart input
  • SubagentStop
    • SubagentStop input
  • Stop
    • Stop input
    • Stop decision control
  • PreCompact
    • PreCompact input
  • SessionEnd
    • SessionEnd input
• Prompt 기반 hooks
  • prompt 기반 hooks가 어떻게 작동하는지
  • Prompt hook 구성
  • Response schema
  • 예: Multi-criteria Stop hook
• Agent 기반 hooks
  • agent hooks가 어떻게 작동하는지
  • Agent hook 구성
• background에서 hooks 실행
  • async hook 구성
  • async hooks가 어떻게 실행되는지
  • 예: 파일 변경 후 테스트 실행
  • 제한 사항
• 보안 고려 사항
  • 면책 조항
  • 보안 모범 사례
• hooks 디버깅

​

plugins-reference

• Plugin 구성 요소 참조
  • Skills
  • Agents
  • Hooks
  • MCP servers
  • LSP servers
• Plugin 설치 범위
• Plugin manifest 스키마
  • 완전한 스키마
  • 필수 필드
  • Metadata 필드
  • Component path 필드
  • Path 동작 규칙
  • 환경 변수
• Plugin caching 및 file resolution
  • plugin caching이 어떻게 작동하는지
  • Path traversal 제한
  • 외부 종속성으로 작업
• Plugin 디렉토리 구조
  • 표준 plugin 레이아웃
  • File locations 참조
• CLI 명령어 참조
  • plugin install
  • plugin uninstall
  • plugin enable
  • plugin disable
  • plugin update
• 디버깅 및 개발 도구
  • 디버깅 명령어
  • 일반적인 문제
  • 예제 오류 메시지
  • Hook 문제 해결
  • MCP server 문제 해결
  • 디렉토리 구조 실수
• 배포 및 버전 관리 참조
  • Version 관리
• 참고 항목

​

리소스

​

legal-and-compliance

• 법적 계약
  • License
  • Commercial agreements
• Compliance
  • Healthcare compliance (BAA)
• 보안 및 신뢰
  • Trust and safety
  • Security vulnerability reporting