Claude

Claude Code V4에 대한 전체 가이드 - 커뮤니티의 요청에 따라 제공됨: 85% 컨텍스트 감소, 사용자 지정 에이전트 및 세션 순간 이동

익명빌더5995·1개월 전·조회 976

https://preview.redd.it/h0m40cj0wegg1.jpg?width=1920&format=pjpg&auto=webp&s=8f32bc241d525a08fad2da9be99bc3bc704e77b5

# V4: 2026년 1월 혁명

# 이전 가이드: V1 | V2 | V3

V1~V3의 압도적인 지지 덕분에 V4로 돌아왔습니다. 이전 가이드에 기여해주신 모든 분들께 큰 감사를 드립니다: u/BlueVajra, u/stratofax, u/antoniocs, u/GeckoLogic, u/headset38, u/tulensrma, u/jcheroske 및 나머지 커뮤니티. 여러분의 피드백으로 각 버전이 더 좋아졌습니다.

Claude Code 2.1.x는 1월에만 1,096개 이상의 커밋을 제공했습니다. 이는 점진적인 업데이트가 아닙니다. Claude Code가 컨텍스트를 관리하고 작업을 위임하고 확장하는 방식에 대한 근본적인 변화입니다.

**V4의 새로운 기능:**

* **파트 9: MCP 도구 검색** - 지연 로딩으로 컨텍스트 85% 감소
* **10부: 맞춤 에이전트** - 전문가에게 자동 위임
* **11부: 세션 순간 이동** - 장치 간 세션 이동
* **12부: 백그라운드 작업** - 병렬 에이전트 실행
* **13부: 새로운 명령 및 단축키** - `/config` 검색, `/stats` 필터링, 사용자 정의 키 바인딩
* V4 템플릿으로 GitHub 저장소가 곧 업데이트될 예정입니다.

**요약:** MCP 도구 검색은 주문형 도구 지연 로딩을 통해 컨텍스트 오버헤드를 85%(77K -> 8.7K 토큰)까지 줄입니다. 사용자 정의 에이전트를 사용하면 Claude가 자동으로 호출하는 전문가를 생성할 수 있으며 각각은 격리된 컨텍스트 창을 갖습니다. Session Teleportation을 사용하면 터미널과 clude.ai/code 간에 작업을 원활하게 이동할 수 있습니다. 백그라운드 작업은 Ctrl+B를 사용하여 병렬 에이전트 실행을 활성화합니다. 그리고 새로운 설치 후크는 저장소 초기화를 자동화합니다.

# 목차

# 기초(V1-V3부터)

* 1부: 보안 게이트키퍼로서의 글로벌 CLAUDE.md
* 2부: 새 프로젝트 스캐폴딩에 대한 전역 규칙
* 3부: MCP 서버 - Claude의 통합
* 4부: 명령 - 개인 단축키
* 파트 5: 스킬 - 재사용 가능한 전문 지식
* 6부: 단일 목적 채팅이 중요한 이유
* 파트 7: 후크 - 결정적 적용
* 8부: LSP - IDE 수준 코드 인텔리전스

# V4의 새로운 기능

* 9부: MCP 도구 검색 - 85% 컨텍스트 혁명
* 10부: 사용자 정의 에이전트 - 자동 위임
* 11부: 세션 순간이동
* 12부: 백그라운드 작업 및 병렬 실행
* 13부: 새로운 명령, 단축키 및 삶의 질

# 참고자료

* 빠른 참조
* GitHub 저장소
* 출처

# 1부: 글로벌 CLAUDE.md 보안 게이트키퍼

# 메모리 계층 구조

Claude Code는 특정 순서로 CLAUDE.md 파일을 로드합니다.

전역 파일은 작업 중인 **모든 단일 프로젝트**에 적용됩니다.

# 글로벌에 속하는 것

**1. 신원 및 인증**

## GitHub 계정
**항상** 모든 프로젝트에 **YourUsername**을 사용하세요.
- SSH: `git@github.com:YourUsername/.git`

