Claude Code란 무엇인가
에이전트형 CLI/IDE 도구에 대한 설명 — 세션 루프, 설치, 그리고 모든 것이 어디에 있는지.
Claude Code Cheat Sheet
One printable page of Claude Code flags, commands, shortcuts, permission modes and file locations — every line checked against the official docs on 2026-10-13.
claude CLI: 결과를 바꾸는 플래그
Claude Code 명령줄을 관점을 담아 둘러봅니다 — 무인 실행을 위한 5개 플래그 계약, 기록된 시스템 프롬프트의 함정, 그리고 --bare, --safe-mode, --restricted의 차이.
CLAUDE.md 및 메모리 파일
가장 레버리지가 큰 Claude Code 커스터마이즈: 지속적인 프로젝트 메모리.
AGENTS.md & 도구 간 상호운용성
모든 코딩 에이전트가 읽는 개방형 표준 — 그리고 CLAUDE.md와 동기화 상태를 유지하는 방법.
플랜 모드
편집이 실행되기 전에 조사하고 제안한다 — 큰 변경을 다루는 가장 안전한 방법, 그리고 플랜 모드가 강제하지 않는 차단들.
IDE 통합
VS Code와 JetBrains 확장, 인라인 diff, 그리고 공유 설정.
settings.json: 설정 시스템
파일 계층과 우선순위, 핵심 섹션, 그리고 프로젝트 대 개인 설정.
권한과 권한 모드
allow/ask/deny 규칙과 모드 — 안전성은 지키면서 확인 프롬프트를 줄입니다.
Agent SDK Permissions: the Six-Step Order
Every permission bug in a headless agent is an order bug. The six steps the Agent SDK evaluates — which ones can only deny, which can only allow, and the five ways allowedTools silently does nothing.
샌드박스 자격 증명 마스킹: 토큰은 계속 작동시키되, 비밀은 유지하기
환경 변수, JWT, AWS SigV4 쌍, 자격 증명 파일을 마스킹하여 샌드박스 명령이 실제 비밀을 보지 않고도 인증하도록 합니다. 설정, 함정, OS 매트릭스.
커스텀 슬래시 명령어
반복하는 워크플로를 한 단어로 바꾸세요.
/design 명령: 코드보다 먼저 아트보드
Claude Code의 /design 스킬은 한 줄도 쓰기 전에 편집 가능한 UI 아트보드를 초안으로 만듭니다 — 어떻게 작동하는지, 언제 이기는지, 그리고 아무도 문서화하지 않는 함정들.
출력 스타일
Claude Code의 어조, 상세함, 교육 동작을 바꾼다.
상태줄 커스터마이즈
커스텀 스크립트로 모델, 작업 디렉터리, 컨텍스트 예산, git 상태를 드러내기.
Spec Kit을 활용한 명세 주도 개발
큰 기능을 바이브 코딩으로 만들지 마세요. 실행 가능한 명세를 단일 진실 공급원으로 삼고, GitHub의 Spec Kit으로 Claude Code가 그것을 바탕으로 빌드하게 하세요.
컨텍스트 관리
/compact 대 /clear, 자동 압축, 그리고 세션이 길어져도 효과적으로 유지하기.
컨텍스트 예산 감사: /skill-doctor, 출력 상한, 그리고 컨텍스트 창을 채우는 여섯 개의 숫자
느려지고, 지시를 잊어버리고, 비용이 올라간 Claude Code 프로젝트를 위한 20분 감사. /context와 /usage로 측정하고, /skill-doctor와 skillOverrides로 스킬 목록을 솎아내고, bashOutputMaxChars와 taskOutputMaxChars로 도구 출력을 제한하고, omitClaudeMd로 CLAUDE.md를 서브에이전트에서 빼고, 자동 압축 창을 의도적으로 설정하세요. 모든 수치는 2026년 9월 Claude Code 공식 문서를 출처로 합니다.
체크포인트와 되감기
Claude의 편집을 취소하고, 세션 전체를 되돌리고, /rewind로 컨텍스트를 압축하세요 — 야심 찬 작업을 위한 안전망입니다.
훅(Hooks): 결정론적 자동화
생명주기 이벤트에 명령을 실행해 포맷팅, 게이트, 안전장치를 강제한다.
스킬(Skills): 온디맨드 전문성
SKILL.md, 점진적 공개, 그리고 Skill vs 명령 vs 서브에이전트 vs MCP.
서브에이전트 & 병렬 에이전트
범위가 지정된 도구를 가진 격리 컨텍스트 에이전트에게 위임하기 — 그리고 언제 하지 말아야 하는지.
서브에이전트 플릿 한계: 동시성 캡 & 중첩 깊이
2026년 7월 21일 Claude Code는 동시 서브에이전트를 20개로 캡핑하고 중첩 스포닝을 제거했습니다. 3일 후 중첩이 깊이 3으로 돌아왔습니다. 네 개의 환경 변수, 마주칠 에러, 캡이 존재하는 이유, 그리고 그것들을 살아남는 플릿 설계법.
동적 워크플로우와 ultracode
Claude가 작성한 스크립트에서 수십에서 수백 개의 서브에이전트를 오케스트레이션 — 코드베이스 감사, 대규모 마이그레이션, 교차 검증 리서치를 위해.
세션 간 메시징
복사-붙여넣기 없이 두 개의 Claude Code 터미널이 대화하게 만들기 — 피어 투 피어 세션 메시징을 위한 세 가지 실제 배포 패턴과 절대 건너뛰면 안 되는 신뢰 경계.
Projects: The Coordinator & Parallel Threads
On September 17, 2026 Claude Code Projects became an orchestration layer: a coordinator that scopes and delegates, and threads that are full cloud sessions, each on its own branch and repo copy. Here is the architecture, how it differs from subagents and worktrees, what it costs against your usage limits, and the eligibility rule that explains why you may not have it yet.
Claude Code의 MCP 서버
Model Context Protocol로 데이터베이스, GitHub, 브라우저 등을 연결한다.
백그라운드 작업, /loop & 스케줄링
장시간 실행되는 명령, 반복 루프, 그리고 예약된 클라우드 에이전트.
자동 커밋 백그라운드 에이전트: 드래프트 PR 핸드오프
2026년 7월 1일 Claude Code v2.1.198은 백그라운드 에이전트가 스스로 커밋, 푸시하고 드래프트 PR을 열 수 있게 했다. 5주 뒤 v2.1.221이 기본값을 조정했다. 이 흐름이 실제로 무엇을 하는지, 어떤 알림 훅을 발동시키는지, 왜 커뮤니티가 오프 스위치를 원했는지, 그리고 여전히 유효한 propose-only 패턴을 소개한다.
플러그인과 마켓플레이스
스킬, 에이전트, 명령어, 훅, MCP를 설치 가능한 하나의 단위로 묶습니다.
Mods: In-Process Extensions
Mods are TypeScript middleware that runs inside Claude Code — rewrite tool calls, prompts, turns, and the interface itself.
플러그인 Eval: claude plugin eval로 플러그인을 테스트하기
Claude Code 플러그인이 실제로 도움이 되는지 증명하세요 — eval 케이스를 쓰고, 여섯 가지 채점기 유형으로 채점하고, with/without 델타를 읽고, MCP 서버를 목(mock)으로 대체하고, 점수로 CI를 게이트하기.
Git 워크트리 & 병렬 작업 흐름
하나의 저장소에서 여러 격리된 Claude 세션을 충돌 없이 실행하기.
Parallel Agents at Merge Time: Intent Conflicts and the CI Wall (2026)
Worktrees stop agents from overwriting each other's files. They don't stop two plans that can't both be true from merging cleanly. The coordination layer above Git (Foremerge's protocol, decoded) plus the CI surgery Linear did when agents started adding 2,000 tests a week — with every number.
헤드리스 모드 & Agent SDK
CI에서 Claude Code를 실행하고, 동일한 하니스 위에서 프로덕션 에이전트를 구축하기.
Cloud Sessions: the VM Claude Code runs in when it isn't your laptop
Practitioner guide to Claude Code cloud sessions and cloud environments — exactly what carries over from your machine and what silently doesn't, the four network access levels and the four paths that bypass them, network secrets, setup scripts vs SessionStart hooks, the ~5-minute cache rule, resource and time limits, and the --cloud/--teleport round trip.
셀프 호스팅 환경: 클라우드 세션을 여러분의 서버에서 실행
claude self-hosted-runner 베타(2026년 8월 7일 v2.1.224로 출시) 실무자 가이드. Claude Code 웹, 모바일, 데스크톱 클라우드 세션을 여러분이 통제하는 인프라에서 실행 — 아웃바운드 전용, 인바운드 구멍 없음, 한 사용자당 격리. 아키텍처, 퀵스타트, 러너 라이프사이클, git 자격 증명, 오토스케일링, 그리고 첫 플릿을 걸려 넘어지게 하는 여섯 가지 함정.
MCP 토큰 세금
MCP 서버를 연결하면 첫 요청 전에 5만~15만 토큰이 타 버리는 이유 — 그리고 세 가지 해법: Tool Search, 코드 실행, 그리고 CLI 호출이 이기는 순간을 아는 것.
접근성
Claude Code의 스크린 리더 모드, vim 인체공학, 마우스 및 스크롤 제어, 고대비 테마.
Claude Code 문제 해결
멈춤, 높은 메모리 사용, 검색 오작동, 압축 반복, 깨진 터미널에 대한 증상별 해결책.
Feature Flags: Why Your Claude Code Isn't Mine
Claude Code switches features on with flags it fetches from Anthropic. Privacy env vars, Bedrock, gateways and fresh installs silently turn that fetch off — here's exactly what you lose and how to pin behavior instead.