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. 사용 사례 세부 정보 제출
- 1. AWS 자격 증명 구성
  - 고급 자격 증명 구성
    - 예제 구성
    - 구성 설정 설명
- 1. Claude Code 구성
- 1. 모델 구성
- 1. 출력 token 구성
IAM 구성
AWS Guardrails
문제 해결
추가 리소스

google-vertex-ai

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

microsoft-foundry

전제 조건
설정
- 1. Microsoft Foundry 리소스 프로비저닝
- 1. Azure 자격 증명 구성
- 1. 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

Getting started

Core concepts

Use Claude Code

Platforms and integrations

Documentation Index

​Claude Code 문서 지도

​문서 구조

​시작하기

​핵심 개념

​터미널 외부

​Claude Code로 빌드하기

​배포

​관리

​구성

​참조

​리소스

Claude Code 문서 지도

문서 구조

시작하기

핵심 개념

터미널 외부

Claude Code로 빌드하기

배포

관리

구성

참조

리소스