## 도커 허브
이미 인증되었습니다. `~/.env`의 사용자 이름은 `DOCKER_HUB_USER`입니다.

**왜 글로벌한가요?** 어디에서나 동일한 계정을 사용합니다. 한 번 정의하면 어디에서나 상속됩니다.

**2. 게이트키퍼 규칙**

## 절대 하지 마세요

이 규칙은 절대적입니다:

### 민감한 데이터를 절대 게시하지 마세요
- 비밀번호, API 키, 토큰을 git/npm/docker에 게시하지 마세요.
- 커밋 전: 비밀이 포함되어 있지 않은지 확인하세요.

### .env 파일을 커밋하지 마세요.
- 절대 `.env`를 git에 커밋하지 마세요.
- `.env`가 `.gitignore`에 있는지 항상 확인하세요.

# 이것이 중요한 이유: Claude가 .env를 읽습니다.

보안 연구원들은 Claude Code가 명시적 허가 없이 **자동으로** `.env` **파일**을 읽는다는 사실을 발견했습니다. 백슬래시 보안 경고:

>"제한되지 않으면 Claude는 `.env`, AWS 자격 증명 또는 `secrets.json`을 읽고 '유용한 제안'을 통해 유출할 수 있습니다."

전역 CLAUDE.md는 **행동 게이트키퍼**를 생성합니다. Claude가 액세스 권한을 갖고 있더라도 비밀을 출력하지 않습니다.

# 여러 컴퓨터에서 전역 CLAUDE.md 동기화

여러 컴퓨터에서 작업하는 경우 도트 파일 관리자를 사용하여 `~/.claude/` 디렉터리를 동기화하세요.

# GNU Stow 사용하기
CD ~/점 파일
stow claude # ~/.claude에서 dotfiles/claude/.claude로의 심볼릭 링크

이는 다음을 제공합니다.

* 설정에 대한 버전 관리
* 어디에서나 일관된 구성
* 고장난 경우 쉽게 복구 가능

# 심층 방어

|레이어|무엇을|어떻게|
|:-|:-|:-|
|1|행동 규칙|글로벌 CLAUDE.md "절대" 규칙|
|2|액세스 제어|settings.json의 거부 목록|
|3|Git 안전|.gitignore|

# 팀 워크플로우: 진화 CLAUDE.md

Boris Cherny가 Anthropic의 Claude Code 팀이 수행하는 방법을 공유합니다:

>"우리 팀은 Claude Code 저장소에 단일 CLAUDE.md를 공유합니다. 이를 git에 체크인하고 전체 팀이 일주일에 여러 번 기여합니다."

**패턴:** 실수는 문서화됩니다.

Claude의 실수 -> 수정 -> CLAUDE.md에 규칙 추가 -> 다시는 발생하지 않음

# 2부: 새 프로젝트 비계에 대한 전역 규칙

귀하의 글로벌 CLAUDE.md가 **프로젝트 팩토리**가 됩니다. 모든 새 프로젝트는 자동으로 표준을 상속합니다.

# 비계 규칙이 없는 문제

프로젝트 스캐폴딩 전문가의 연구:

>"LLM 지원 개발은 조용히 범위를 확장하고 품질을 저하시키며 아키텍처 의도를 잃어 실패합니다."

# 해결책

## 새 프로젝트 설정

새 프로젝트를 생성할 때:

### 필수 파일
- `.env` - 환경 변수(커밋하지 않음)
- `.env.example` - 자리 표시자가 있는 템플릿
- `.gitignore` - 다음을 포함해야 합니다: .env, node_modules/, dist/
- `CLAUDE.md` - 프로젝트 개요

### 필수 구조
프로젝트/
├── 소스/
├── 테스트/
├── 문서/
├── .claude/
│ ├── 스킬/
│ ├── 대리인/
│ └── 명령/
└── 스크립트/

### Node.js 요구 사항
진입점에 추가:
process.on('unhandledRejection', (이유, 약속) => {
console.error('처리되지 않은 거부:', 이유);
프로세스.종료(1);
});

