이 페이지의 목차
이 페이지의 목차
처음 보는 용어(영어 설정 이름, 명령, 파일 형식)는 용어 사전에서 쉬운 풀이와 자세히 볼 페이지를 찾는다. 처음 시작하는 순서(설치·작동 방식 → 권한 모드 → 샌드박스·작업 공간 신뢰 → CLAUDE.md → 스킬)는 처음 시작하기 - 비개발자를 위한 AI 에이전트 입문 코스의 B 갈래, 자주 묻는 질문은 초보자가 자주 묻는 질문.
Claude Code는 LLM(대규모 언어 모델) 에이전트다. 이 페이지는 활용법을 모은다. Karpathy LLM Wiki
코드를 추론하는 모델에 파일 작업, 검색, 실행, 웹 접근용 내장 도구를 결합한 형태이고, 내장 도구로 대부분의 코딩 작업을 다룬다. 그 위에 Claude가 아는 것을 맞추고, 외부 서비스에 연결하고, 워크플로를 자동화하는 확장 층을 얹는다. Claude Code 확장 기능 개요
확인 날짜 안내
확인 날짜: 확장 기능·메모리·스킬·권한 모드 부분과 "작동 방식"·"컨텍스트 창" 절은 공식 문서 수집일(2026-10-18, 원본 작성일 미상), 직무별 플러그인 설치는 GitHub 저장소 수집일(2026-10-18), 지시 방법 비교는 Anthropic 블로그 발행일(2026-06-18), LLM Wiki 부분은 Karpathy 원본 수집일(2026-10-16, 원본 날짜 미상), "컨텍스트를 다루는 방식" 절은 Anthropic 글 발행일(2025-09-29) 기준이다. 페이지 확인 날짜는 2025-09-29다. 이 절의 컴팩션 설명은 공식 컨텍스트 창 문서가, 혼합 검색(CLAUDE.md를 매 세션 넣고 패턴·정규식 검색 도구로 파일을 찾음)은 공식 문서 Claude Code 작동 방식이 확인하고, 할 일 목록은 공식 Tools reference Claude Code 도구 레퍼런스(수집 2026-10-26)로 갱신했다. 큰 데이터 분석(head·tail)은 아직 2025년 글에만 근거한다(Tools reference는 head·tail을 파일 보기 명령 목록으로만 든다.).
작동 방식: 에이전트 루프와 접근 범위 (2026-10-18 기준)#
공식 문서 "How Claude Code works"는 Claude Code를 터미널에서 도는 에이전트형 도우미로 소개하고, 코딩에 뛰어나지만 문서 쓰기, 빌드, 파일 검색, 주제 조사처럼 명령줄에서 할 수 있는 일이면 무엇이든 도울 수 있다고 말한다. Claude Code 작동 방식
- 에이전트 루프: 맥락 수집 → 행동 → 결과 확인을 작업이 끝날 때까지 반복하고, 사용자는 언제든 끼어든다. 루프를 움직이는 것은 추론하는 모델과 행동하는 도구이고, Claude Code는 그 둘레에서 도구를 주고 컨텍스트를 관리하는 하네스다. → 에이전트 루프
- 내장 도구 다섯 범주: 파일 작업(읽기·편집·만들기·이름 바꾸기), 검색(패턴으로 파일 찾기·정규식 내용 검색), 실행(셸 명령·서버·테스트·git), 웹(검색·문서 가져오기), 코드 인텔리전스(편집 뒤 타입 오류, 정의로 이동, 참조 찾기. 코드 인텔리전스 플러그인 필요). 이 밖에 서브에이전트 생성, 사용자에게 질문하기 같은 조율용 도구가 있다. 전체 목록은 원본이 Tools reference로 넘긴다.
- Claude가 접근하는 것:
claude를 실행한 디렉터리와 하위 디렉터리의 파일(다른 곳은 허락을 받아), 사용자가 명령줄에서 돌릴 수 있는 명령, git 상태(브랜치·커밋하지 않은 변경·최근 커밋), CLAUDE.md(또는 AGENTS.md), 자동 메모리(MEMORY.md앞 200줄 또는 25KB), 설정한 확장(MCP 서버, 스킬, 서브에이전트, Claude in Chrome). 묻지 않고 실행하는 범위는 권한 모드와 규칙이 정한다. - 두 안전장치: 파일 편집 전 스냅샷(체크포인트,
Esc두 번으로 되감기. 파일 변경만, 원격 동작은 제외)과 권한 모드. → Claude Code 세션·체크포인트 다루기
실행 환경과 인터페이스 (2026-10-18 기준). 원본은 에이전트 루프·도구·능력이 어디서 쓰든 같고, 바뀌는 것은 코드가 도는 곳과 상호작용 방식이라고 말한다. Claude Code 작동 방식
| 환경 | 코드가 도는 곳 | 원본이 든 쓰임 |
|---|---|---|
| Local | 내 컴퓨터 | 기본값. 내 파일· |
| Cloud | Anthropic 관리 VM, 또는 조직이 운영하는 self-hosted 환경 | 작업 넘기기, 로컬에 없는 저장소 작업 |
| Remote Control | 내 컴퓨터, 브라우저에서 조종 | 웹 UI를 쓰면서 실행과 파일은 로컬에 |
인터페이스는 터미널, 데스크톱 앱, IDE 확장, claude.ai/code, Remote Control, Slack, CI/CD 파이프라인이다. Claude Code 작동 방식 인터페이스별 권한 모드 차이는 Claude Code 권한 모드 고르기, 세션 종류별로 닿는 관리 정책은 Claude Code managed settings 배포·점검에 있다.
모델 (원본 당시 예시). 장단점이 다른 여러 모델을 쓸 수 있다. 원본은 Sonnet이 대부분의 코딩 작업을 잘 다루고 Opus가 복잡한 아키텍처 결정에 더 강한 추론을 준다고 쓴다. Claude Code 작동 방식
확장 기능 지도#
확장 기능은 에이전트 루프의 서로 다른 지점에 꽂힌다. 원본은 처음 쓰면 CLAUDE.md부터 시작하고 나머지는 계기가 생길 때 더하라고 권한다. Claude Code 확장 기능 개요
| 기능 | 한 줄 설명 |
|---|---|
| 메모리 | 매 세션 보는 지속 컨텍스트 |
| 출력 스타일 | 세션의 모든 응답에 역할· |
| 스킬 | 재사용 지식과 부를 수 있는 워크플로. 원본이 "가장 유연한 확장"이라 부름 |
| Code intelligence | 언어 서버로 심볼 단위 탐색과 실시간 타입 오류 |
| MCP | 외부 서비스· |
| 서브에이전트 | 격리된 컨텍스트에서 자기 루프를 돌고 요약 반환. 내장 Explore· |
| Dynamic workflows | Claude가 쓴 스크립트로 많은 서브에이전트를 돌려 결과 하나 반환 |
| Cross-session messaging | 내 세션 하나에서 다른 세션으로 메시지 전달 |
| 훅 | 생명주기 이벤트에 스크립트· |
| 플러그인· | 위 기능을 묶어 설치· |
근거: Claude Code 확장 기능 개요 (원본 Overview 목록 순서). 원본은 기능 범위를 "매 세션 보는 상시 컨텍스트"에서 "필요할 때 부르는 기능", "특정 이벤트에 도는 백그라운드 자동화"까지로 설명하고, 플러그인을 포장 층이라 부른다.
원본은 이 밖에 세션 결과를 비공개 인터랙티브 웹 페이지로 게시하는 Artifact도 목표별 표에 넣었다. Claude Code 확장 기능 개요
- 무엇을 고를지: Claude Code 확장 기능 고르기
- 직무별 플러그인 설치(2026-10-18 기준): Anthropic의 Knowledge Work Plugins는 Cowork용으로 만들었고 Claude Code와도 호환된다.
claude plugin marketplace add anthropics/knowledge-work-plugins뒤claude plugin install sales@knowledge-work-plugins처럼 설치하고, 설치하면 자동으로 켜진다. Knowledge Work Plugins 저장소 → 업무 플러그인 설치·맞춤화 - 무엇부터 더할지: Claude Code 셋업 점진적으로 키우기
- 각 기능이 컨텍스트를 얼마나 쓰는지: 컨텍스트 비용
스킬 (2026-10-18 기준)#
SKILL.md 하나로 Claude에게 지식이나 워크플로를 더한다. 기존 커스텀 명령(.claude/commands/)은 스킬에 합쳐졌고 그대로 동작한다. Claude Code 스킬은 여러 AI 도구에서 통하는 Agent Skills 개방형 표준을 따르고 호출 제어, 서브에이전트 실행, 동적 컨텍스트 주입을 더한다. Claude Code 스킬
- 개념, 위치, 로드 방식, 누가 부르는지: 스킬
- 업무 절차를 스킬로 만들고 평가하는 순서: 업무 절차를 스킬로 만들기
- 트리거 안 됨, 중간에 안 따름, 설명 잘림: 스킬 문제 해결
(2026-06-18 기준) Anthropic 블로그 글은 같은 확장 층을 "지시를 전달하는 일곱 가지 방법"(CLAUDE.md, rules, 스킬, 서브에이전트, 훅, 출력 스타일, 시스템 프롬프트 덧붙이기)으로 다시 묶고, 언제 로드되나·컴팩션 뒤 남나·얼마나 권위를 갖나로 비교한다. 모델과 effort 수준은 이와 별개의 다이얼이다. Steering Claude Code → Claude Code 확장 기능 고르기
권한 모드 (2026-10-18 기준)#
권한 모드는 한 세션에서 Claude가 먼저 묻지 않고 할 수 있는 동작을 정한다. 모드는 Manual(default), acceptEdits, plan, auto, dontAsk, bypassPermissions 여섯 가지이고, v2.1.283 이상에서는 다른 설정이 없고 자동 모드를 쓸 수 있으면 대화형 터미널·VS Code 세션이 자동 모드(분류기가 사람 대신 검토)로 시작한다. 모드는 기준선이고 그 위에 allow·ask·deny 규칙을 얹으며, deny 규칙은 모든 모드에서 막는다. Claude Code 권한 모드
- 개념, 어떤 모드도 자동 승인하지 않는 것, 분류기, 보호·치명 경로: 권한 모드
- 모드별로 무엇을 묻나, 상황별 시작 설정: Claude Code 권한 모드 고르기
- 관리자가 managed settings로 통제하는 법: Claude Code 관리자 권한 통제
- allow·ask·deny 규칙 문법(평가 순서 deny → ask → allow, Bash 와일드카드, 경로 패턴, 도구별 규칙)과 저장소 설정의 작업 공간 신뢰(2026-10-21 기준): Claude Code 권한 규칙 문법, 작업 공간 신뢰Claude Code 권한 설정
- managed settings의 우선순위·출처 합치기·한계: managed settings. 배포(OS별 경로, MDM·서버·파일)와
/status의Setting sources줄·claude doctor로 적용 확인: Claude Code managed settings 배포·점검Claude Code managed settings 배포
설정 파일 (2026-10-21 기준)#
동작을 바꾸는 JSON 키는 네 파일에서 읽는다: ~/.claude/settings.json(나, 모든 프로젝트), .claude/settings.json(커밋하면 팀 모두), .claude/settings.local.json(나, 이 프로젝트), 조직이 배포하는 managed settings. 같은 키는 managed > 명령줄 --settings > local > shared project > user 순으로 높은 쪽이 이기고, 목록 키는 합쳐진다. 단 보안 민감 키 11개는 낮은 범위의 더 엄격한 값을 managed보다 따르고, 모델 관련 키 4개는 자기 규칙을 따르며, 환경 변수는 이 층 밖에서 키·변수 쌍마다 따로 정한다. 터미널, VS Code·JetBrains 확장, 데스크톱 앱은 같은 파일을 읽고, 클라우드 세션은 user·local 파일과 기기의 managed 파일·MDM을 읽지 않는다. 저장소 하나인 세션은 커밋한 .claude/settings.json을 읽고, 조직의 서버 관리 설정은 닿는다(어떤 클라우드 세션이 받는지는 원본이 surface coverage 표로 넘긴다). Claude Code 설정 파일과 우선순위 → Claude Code 설정 파일, 바꾸고 확인하는 절차는 Claude Code 설정 바꾸기·확인·문제 해결. 키별 타입·기본값·Scope·최소 버전은 공식 settings reference(수집 2026-10-21)를 주제별 표로 옮긴 Claude Code 설정 키 레퍼런스에 있다. Claude Code 설정 키 전체 레퍼런스
세션을 넘는 기억: 메모리 두 가지 (2026-10-18 기준)#
세션은 매번 빈 컨텍스트 창으로 시작한다. 지식을 잇는 장치는 사용자가 쓰는 CLAUDE.md(또는 AGENTS.md)와 Claude가 스스로 쓰는 자동 메모리 둘이며, 둘 다 매 대화 시작 때 로드된다. Claude는 이를 강제 설정이 아니라 컨텍스트로 다룬다. Claude Code 메모리
- CLAUDE.md의 범위(managed·user·project·local), 로드 순서, import, 규칙 파일: 메모리(CLAUDE.md)
- Claude가 쓰는 노트,
MEMORY.md200줄·25KB 로드 한도: 자동 메모리(Auto memory) - 만들고 나누고 점검하는 절차: CLAUDE.md 작성·구성
- 지켜지지 않을 때: CLAUDE.md 문제 해결
- Codex 등과 AGENTS.md 공유, Codex와의 지시 파일 탐색 규칙 비교: AGENTS.md와 CLAUDE.md 함께 쓰기. Claude Code는 Codex가 쓰는
AGENTS.override.md를 읽지 않는다. Claude Code 메모리
컨텍스트 창 (2026-10-18 기준)#
공식 문서 "Explore the context window"는 세션 하나를 시작부터 컴팩션까지 재생해 보여 준다. 원본 토큰 수는 예시다. Claude Code 컨텍스트 창
- 입력 전에 시스템 프롬프트, 자동 메모리, 환경 정보, MCP 도구 이름, 스킬 설명, 전역·프로젝트 CLAUDE.md가 로드되고, 이 내용은 터미널에 보이지 않는다. 비용 쪽 정리는 컨텍스트 비용.
- 컨텍스트를 가장 많이 쓰는 것은 파일 읽기다. 프롬프트를 구체적으로 쓰고 리서치는 서브에이전트에 맡긴다.
- 한도에 가까워지면 자동으로 컴팩션해 세션이 끝나지 않는다. 컴팩션 뒤에는 시작 때 로드된 것(루트 CLAUDE.md, 범위 없는 rules, 자동 메모리, 출력 스타일)이 다시 들어오고, 대화 중 로드된 것(경로별 규칙, 하위 디렉터리 CLAUDE.md, 훅이 더한 컨텍스트)은 요약된다. 최근 수정된 파일 최대 5개를 다시 읽고 호출한 스킬을 예산 안에서 다시 붙인다. 표와 미리 손쓰는 방법은 장기 작업 컨텍스트 관리.
- Fable 모델, Sonnet 5 이상, Haiku 5.5, Opus 4.6 이상, Sonnet 4.6이 100만 토큰 컨텍스트 창을 지원한다(
[1m]모델 변형. 플랜별 가용성과 선택 방법은 원본이 Extended context 문서로 넘김). 자동 컴팩션이 도는 지점은 모델과 설정에 따라 다르다.
컨텍스트를 다루는 방식 (2025-09-29 기준)#
Anthropic 엔지니어링 글이 컨텍스트 엔지니어링 사례로 든 Claude Code의 동작이다. 원본 발행 이후 바뀌었을 수 있다. 효과적인 컨텍스트 엔지니어링
- 혼합 검색: CLAUDE.md는 처음부터 컨텍스트에 넣고, glob·grep 같은 기본 도구로 파일을 그때그때 찾는다. → 메모리(CLAUDE.md) 공식 문서(2026-10-18 기준)도 CLAUDE.md를 매 세션 싣고 패턴·정규식 검색 도구로 파일을 찾는다고 설명한다. Claude Code 작동 방식
- 큰 데이터 분석: 목표 쿼리를 쓰고 결과를 저장하며,
head·tail같은 Bash 명령으로 큰 데이터를 다뤄 전체 데이터를 컨텍스트에 싣지 않는다. - 컴팩션: (공식 문서 2026-10-18 기준: 한도에 가까워지면 오래된 도구 출력부터 지우고, 필요하면 대화를 요약한다. Claude Code 작동 방식) 2025년 글의 설명: 메시지 기록을 모델에 넘겨 요약·압축한다. 아키텍처 결정, 해결되지 않은 버그, 구현 세부는 남기고 중복된 도구 출력이나 메시지는 버린 뒤, 압축된 컨텍스트와 가장 최근에 접근한 파일 5개로 이어 간다. 공식 문서(2026-10-18 기준)도 요약과 파일 최대 5개 다시 읽기를 확인하되, 기준을 "최근 수정된 것부터"로 적는다(상충 표시는 장기 작업 컨텍스트 관리). Claude Code 컨텍스트 창 → 장기 작업 컨텍스트 관리
- 할 일 목록: (2026-10-26 기준) 공식 Tools reference는 할 일 도구(
TaskCreate·TaskGet·TaskList·TaskUpdate, 예전TodoWrite는 기본으로 꺼짐)가 Opus 4.7·Sonnet 4.6·Haiku 4.5와 그 이전 모델에서만 기본으로 주어지고, 더 새 모델은 적어 둔 체크리스트 없이 여러 단계 일을 추적한다고 적는다. 필요하면CLAUDE_CODE_ENABLE_TODO_TOOLS=1로 켠다(v2.1.268 이상의 기본값, 세부는 Claude Code 내장 도구). Claude Code 도구 레퍼런스 2025년 글의 설명: 원본은 Claude Code가 할 일 목록을 만드는 것을 구조화된 노트의 예로 든다(그 시점 동작, 이력은 Claude Code 내장 도구).
근거: 효과적인 컨텍스트 엔지니어링
유용한 명령 (원본에 나온 것)#
/model— 세션 중 모델 바꾸기.claude --model <name>으로 시작할 때 고른다. Claude Code 작동 방식claude --continue·claude --resume— 같은 세션 ID로 대화를 다시 열어 이어 쓴다.--fork-session·/branch— 기록을 새 세션 ID로 복사해 갈라 본다./resume선택 창은 기본으로 현재 worktree의 세션을 보여 준다. Claude Code 작동 방식 → Claude Code 세션·체크포인트 다루기Esc— 즉시 멈추고 실행 중인 도구 호출을 취소한다.Esc두 번 — 체크포인트로 파일을 이전 상태로 되감는다. Claude Code 작동 방식/doctor— 체크인된 CLAUDE.md를 줄일 제안을 받는다. Claude Code 확장 기능 개요 설치·설정 문제를 진단하고 고칠 수 있는 셋업 점검이다. Claude Code 작동 방식/doctor prompt-audit— 지시 파일의 낡은 지시, 없는 파일·명령 참조, 파일 간 모순을 찾아 수정 제안을 낸다. v2.1.283 이상. Claude Code 메모리/init— 코드베이스를 분석해 시작용 CLAUDE.md를 만든다. 이미 있으면 개선안을 낸다. Claude Code 메모리/memory— CLAUDE.md·CLAUDE.local.md 등 메모리 파일을 열어 고치고, 자동 메모리를 켜고 끄고, 자동 메모리 폴더를 연다. Claude Code 메모리/context— Memory files 목록에서 시작 때 로드된 CLAUDE.md와 규칙 파일을 확인한다. Claude Code 메모리 지금 컨텍스트 사용량을 카테고리별로 보여 주고 최적화 제안을 낸다. Claude Code 컨텍스트 창/compact— 대화를 구조화된 요약으로 바꾼다./compact focus on the auth bug fix처럼 지시를 붙이면 요약이 그것을 남긴다./rewind에서 메시지를 골라 Summarize from here·Summarize up to here로 일부만 요약한다./autocompact 500k처럼 토큰 수를 주면 자동 컴팩션이 도는 지점을 정한다./clear는 관련 없는 일로 넘어갈 때 비운다. Claude Code 컨텍스트 창 → 장기 작업 컨텍스트 관리!접두어 —!git status처럼 셸 명령을 직접 실행하면 명령과 출력이 사용자 메시지의 일부로 컨텍스트에 들어간다. Claude가 실행하지 않아도 결과를 근거로 줄 때 쓴다. Claude Code 컨텍스트 창/config— Project instructions 설정으로 CLAUDE.md·AGENTS.md 중 무엇을 읽을지 고른다. Claude Code 메모리 Config 탭은 테마·편집기 모드 같은 짧은 개인 옵션 목록이고, 대부분~/.claude/settings.json에 저장한다./config verbose=true처럼key=value로 하나만 바꿀 수 있다. 터미널 인터페이스 기능이라 VS Code 채팅 패널·데스크톱 앱에서는 열리지 않는다(2026-10-21 기준). Claude Code 설정 파일과 우선순위/status—Setting sources줄에서 이번 세션에 로드된 설정 파일과 적용 중인 managed 출처를 본다. 어느 파일이 어느 키를 줬는지는 보여 주지 않는다.claude --settings '<JSON 또는 파일>'— 파일을 바꾸지 않고 그 세션에만 설정을 준다(managed 아래, 나머지 파일 위). 거부된 설정 항목은claude doctor(2026-10-21 기준). Claude Code 설정 파일과 우선순위/import— 다른 코딩 에이전트의 지시 파일, MCP 서버, 명령, 서브에이전트, 스킬을 가져온다. v2.1.213 이상. Claude Code 메모리--append-system-prompt— 시작 때 시스템 프롬프트에 지시를 더한다. Claude Code 메모리 블로그 글(2026-06-18)은 그 실행에만 적용된다고 썼지만, 공식 CLI 문서(2026-10-21 기준)는 첫 요청에서 만든 시스템 프롬프트를 세션에 기록해 컴팩션 전까지--resume·--continue로 돌아온 나중 실행에서도 쓴다고 적는다. 기본 동작이다. 기록하지 않는 예외(--system-prompt-snapshot off, 클라우드 세션 밖의--bare등)는 Claude Code CLI 플래그. 설명은 공식 기준으로 한다(‘원본끼리 달랐던 점’ 상자: Claude Code CLI 플래그). Steering Claude Code, Claude Code CLI 레퍼런스 → Claude Code CLI 플래그CLI 플래그 전체 — 세션 재개,
-p출력·한도(--output-format,--max-turns,--max-budget-usd), 시스템 프롬프트 다섯 개, 권한·도구,--bare·--safe-mode·--restricted의 조건은 Claude Code CLI 플래그. 원본은claude --help가 모든 플래그를 보여 주지 않는다고 한다(2026-10-21 기준). Claude Code CLI 레퍼런스/output-style <style>— 출력 스타일 바꾸기(예:/output-style concise). 인자 없이 실행하면 목록과 현재 스타일을 보여 준다./config→ Output style 메뉴도 같고, 둘 다 선택을.claude/settings.local.json에 저장한다. 설정 키는outputStyle(대소문자 구분). 세션 중 바꾸면 다음 메시지부터 적용된다(2026-10-18 기준). Claude Code 출력 스타일 → Claude Code 출력 스타일 설정·만들기/mcp— MCP 서버별 연결 상태를 본다. Claude Code 확장 기능 개요내장 도구 이름과 확인 여부, 규칙 형식(
Bash(npm run *),Read(~/secrets/**)등), 지금 세션의 도구 확인(What tools do you have access to?라고 묻기) — Claude Code 내장 도구. macOS·Linux·WSL에서는Glob·Grep이 기본으로 빠지고 Bash 검색으로 대신한다(2026-10-26 기준). Claude Code 도구 레퍼런스/context all— 로드된 MCP 도구별 토큰 사용량을 본다. Claude Code 확장 기능 개요명령 전체와 작업 흐름별 고르기(저장소 첫 세션, 작업 중, 병렬 작업, 배포 전, 세션 사이, 문제가 생겼을 때) — Claude Code 슬래시 명령. 명령은 메시지 맨 앞에서만 인식되고, 플랫폼·플랜에 따라 안 보이는 명령이 있다(2026-10-26 기준). Claude Code 명령어 레퍼런스
/code-review— 현재 diff나 PR 번호·브랜치·경로를 정확성 버그 기준으로 리뷰하고,--fix면 찾은 문제를 고친다./review는 별칭,/code-review ultra는 클라우드 다중 에이전트 리뷰(2026-10-26 기준)./security-review는 브랜치 diff의 보안 취약점을 본다. Claude Code 명령어 레퍼런스/usage— 세션 비용, 플랜 사용량 한도, 활동 통계. v2.1.251 이상에서는Prompt cache (main)줄로 프롬프트 캐시 적중률도 본다(2026-10-26 기준). Claude Code 명령어 레퍼런스, Claude Code 프롬프트 캐싱 → 프롬프트 캐싱번들 스킬
/code-review,/batch,/debug— 설정 없이 쓴다. Claude Code 확장 기능 개요 공식 스킬 문서는/doctor,/loop,/claude-api도 번들 스킬로 들고, 번들 스킬은 프롬프트 기반이라 고정 로직을 실행하는 대부분의 내장 명령과 다르다고 한다.disableBundledSkills로 끈다. Claude Code 스킬/doctor점검 범위(공식 스킬 문서) — 설치 상태, 확장 기능(안 쓰는 스킬·MCP 서버·플러그인을 컨텍스트 비용과 비교, 느린 훅), CLAUDE.md, 권한. 결과를 먼저 보고하고 바꾸기 전에 확인을 받는다. 세션 없이 읽기 전용 설치 진단만 하려면 터미널에서claude doctor. Claude Code 스킬/run,/verify,/run-skill-generator— 테스트만이 아니라 실제로 앱을 띄워 변경을 확인한다./run-skill-generator는 앱을 띄운 방법을.claude/skills/run-<name>/프로젝트 스킬로 기록한다. Claude Code 스킬/claude-api— 프로젝트 언어에 맞는 Claude API·Managed Agents 참고 자료를 로드한다. 코드가anthropic이나@anthropic-ai/sdk를 import하면 자동으로 켜진다. 하위 명령 예:migrate,prompt-audit,cost-optimize,build-eval(버전 조건은 원본 표). Claude Code 스킬Shift+Tab— 권한 모드 순환(CLI).--permission-mode <모드>로 시작 모드 지정,/plan을 프롬프트 앞에 붙이면 그 프롬프트만 plan 모드. plan 승인 전Ctrl+G로 계획을 편집기에서 수정. Claude Code 권한 모드/permissions— 권한 규칙 관리. Recently denied 탭에서 자동 모드가 막은 동작을r로 수동 승인해 재시도(분류기가 판정을 못 내고 막은 동작은 이 탭에 남지 않는다). Claude Code 권한 모드, Claude Code 스킬 각 규칙이 온 설정 파일을 보여 주고, Claude가 일하는 중에 바꾸면 같은 턴의 다음 도구 호출부터 적용된다(2026-10-21 기준, v2.1.234 이상)./cd <path>는 대화를 유지한 채 세션의 주 작업 디렉터리를 옮긴다(Cd규칙으로 제한 가능). Claude Code 권한 설정claude auto-mode defaults— 자동 모드 분류기의 기본 차단·허용 규칙 전체를 JSON으로 출력. Claude Code 권한 모드 (2026-10-21 기준)claude auto-mode config는 내 설정을 적용한 실제 규칙,critique는 직접 쓴 규칙에 대한 AI 피드백,reset은 user 설정의autoMode초기화./auto-mode-setup은 프로젝트와 최근 세션에서autoMode.environment초안을 만들어~/.claude/settings.json에 쓰고(플랜·버전 조건 있음),/permissions의 Auto mode 탭에서 분류기 규칙을 고친다(v2.1.246 이상). Claude Code 자동 모드 설정 → Claude Code 자동 모드 설정하기/sandbox— Bash 샌드박스를 켜고 auto-allow 모드 선택(macOS, Linux, WSL2)./add-dir— 작업 디렉터리 추가. Claude Code 권한 모드 (2026-10-21 기준)/sandbox패널은 Mode·Overrides(샌드박스 밖 재시도 허용 여부, Strict sandbox mode)·Config(해석된 설정) 탭을 보이고, Linux에서 의존성이 빠지면 Dependencies 탭을 보인다. 고른 값은.claude/settings.local.json에 저장된다. 샌드박스 경고(TLS 종료 불가, 모호한 도메인 항목, 남은 자리 표시자 파일)는claude doctor로 확인한다. Claude Code 샌드박스 → 샌드박스, Claude Code 샌드박스 설정하기/hooks— 설정된 훅을 이벤트별로 보는 훅 브라우저. 새로 만든 훅이 맞는 이벤트 아래 있는지 확인한다. 트랜스크립트 보기Ctrl+O에서 훅의 차단 메시지·오류 알림을 보고,claude --debug·claude --debug-file <경로>·세션 중/debug로 훅의 종료 코드·stdout·stderr를 디버그 로그에 남긴다. Claude Code 훅 가이드 → Claude Code 훅 설정 레시피, Claude Code 훅 문제 해결/hooks는 읽기 전용 브라우저로, 각 훅의 출처(사용자·프로젝트·로컬 설정, 플러그인, 현재 세션)를 표시하고 목록 끝All events로 훅이 없는 이벤트까지 본다.claude --debug의 로그는~/.claude/debug/<session-id>.txt에 쓰이고 터미널에는 출력되지 않는다(2026-10-18 기준). Claude Code 훅 레퍼런스/skills— 스킬 목록과 claude.ai 동기화 스킬 확인, Space로skillOverrides상태 변경./reload-skills— 세션 중 새로 만든 최상위 스킬 디렉터리 반영./skill-doctor— 스킬별 비용과 사용 빈도(v2.1.252 이상). Claude Code 스킬
LLM Wiki 운영 에이전트로 쓰기#
- LLM Wiki 아이디어 파일을 붙여 넣을 대상 에이전트의 예로 Claude Code가 들어 있다. 같은 목록에 OpenAI Codex, OpenCode / Pi도 있다. Karpathy LLM Wiki
- Claude Code에서는 위키의 스키마 파일이
CLAUDE.md다. 위키 구조, 규칙, 수집·질의·유지보수 워크플로를 여기에 적어 Claude Code를 규율 있는 위키 관리자로 만든다. Karpathy LLM Wiki CLAUDE.md 자체의 동작은 메모리(CLAUDE.md)에 있다. - 운영 작업: LLM Wiki 수집(Ingest), LLM Wiki 질의(Query), LLM Wiki 점검(Lint)