"새 Node.js 프로젝트 생성"이라고 말하면 Claude가 이를 읽고 **자동으로** 올바른 구조를 생성합니다.

# 3부: MCP 서버 - Claude의 통합

MCP(모델 컨텍스트 프로토콜)를 사용하면 Claude가 외부 도구와 상호 작용할 수 있습니다.

# MCP 서버 추가

claude mcp add <서버 이름> -- <명령>
클로드 mcp 목록
클로드 mcp 제거 <서버 이름>

# MCP를 사용하지 말아야 할 경우

MCP 서버는 토큰과 컨텍스트를 사용합니다. 간단한 통합의 경우 대안을 고려하십시오.

**경험 법칙:** 세션당 한 번씩 MCP 도구를 호출하는 경우 CLI가 더 효율적입니다. MCP는 대화 내에서 *반복적인* 도구 사용에 탁월합니다.

**업데이트 V4:** MCP 도구 검색(파트 9)을 사용하면 이러한 절충안이 크게 변경됩니다. 이제 초기 컨텍스트 비용을 지불하지 않고도 더 많은 MCP 서버를 보유할 수 있습니다.

# 개발자를 위한 권장 MCP 서버

# 핵심 개발

# 데이터베이스

# 문서 및 RAG

# 브라우저 및 테스트

|서버|목적|설치|
|:-|:-|:-|
|**극작가**|E2E 테스트, 스크래핑|`claude mcp add 극작가 -- npx -y @anthropic-ai/playwright-mcp`|
|**브라우저 MCP**|로그인한 Chrome을 사용하세요|browsermcp.io|

# 클라우드 및 DevOps

|서버|목적|설치|
|:-|:-|:-|
|**AWS**|S3, Lambda, CloudWatch|`claude mcp add aws -- npx -y @anthropic-ai/aws-mcp`|
|**Docker**|컨테이너 관리|`claude mcp add docker -- npx -y @anthropic-ai/docker-mcp`|
|**Kubernetes**|클러스터 작업|`claude mcp add k8s -- npx -y @anthropic-ai/kubernetes-mcp`|

# 파트 4: 명령 - 개인 단축키

명령은 프롬프트로 확장되는 개인용 매크로입니다. 다음 위치에 저장하세요.

* `~/.claude/commands/` - 어디에서나 사용 가능
* `.claude/commands/` - 프로젝트별

# 기본 명령어

`~/.claude/commands/review.md`를 생성합니다:

---
설명: 문제에 대한 코드 검토
---

다음 사항에 대해 이 코드를 검토하세요.
1. 보안 취약점
2. 성능 문제
3. 오류 처리 공백
4. 코드 스타일 위반

**사용법:** 모든 세션에서 `/review`를 입력하세요.

# 인수가 포함된 명령

`~/.claude/commands/ticket.md`를 생성합니다:

---
설명: 설명에서 티켓 만들기
인수 힌트: <티켓 설명>
---

$ARGUMENTS에 대한 자세한 티켓 만들기

포함:
- 사용자 스토리
- 합격기준
- 기술 노트

**사용법:** `/ticket 다크 모드 지원 추가`

# 고급: Bash 실행이 포함된 명령

---
설명: 컨텍스트가 포함된 스마트 커밋
허용 도구: Bash(git add:*), Bash(git 상태:*), Bash(git commit:*)
인수 힌트: [메시지]
---

## 컨텍스트
- 현재 자식 상태: !`git status`
- 현재 git diff: !`git diff HEAD`
- 현재 브랜치: !`git Branch --show-current`
- 최근 커밋: !`git log --oneline -5`

## 작업
메시지가 포함된 커밋 만들기: $ARGUMENTS

`!` 백틱 구문은 프롬프트가 처리되기 전에 bash 명령을 실행합니다.

# 파트 5: 기술 - 재사용 가능한 전문성

기술은 필요할 때만 로드되는 **촉발된 전문 지식**입니다. CLAUDE.md(항상 로드됨)와 달리 기술은 점진적 공개를 사용하여 컨텍스트를 저장합니다.

# 스킬 생성

`.claude/skills/code-review/SKILL.md`를 생성합니다:

---
이름: 코드 검토
설명: 보안에 초점을 맞춘 포괄적인 코드 검토
트리거:
- 검토
- 감사
- 코드 확인
---

# 코드 리뷰 스킬

코드를 검토할 때:
1. 보안 취약점 점검(OWASP Top 10)
2. 성능 문제(N+1 쿼리, 메모리 누수)를 찾습니다.
3. 오류 처리 확인(가장자리 사례, null 검사)
4. 테스트 범위 평가
5. 이름 지정 및 문서 검토

# 점진적 공개

기술은 토큰 효율성을 위해 **점진적 공개**를 사용합니다.

1. **시작**: 이름/설명만 로드됨(최대 50개 토큰)
2. **트리거됨**: 전체 SKILL.md 콘텐츠 로드됨
3. **필요에 따라**: 추가 리소스 로드

**경험 법칙:** 지침이 대화의 20% 미만에 적용되는 경우 CLAUDE.md에 넣는 대신 기술로 만드세요.

# V4 업데이트: 자동 스킬 발견

이제 Claude Code는 하위 디렉터리의 파일로 작업할 때 중첩된 '.claude/skills' 디렉터리에서 기술을 자동으로 검색합니다. 루트를 참조할 필요가 없습니다. 스킬은 재귀적으로 발견됩니다.

# 6부: 단일 목적 채팅이 중요한 이유

**연구에 따르면 주제를 혼합하면 정확성이 저하되는 것으로 일관되게 나타났습니다.**

다단계 대화에 관한 연구:

>"여러 차례에 걸쳐 지침이 전달되면 평균 **39% 성능 저하**가 발생합니다."

컨텍스트 부패에 대한 Chroma 연구:

>"컨텍스트 창의 토큰이 증가함에 따라 정보를 정확하게 기억하는 모델의 능력이 감소합니다."

# 황금률

>**"하나의 작업, 하나의 채팅"**

|시나리오|액션|
|:-|:-|
|새로운 기능|새 채팅|
|버그 수정(관련 없음)|`/clear` 후 새 작업|
|연구 vs 구현|별도의 채팅|
|20+ 턴 경과|새로 시작|

# /clear를 자유롭게 사용하세요

/지우기

Anthropic 권장 사항:

>"컨텍스트 창을 재설정하려면 작업 사이에 `/clear`를 자주 사용하세요."

# V4 업데이트: 컨텍스트 창 가시성

이제 컨텍스트가 어디로 가는지 정확히 확인할 수 있습니다.

/컨텍스트

새로운 상태 표시줄 필드:

* `context_window.used_percentage`
* `context_window.remaining_percentage`

# 파트 7: 후크 - 결정론적 시행

CLAUDE.md 규칙은 **제안**입니다. Claude는 상황에 따른 압박을 무시할 수 있습니다. 후크는 **결정적**이므로 항상 실행됩니다.

# 중요한 차이점

|메커니즘|유형|신뢰성|
|:-|:-|:-|
|CLAUDE.md 규칙|제안|재정의 가능|
|**후크**|**적용**|항상 실행|

# 후크 이벤트

# 예: 비밀 접근 차단

`~/.claude/settings.json`에 추가:

{
"후크": {
"PreToolUse": [
{
"matcher": "읽기|편집|쓰기",
"후크": [{
"유형": "명령",
"명령": "python3 ~/.claude/hooks/block-secrets.py"
}]
}
]
}
}

후크 스크립트:

#!/usr/bin/env python3
json, sys 가져오기
pathlib import 경로에서

민감한 = {'.env', '.env.local', 'secrets.json', 'id_rsa'}

데이터 = json.load(sys.stdin)
file_path = data.get('tool_input', {}).get('file_path', '')

민감한 경우 Path(file_path).name:
print(f"차단됨: {file_path}에 대한 액세스가 거부되었습니다.", file=sys.stderr)
sys.exit(2) # Exit 2 = stderr를 차단하고 Claude에게 제공

sys.exit(0)

# 후크 종료 코드

|코드|의미|
|:-|:-|
|0|작업 허용|
|1|오류(사용자에게 표시됨)|
|**2**|**작업을 차단하고 클로드에게 이유를 알려주세요**|

# V4: 설정 후크 이벤트

2026년 1월의 새로운 기능 - 저장소 설정 중 후크 트리거:

claude --init # 설정 후크를 트리거합니다.
claude --init-only # 설정 후크를 트리거한 후 종료합니다.
claude --maintenance # 유지 관리를 위한 설정 후크를 트리거합니다.

종속성 자동 설치를 위한 설정 후크 예:

{
"후크": {
"설정": [{
"유형": "명령",
"command": "npm 설치 && npm 실행 준비"
}]
}
}

# 파트 8: LSP - IDE 수준 코드 인텔리전스

**2025년 12월**(v2.0.74) Claude Code는 기본 언어 서버 프로토콜 지원을 얻었습니다.

# LSP가 가능하게 하는 것

LSP는 Claude에게 IDE가 이해하는 것과 동일한 코드를 제공합니다.

# 이것이 중요한 이유

LSP 이전에 Claude는 코드를 이해하기 위해 **텍스트 기반 검색**(grep, ripgrep)을 사용했습니다. 느리고 부정확합니다.

LSP를 사용하면 Claude는 **의미론적 이해**를 가집니다. 즉, 텍스트가 일치한다는 것뿐만 아니라 파일 A의 `getUserById`가 파일 B에 정의된 함수를 호출한다는 사실도 알고 있습니다.

**성능:** 900배 더 빠름(코드베이스 간 탐색의 경우 50ms vs 45초)

# 지원되는 언어

Python, TypeScript, Go, Rust, Java, C/C++, C#, PHP, Kotlin, Ruby, HTML/CSS

# 설정

LSP는 v2.0.74부터 내장되어 있습니다. 이전 버전의 경우:

ENABLE_LSP_TOOL=1 내보내기

# 파트 9: MCP 도구 검색 - 85% 컨텍스트 혁명

**V4의 가장 큰 변화입니다.**

# 문제

연결하는 모든 MCP 서버는 설명, 매개변수, 스키마와 같은 도구 정의를 가져옵니다. 도구 검색 전에 Claude는 시작 시 **모든 항목**을 로드했습니다.

이전:
73개의 MCP 도구 로드 중... [39.8k 토큰]
56개 에이전트 로드 중... [9.7k 토큰]
시스템 도구 로드 중... [22.6k 토큰]
남은 토큰은 92,000개로 준비되었습니다. ← 아무것도 입력하기 전에 54% 컨텍스트가 사라짐

사용자는 단일 프롬프트를 작성하기 전에 200K 컨텍스트의 50-70%가 소비되었다고 보고했습니다.

# 해결책: 지연 로딩

Claude Code 2.1.7에서는 MCP 도구 검색을 도입했습니다.

이후:
도구 레지스트리 로드 중... [5,000개 토큰]
195,000개의 토큰을 사용할 수 있습니다. ← 95% 컨텍스트 보존

사용자: "데이터베이스를 쿼리해야 합니다."
> 자동 로딩: postgres-mcp [+1.2k 토큰]
> 193.8k 토큰 남음

# 작동 원리

1. **탐지**: Claude Code는 MCP 도구 설명이 컨텍스트의 10% 이상을 사용하는지 확인합니다.
2. **레지스트리 생성**: 도구 이름 및 설명에 대한 간단한 색인을 구축합니다.
3. **주문형 로딩**: Claude가 필요하다고 판단한 경우에만 도구가 로드됩니다.
4. **지능형 캐싱**: 로드된 도구는 세션 기간 동안 계속 사용할 수 있습니다.

# 숫자

|측정항목|이전|이후|개선|
|:-|:-|:-|:-|
|초기 컨텍스트 사용량|~77K 토큰|~8.7K 토큰|**85% 감소**|
|Opus 4 정확도|49%|74%|+25퍼센트 포인트|
|Opus 4.5 정확도|79.5%|88.1%|+8.6% 포인트|

# 구성

MCP 도구 검색은 도구가 컨텍스트의 10%를 초과하는 경우 **기본적으로 활성화**됩니다.

컨텍스트 사용량을 확인하려면:

/컨텍스트

특정 서버에 대해 비활성화하려면(항상 특정 도구가 즉시 필요한 경우):

{
"mcpServer": {
"항상 필요한": {
"명령": "...",
"enable_tool_search": 거짓
}
}
}

자동 활성화 임계값을 구성하려면:

{
"mcp": {
"tool_search": "auto:15" // 컨텍스트 사용량 15%에서 활성화
}
}

# 이것이 당신에게 의미하는 바

* **더 많은 MCP 서버**: 페널티 없이 수십 대 연결
* **정확도 향상**: 소음 감소 = 더 나은 도구 선택
* **대규모 작업**: 실제 작업에 대한 더 많은 맥락
* **워크플로 변경 없음**: 도구는 이전과 동일하게 작동합니다.

Simon Willison 댓글 작성:

>"이것은 MCP 설정과 관련된 가장 고통스러운 확장 문제 중 하나를 해결합니다. 5개의 서버를 실행하고 실제 작업이 시작되기 전에 컨텍스트가 증발하는 것을 지켜보았습니다."

# 파트 10: 사용자 지정 에이전트 - 자동 위임

사용자 정의 에이전트는 Claude가 도구를 자동으로 선택하는 방식과 같이 **자동으로** 호출하는 특수 도우미입니다.

# 왜 맞춤형 에이전트인가?

# 사용자 정의 에이전트 생성

**방법 1: 대화형(권장)**

/에이전트

"새 에이전트 만들기" -> 위치 선택(사용자 또는 프로젝트) -> Claude 또는 수동으로 생성을 선택합니다.

**방법 2: 수동**

`~/.claude/agents/code-reviewer.md`를 생성합니다:

---
이름: 코드 검토자
설명: 보안, 성능 및 모범 사례에 대한 코드 검토
도구: 읽기, Grep, Glob
모델: 소네트
---

귀하는 다음 분야를 전문으로 하는 선임 코드 검토자입니다.
- 보안 취약점(OWASP Top 10)
- 성능 안티패턴
- 오류 처리 공백
- 코드 유지보수성

검토할 때:
1. 보안 문제부터 시작하세요
2. 그러면 성능 문제
3. 그런 다음 스타일/유지관리성
4. 특정 라인 참조 제공
5. 구체적인 수정 제안

비판적이지만 건설적이어야 합니다. 왜 문제가 있는지 설명하세요.

# 에이전트 구성 옵션

---
이름: 에이전트 이름 # 필수
설명: 사용 시기 # 필수 - Claude는 이를 사용하여 위임을 결정합니다.
tools: Read, Write, Bash # 선택 사항 - 생략하면 모두 상속됩니다.
모델: sonnet # 선택 사항 - sonnet, opus 또는 haiku
---

# 자동 위임 작동 방식

Claude 대표단은 다음을 기반으로 합니다.

1. 귀하의 요청에 있는 작업 설명
2. 에이전트 구성의 `설명` 필드
3. 현재 상황
4. 사용 가능한 도구

**예:**

당신: "보안 문제에 대한 인증 모듈을 검토하세요"

Claude는 "이것은 보안에 초점을 맞춘 코드 검토 작업입니다"라고 생각합니다.
-> 코드 검토자 에이전트에 위임
-> 에이전트는 격리된 컨텍스트로 실행됩니다.
-> 결과를 기본 대화로 반환합니다.

# 내장 에이전트

Claude Code에는 기본적으로 다음이 포함됩니다.

|에이전트|목적|사용시|
|:-|:-|:-|
|**탐색**|읽기 전용 코드베이스 분석|코드 검색, 이해|
|**계획**|기획 연구|계획 모드 컨텍스트 수집|
|**범용**|복잡한 다단계 작업|탐색 + 수정 필요|

# 모범 사례

1. **상담원 집중 유지**: 상담원당 하나의 전문 분야
2. **명확한 설명 작성**: Claude는 이를 사용하여 위임을 결정합니다.
3. **제한 도구**: 읽기 전용 에이전트에는 쓰기 액세스 권한이 없어야 합니다.
4. **위임 테스트**: Claude가 작업을 올바르게 라우팅하는지 확인
5. **최대 3~4명의 상담원으로 시작**: 옵션이 너무 많으면 라우팅이 혼란스러울 수 있습니다.

# 핫 리로드

`~/.claude/agents/` 또는 `.claude/agents/`의 신규 또는 업데이트된 에이전트를 **즉시** 사용할 수 있습니다. 다시 시작할 필요가 없습니다.

# 11부: 세션 순간이동

터미널과 clude.ai/code 사이에서 작업을 원활하게 이동하세요.

# 웹으로 순간이동

/텔레포트

`claude.ai/code`에서 현재 세션을 엽니다. 완벽한 대상:

* 터미널에서 시각적 인터페이스로 전환
* 공동작업자와 세션 공유
* 다른 기기에서 계속하기

# 원격 환경 구성

/원격 환경

원격 세션에 대한 환경 변수 및 구성을 설정합니다.

# 세션 재개

# 가장 최근 세션을 계속합니다.
클로드 --계속
# 또는
클로드 -c

# ID별로 특정 세션을 재개합니다.
클로드 --abc123 재개
# 또는
클로드 -r abc123

# 새로운 프롬프트로 재개
claude --resume abc123 "테스트를 계속하세요"

# VSCode: 원격 세션 탐색

이제 OAuth 사용자는 VSCode 확장의 세션 대화 상자에서 직접 원격 Claude 세션을 탐색하고 재개할 수 있습니다.

# 12부: 백그라운드 작업 및 병렬 실행

# 배경 작업

**Ctrl+B**를 눌러 배경으로 이동:

* 현재 실행 중인 에이전트
* 쉘 명령
* 둘 다 동시에(V4에서는 통합된 동작)

# 백그라운드 작업 관리

/작업

다음을 포함한 모든 백그라운드 작업을 표시합니다.

* 상태 표시기
* 상담원의 최종 응답을 인라인으로 표시
* 전체 성적표에 대한 클릭 가능한 링크

# 작업 알림

백그라운드 작업이 완료되면:

* 알림은 3줄로 제한됩니다.
* 여러 동시 완료에 대한 오버플로 요약
* 전체 내용을 읽지 않고도 최종 응답을 볼 수 있습니다.

# 백그라운드 작업 비활성화

이전 동작을 선호하는 경우:

CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=true 내보내기

또는 settings.json에서:

{
"enableBackgroundTasks": 거짓
}

# 13부: 새로운 명령, 단축키 및 삶의 질

# 새로운 명령

# 사용자 정의 키보드 단축키

`~/.claude/keybindings.json`을 만듭니다.

{
"ctrl+shift+r": "/검토",
"ctrl+shift+d": "/배포",
"ctrl+shift+t": "/테스트",
"ctrl+shift+c": "/커밋"
}

시작하려면 `/keybinds`를 실행하세요.

# 필수 단축키 참고

# 플랜 모드 개선

클로드가 계획을 제시하면:

* **Shift+Tab**: "편집 내용 자동 수락"을 빠르게 선택
* **피드백으로 거부**: 재실행하기 전에 무엇을 변경해야 할지 Claude에게 알려주세요.

# PR 리뷰 지표

이제 프롬프트 바닥글에 지점의 PR 상태가 표시됩니다.

* 컬러 도트(승인됨, 변경 요청됨, 보류 중, 초안)
* 클릭 가능한 PR 링크

# 언어 설정

글로벌 팀을 위한 출력 언어 구성:

{
"언어": "ja" // 일본어 출력
}

또는 CLAUDE.md에서:

## 언어
항상 스페인어로 응답하세요.

# 외부 CLAUDE.md 가져오기

추가 디렉터리에서 CLAUDE.md를 로드합니다.

CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 내보내기
클로드 --add-dir ../shared-configs ../team-standards

# VSCode 개선

* **권한 요청을 위한 클릭 가능한 대상 선택기**
* 설정이 저장되는 위치를 선택하세요: 이 프로젝트, 모든 프로젝트, 팀과 공유 또는 세션만
* **보조 사이드바 지원**(VS Code 1.97+) - 오른쪽 사이드바에 Claude Code, 왼쪽에 파일 탐색기
* **스트리밍 메시지 지원** - Claude가 작업하는 동안 실시간으로 응답 확인

# 환경 변수 참조

# 빠른 참조

|도구|목적|위치|
|:-|:-|:-|
|글로벌 CLAUDE.md|보안 + 스캐폴딩|`~/.claude/CLAUDE.md`|
|프로젝트 CLAUDE.md|아키텍처 + 팀 규칙|`./CLAUDE.md`|
|MCP 서버|외부 통합|`claude mcp add`|
|**MCP 도구 검색**|**지연 로딩(85% 절약)**|**컨텍스트가 10%를 초과하면 자동**|
|기술|재사용 가능한 전문 지식|`.claude/skills/*/SKILL.md`|
|**사용자 정의 에이전트**|**자동 위임**|`~/.claude/agents/*.md`|
|명령|개인 단축키|`~/.claude/commands/*.md`|
|후크|결정적 적용|`~/.claude/settings.json`|
|LSP|의미론적 코드 인텔리전스|내장(v2.0.74+)|
|**키바인딩**|**사용자 정의 단축키**|`~/.claude/keybindings.json`|
|`/clear`|컨텍스트 재설정|채팅에 입력|
|`/context`|토큰 사용량 보기|채팅에 입력|
|`/teleport`|claude.ai/code로 이동|채팅 내용 입력|
|`/tasks`|백그라운드 작업 관리|채팅에 입력|

# GitHub 레포

모든 템플릿, 후크, 기술 및 에이전트:

**github.com/TheDecipherist/claude-code-mastery**

* CLAUDE.md 템플릿(글로벌 + 프로젝트)
* 즉시 사용 가능한 후크(block-secrets.py, 설정 후크)
* 예시 스킬
* **맞춤 에이전트 템플릿(V4)**
* **키바인딩 예시(V4)**
* settings.json이 사전 구성됨

# 출처

# 인류 공식

* Claude 코드 모범 사례 - Anthropic
* 효과적인 컨텍스트 엔지니어링 - Anthropic
* 모델 컨텍스트 프로토콜 - Anthropic
* 에이전트 스킬 - Anthropic
* Claude Agent SDK를 사용하여 에이전트 구축 - Anthropic
* 사용자 정의 하위 에이전트 문서 - Claude Code Docs

# V4 기능 범위

* Claude Code 2.1.0 업데이트 - VentureBeat
* MCP 도구 검색 공지 - VentureBeat
* MCP 도구 검색 설명 - JP Caparas
* Claude Code 2.1 기능 - Datasculptor
* Claude 코드 변경 로그 - ClaudeLog

# 연구 및 분석

* 컨텍스트 부패 연구 - Chroma
* LLM은 다중 회전에서 길을 잃습니다 - arXiv
* Claude는 허가 없이 비밀을 로드합니다 - Knostic
* 복합공학 - Every

# 커뮤니티 리소스

* 멋진 Claude 코드 하위 에이전트 - GitHub
* 클로드 코드 치트시트 - AwesomeClaude
* 모든 Claude 코드 기능을 사용하는 방법 - Shrivu Shankar

*설정에는 무엇이 있나요? 아래에 에이전트, 후크 및 키 바인딩을 삭제하세요.*