# Claude Code - 문서가 알려주지 않는 설정 가능한 모든 것 > Clean Markdown view of GeekNews topic #30030. Use the original source for factual precision when an external source URL is present. ## Metadata - GeekNews HTML: [https://news.hada.io/topic?id=30030](https://news.hada.io/topic?id=30030) - GeekNews Markdown: [https://news.hada.io/topic/30030.md](https://news.hada.io/topic/30030.md) - Type: GN+ - Author: [neo](https://news.hada.io/@neo) - Published: 2026-05-31T08:42:31+09:00 - Updated: 2026-05-31T08:42:31+09:00 - Original source: [buildingbetter.tech](https://buildingbetter.tech/p/i-read-the-claude-code-source-code) - Points: 1 - Comments: 1 ## Topic Body - **Claude Code 2.1.87**에는 문서화되지 않은 설정이 많고, 개인·프로젝트별 `.claude/` 파일로 Hooks, Skills, Agents를 나눠 적용 가능함 - Hook은 stdin JSON과 exit code뿐 아니라 stdout의 **이벤트별 JSON 필드**로 명령 수정, 권한 결정, 컨텍스트 주입, 파일 감시까지 수행함 - 문서에 없는 Hook 필드 **`once`**, `async`, `asyncRewake`로 1회 실행, 백그라운드 감사 로그, 비동기 보안 차단 흐름을 만들 수 있음 - Skills와 Agents는 **숨겨진 frontmatter**로 모델·effort·스코프 Hook·Agent 위임·지속 메모리·CLAUDE.md 생략·MCP 의존성을 제어함 - Auto Mode, 자동 메모리, Dream, Magic Docs, 권한 glob, `context: fork`는 Claude Code를 **학습형 개발 환경**에 가깝게 구성해 줌 --- ### 기준 버전과 파일 위치 - 내용은 `@anthropic-ai/claude-code@2.1.87` 기준이며, 문서화되지 않은 기능은 릴리스 사이에서 바뀔 수 있음 - 이름에 **`EXPERIMENTAL`** 이 들어간 필드는 Anthropic 엔지니어가 불안정하다고 표시한 것으로, 제거되거나 이름이 바뀔 수 있음 - 설정 파일 위치 - 개인 설정: `~/.claude/settings.json` - 프로젝트 설정: `.claude/settings.json` - Skills 위치 - 개인: `~/.claude/skills/<name>/SKILL.md` - 프로젝트: `.claude/skills/<name>/SKILL.md` - Agents 위치 - 개인: `~/.claude/agents/<name>.md` - 프로젝트: `.claude/agents/<name>.md` - Hook 스크립트는 `~/.claude/hooks/`에 두는 관례가 적합하며, 실행하려면 `chmod +x`가 필요함 - 프로젝트 수준의 `.claude/` 파일은 Git에 커밋해 팀과 공유할 수 있고, `~/.claude/` 아래 개인 파일은 사용자에게만 적용됨 ### Hook은 stdout JSON으로 Claude Code 동작을 바꿀 수 있음 - 공식 문서는 Hook이 stdin으로 JSON을 받고 exit code 2로 작업을 막는 흐름만 다루지만, 실제로는 stdout의 **이벤트별 JSON 필드**로 Claude Code 동작을 실시간 변경할 수 있음 - ## `PreToolUse`에서 반환 가능한 필드 - `updatedInput`: 도구 실행 전 입력을 다시 작성해 명령을 바꿀 수 있음 - `permissionDecision`: 사용자에게 묻지 않고 `allow` 또는 `deny`를 강제할 수 있음 - `permissionDecisionReason`: 결정 이유를 UI에 표시 가능함 - `additionalContext`: 대화 컨텍스트에 텍스트를 주입할 수 있음 - ## `SessionStart`에서 반환 가능한 필드 - `watchPaths`: 자동 파일 감시를 설정해 `FileChanged` 이벤트를 트리거할 수 있음 - `initialUserMessage`: 세션의 첫 사용자 메시지 앞에 내용을 덧붙일 수 있음 - `additionalContext`: 전체 세션 동안 유지되는 컨텍스트를 주입 가능함 - ## `PostToolUse`에서 반환 가능한 필드 - `updatedMCPToolOutput`: Claude가 보는 MCP 도구 응답을 수정할 수 있음 - `additionalContext`: 도구 실행 후 컨텍스트를 주입할 수 있음 - ## `PermissionRequest`에서 반환 가능한 필드 - `decision`: `updatedInput` 또는 `updatedPermissions`와 함께 프로그래밍 방식으로 허용하거나 거부할 수 있음 - ## `git push`를 자동으로 `--dry-run`으로 바꾸는 Hook - `PreToolUse` Hook에서 Bash 명령을 검사해 `git push`가 포함되면 **`updatedInput`** 으로 명령 끝에 `--dry-run`을 붙일 수 있음 - Claude는 `git push origin main`을 실행한다고 보지만, Hook이 실제 실행 전 `git push origin main --dry-run`으로 바꿈 ```json { "hooks": { "PreToolUse": [{ "matcher": "Bash", "hooks": [{ "type": "command", "command": "~/.claude/hooks/dry-run-pushes.sh" }] }] } } ``` ```bash #!/bin/bash INPUT=$(jq -r '.tool_input.command' < /dev/stdin) if echo "$INPUT" | grep -q 'git push'; then jq -n --arg cmd "$INPUT --dry-run" '{"updatedInput": {"command": $cmd}}' fi ``` - ## 세션 시작 시 파일 감시와 Git 컨텍스트를 주입하는 Hook - `SessionStart` Hook은 `package.json`, `.env`, `tsconfig.json`을 감시 대상으로 지정하고, 현재 브랜치와 커밋되지 않은 파일 수를 **세션 컨텍스트**로 넣을 수 있음 ```json { "hooks": { "SessionStart": [{ "hooks": [{ "type": "command", "command": "~/.claude/hooks/session-context.sh", "statusMessage": "Loading project context..." }] }] } } ``` ```bash #!/bin/bash BRANCH=$(git branch --show-current 2>/dev/null) CHANGES=$(git status --porcelain 2>/dev/null | wc -l | tr -d ' ') jq -n \ --arg branch "$BRANCH" \ --arg changes "$CHANGES" \ '{ "watchPaths": ["package.json", ".env", "tsconfig.json"], "additionalContext": "Current branch: \($branch). Uncommitted changes: \($changes) files." }' ``` - ## 읽기 전용 Bash 명령을 자동 승인하는 Hook - `ls`, `cat`, `echo`, `pwd`, `whoami`, `date`, `git status`, `git log`, `git diff` 같은 명령은 **`permissionDecision: "allow"`** 로 사용자 확인 없이 통과 가능함 ```json { "hooks": { "PreToolUse": [{ "matcher": "Bash", "hooks": [{ "type": "command", "command": "~/.claude/hooks/auto-approve-readonly.sh" }] }] } } ``` ```bash #!/bin/bash CMD=$(jq -r '.tool_input.command' < /dev/stdin) if echo "$CMD" | grep -qE '^(ls|cat|echo|pwd|whoami|date|git status|git log|git diff)'; then echo '{"permissionDecision": "allow", "permissionDecisionReason": "Safe read-only command"}' fi ``` ### 문서에 없는 Hook 설정 필드 3개 - 문서화된 Hook 필드는 `type`, `command`, `matcher`, `timeout`, `if`, `statusMessage`지만, 소스 코드 파서는 **`once`**, **`async`**, **`asyncRewake`** 도 받음 - ## `once: true` - Hook을 정확히 한 번만 실행한 뒤 자동 제거하므로 첫 세션 설정에 적합함 - `.env`가 없으면 `.env.example`을 복사하고 이후에는 다시 실행하지 않는 흐름을 만들 수 있음 ```json { "hooks": { "SessionStart": [{ "hooks": [{ "type": "command", "command": "[ -f .env ] || cp .env.example .env && echo 'Created .env from template'", "once": true, "statusMessage": "First-time setup..." }] }] } } ``` - ## `async: true` - Hook을 백그라운드에서 실행해 Claude의 진행을 막지 않음 - 모든 Bash 명령을 `~/.claude/audit.jsonl`에 기록하면서 세션 지연을 추가하지 않는 데 쓸 수 있음 ```json { "hooks": { "PostToolUse": [{ "matcher": "Bash", "hooks": [{ "type": "command", "command": "jq '{timestamp: now, command: .tool_input.command, session: .session_id}' < /dev/stdin >> ~/.claude/audit.jsonl", "async": true }] }] } } ``` - ## `asyncRewake: true` - 정상 경로에서는 `async`처럼 백그라운드로 실행하지만, exit code 2로 종료되면 모델을 다시 깨워 작업을 차단함 - Claude가 작성한 파일마다 하드코딩된 `password`, `secret`, `api_key` 패턴을 검사하고, 발견 시 차단 가능함 ```json { "hooks": { "PostToolUse": [{ "matcher": "Write|Edit", "hooks": [{ "type": "command", "command": "~/.claude/hooks/scan-secrets.sh", "asyncRewake": true, "statusMessage": "Scanning for secrets..." }] }] } } ``` ```bash #!/bin/bash FILE=$(jq -r '.tool_input.file_path // .tool_response.filePath' < /dev/stdin) if grep -qE '(password|secret|api_key)\s*=' "$FILE" 2>/dev/null; then exit 2 fi exit 0 ``` ### Skill frontmatter의 숨겨진 필드 - 문서에는 `name`, `description`, `allowed-tools`, `argument-hint`, `when_to_use`, `context`가 다뤄지지만, 실제 파서는 추가 필드 6가지를 받음 - ## `model` - Skill 실행 모델을 바꿀 수 있으며, 빠르고 저렴한 작업에는 `haiku`, 복잡한 분석에는 `opus`를 쓸 수 있음 ```markdown --- name: quick-lint description: Fast lint check using the cheapest model model: haiku effort: low allowed-tools: Bash, Read argument-hint: "[file]" --- Run the project linter on: $ARGUMENTS Detect the linter from config (eslint, ruff, clippy) and run it. Report only errors, not warnings. ``` - ## `effort` - 모델이 얼마나 깊게 생각할지를 조절하며, 값은 `low`, `medium`, `high`, `max`임 - 내부적으로 응답별 추론 깊이를 제어하는 effort 시스템에 매핑됨 - ## `hooks` - Skill이 활성화될 때만 등록되고 완료되면 해제되는 **스코프 지정 Hook**을 정의할 수 있음 - TypeScript 파일을 쓸 때마다 동기적으로 타입 체크하고, 백그라운드에서 lint를 실행하는 식으로 쓸 수 있음 ```markdown --- name: strict-typescript description: Write TypeScript with type checking on every save allowed-tools: Bash, Read, Write, Edit, Grep, Glob hooks: PostToolUse: - matcher: "Write|Edit" hooks: - type: command command: "~/.claude/hooks/typecheck-on-save.sh" statusMessage: "Type checking..." - type: command command: "~/.claude/hooks/lint-on-save.sh" async: true --- Write TypeScript with strict enforcement. Every file you touch gets type-checked and linted automatically. $ARGUMENTS ``` - ## `agent` - Skill 실행을 사용자 정의 Agent에 위임할 수 있음 ```markdown --- name: deep-review description: Thorough security review delegated to the review agent agent: security-review --- Review the following: $ARGUMENTS ``` - ## `disable-model-invocation: true` - 자동 호출을 막고 명시적인 `/skill-name` 호출로만 실행되게 하므로, 파괴적 Skill에 적합함 - ## `shell: bash` - 실행에 사용할 셸을 지정함 ### Agent frontmatter의 숨겨진 필드 - `.claude/agents/`의 사용자 정의 Agent도 문서에 없는 frontmatter 필드를 지원함 - ## `color` - UI 색상을 `red`, `orange`, `yellow`, `green`, `blue`, `purple`, `pink`, `gray` 중 하나로 설정할 수 있음 - 여러 Agent가 실행될 때 시각적으로 구분하는 데 도움이 됨 - ## `memory` - Agent에 호출 간 **지속 메모리**를 부여함 - `user`: 모든 프로젝트에 걸쳐 전역으로 유지됨 - `project`: 프로젝트별로 유지됨 - `local`: Git에서 제외되는 비공개 프로젝트별 메모리임 - 보안 리뷰어는 과거 발견 사항을 추적할 수 있고, 코드 리뷰어는 세션을 넘어 사용자의 패턴을 기억할 수 있음 ```markdown --- name: codebase-guide description: Answer questions about the codebase, learning more with each session tools: [Read, Grep, Glob, Bash] color: green memory: project --- You are a codebase guide with persistent memory. Check your memory first before exploring the code. ``` - ## `omitClaudeMd: true` - `CLAUDE.md` 지시 계층 로딩을 건너뛰며, 프로젝트 관습 대신 업계 기준으로 보는 “fresh eyes” 리뷰어에 적합함 ```markdown --- name: fresh-eyes description: Review code without project-specific biases tools: [Read, Grep, Glob] omitClaudeMd: true effort: high color: blue --- Review this code purely from first principles. You have no project context. Focus on correctness, security, performance, and readability by industry standards. ``` - ## `criticalSystemReminder_EXPERIMENTAL` - 짧은 메시지를 매 턴마다 시스템 리마인더로 다시 주입하며, 대화 압축 이후에도 컨텍스트에 남음 - 필드 이름 자체에 **`EXPERIMENTAL`** 이 포함되어 있어 불안정하며, 핵심 인프라가 아니라 보조 안전 리마인더 용도로만 쓰는 편이 적합함 ```markdown --- name: prod-deployer description: Manages production deployments with strict safety checks tools: [Bash, Read, Grep] color: red criticalSystemReminder_EXPERIMENTAL: "Always run migrations with --dry-run first. Never skip the staging verification step." --- ``` - ## `requiredMcpServers` - 필요한 MCP 서버 이름 패턴을 나열하며, 해당 서버가 없으면 Agent가 나타나지 않음 - 의존성이 준비되지 않은 Agent가 로드되는 일을 막을 수 있음 ### Auto Mode 분류기는 자연어 환경 설명을 받음 - `settings.json`의 **`autoMode`** 필드는 Anthropic 내부에서 “YOLO Classifier”라고 부르는 자동 승인 분류기를 설정함 - `allow` 패턴은 자동 승인되고, `soft_deny` 패턴은 항상 확인을 요구함 - `environment` 배열은 패턴이 아니라 분류기가 읽는 **자연어 컨텍스트**이며, 프로젝트 환경을 설명해 애매한 명령의 안전성 판단에 반영할 수 있음 ```json { "autoMode": { "allow": [ "Bash(npm test)", "Bash(npm run *)", "Bash(git status)", "Bash(git diff *)", "Bash(git log *)", "Read", "Grep", "Glob" ], "soft_deny": [ "Bash(git push *)", "Bash(rm *)", "Write(.env*)" ], "environment": [ "NODE_ENV=development", "This is a local dev machine with no production database access", "All Docker containers use isolated networks", "The test suite is safe to run repeatedly, it uses a dedicated test database" ] } } ``` - `This project uses Docker, all commands run in containers` 같은 문장은 분류기가 환경을 이해하는 데 쓰임 - `No production access`는 파괴적 작업에 덜 보수적으로 대응하게 하고, `Test database is isolated`는 테스트 실행이 항상 안전하다는 신호로 작동함 ### 자동 메모리와 Dream 통합 루프 - `settings.json`에서 **`autoMemoryEnabled`** 와 **`autoDreamEnabled`** 를 켜면 Claude Code의 자기개선 시스템이 활성화됨 ```json { "autoMemoryEnabled": true, "autoDreamEnabled": true } ``` - ## `autoMemoryEnabled` - 각 대화 후 백그라운드 Agent가 세션에서 오래 유지할 가치가 있는 정보를 추출함 - 사용자 선호, 코드베이스 패턴, 결정 사항을 표준 memory frontmatter 형식으로 `~/.claude/projects/<path>/memory/`에 기록함 - ## `autoDreamEnabled` - 24시간마다, 누적 세션이 5개 이상이면 백그라운드 Agent가 과거 세션 transcript를 검토해 메모리를 통합함 - 중복 병합, 모순 해결, 상대 날짜의 절대 날짜 변환, 오래된 항목 제거를 수행함 - 두 설정을 함께 켜면 세션이 메모리를 만들고, Dream이 메모리를 통합하며, 통합된 메모리가 이후 세션에 반영되는 **학습 루프**가 만들어짐 - 몇 주 후에는 모델 재학습 없이 Claude Code가 사용자 선호, 관습, 공통 패턴을 기억하는 효과가 나타날 수 있음 ### Magic Docs 형식 - Magic Docs는 정규식 **`/^#\s*MAGIC\s+DOC:\s*(.+)$/im`** 으로 감지됨 - 반드시 H1 제목이어야 하고, 대소문자를 구분하지 않음 - 다음 줄에는 `_underscores_` 또는 `*asterisks*`로 감싼 이탤릭 지시문을 둘 수 있으며, 업데이트 Agent가 집중할 범위를 제한함 ```markdown # MAGIC DOC: API Endpoint Reference _Only document public REST endpoints. Include method, path, request body, response schema, and auth requirements._ ## Endpoints (content auto-maintained by Claude Code) ``` - 지시문이 없으면 Agent는 모든 내용을 업데이트하려고 함 - 지시문이 있으면 `only track public endpoints`나 `focus on breaking changes` 같은 범위를 따름 - 업데이트 Agent는 백그라운드에서 실행되며, 해당 파일 하나만 편집하도록 제한됨 - 헤더를 삭제하면 추적이 자동으로 중단됨 ### 전체 권한 규칙 문법 - 문서에는 `Bash(git *)` 같은 기본 예시가 있지만, 실제 패턴 언어는 Bash, 파일 경로, MCP 도구를 폭넓게 다룸 ```text Bash(npm *) # wildcard after "npm " Bash(git commit *) # specific subcommand Read(*.ts) # file extension Read(src/**/*.ts) # recursive directory with extension Write(src/**) # recursive, all files mcp__slack # all tools on slack server mcp__slack__* # explicit wildcard (same effect) mcp__slack__post_message # specific tool Bash(npm:*) # legacy colon prefix (word boundary) ``` - `*`는 셸 glob처럼 경계 안에서 매칭되고, `**`는 디렉터리를 재귀적으로 매칭함 - MCP 도구 권한은 **이중 밑줄** 형식인 `mcp__<server>__<tool>`을 사용함 - Hook의 `if` 필드도 같은 문법을 사용하며, 정규식이 아니라 glob임 ```json { "permissions": { "allow": [ "Bash(npm *)", "Bash(git status)", "Bash(git diff *)", "Read(src/**)", "Read(tests/**)", "Grep", "Glob", "mcp__database__query" ], "deny": [ "Bash(rm -rf *)", "Write(/etc/**)", "Write(.env*)", "mcp__slack__delete_*" ], "ask": [ "Bash(git push *)", "Write(*.json)", "Write(*.lock)", "mcp__slack__post_message" ] } } ``` ### `context: fork`와 모델 선택의 캐시 영향 - Skill에 **`context: fork`** 를 설정하면 백그라운드 forked subagent로 실행됨 - Fork는 `CacheSafeParams`라는 typed contract를 통해 부모의 prompt cache를 공유하며, 캐시 적중률을 높이기 위해 byte-identical API request prefix를 생성함 - Forked Skill에 다른 모델을 지정하면 prefix가 달라져 캐시가 깨질 수 있음 - 부모 대화가 Opus이고 fork가 Haiku이면 prefix가 달라져 cache miss가 발생하고 전체 비용을 내게 됨 - Forked Skill에서는 `model` 필드를 생략하거나 **`model: inherit`** 을 사용해야 캐시가 유지됨 - `context: fork`는 보안 스캔, 의존성 분석, 문서 생성, 테스트 스위트 실행 같은 무거운 작업에 적합하며, 메인 대화는 반응성을 유지함 ```markdown --- name: full-audit description: Comprehensive codebase audit running in the background context: fork allowed-tools: Bash, Read, Grep, Glob, WebSearch effort: high --- Run a comprehensive audit: - Security scan (grep for dangerous patterns, check dependencies for CVEs) - Code quality (duplicated logic, dead code, missing error handling) - Test coverage (untested critical paths) - Dependency health (outdated packages, unused deps, license issues) Write a detailed report to /tmp/audit-report.md when complete. ``` ### 기능 조합 예시 - ## 지속 메모리와 스코프 Hook을 가진 코드 리뷰어 - Agent가 코드베이스별 메모리를 읽고, 과거 발견 패턴과 새 문제를 함께 리뷰하며, 이후 발견 사항을 다시 메모리에 저장함 - 여러 리뷰를 거치면 일반 리뷰어가 놓칠 수 있는 프로젝트별 반복 문제를 잡는 데 도움이 됨 ```markdown --- name: reviewer description: Code reviewer that learns your codebase patterns over time tools: [Read, Grep, Glob, Bash] effort: high color: yellow memory: project hooks: PostToolUse: - matcher: "Bash" hooks: - type: command command: "~/.claude/hooks/log-review.sh" async: true --- Before reviewing, read your memory for past findings on this codebase. Review git diff HEAD~1 for: - Patterns you've flagged before (check memory) - New issues worth flagging - Resolved issues from past reviews After review, save to memory: - New patterns found (type: feedback) - Recurring issues (type: project) End with VERDICT: PASS, FAIL, or NEEDS_REVIEW. ``` - ## 파일 감시와 `asyncRewake` 안전망을 결합한 세션 설정 - 세션 시작 시 프로젝트 컨텍스트를 로드하고, 읽기 전용 Bash 명령은 즉시 자동 승인하며, 위험한 명령은 비동기 안전 검사로 차단함 - 읽기 전용 명령은 빠르게 통과하고, 위험 명령은 막히며, 나머지는 일반 권한 흐름을 따름 ```json { "hooks": { "SessionStart": [{ "hooks": [{ "type": "command", "command": "~/.claude/hooks/session-context.sh", "statusMessage": "Loading project context..." }] }], "PreToolUse": [{ "matcher": "Bash", "hooks": [{ "type": "command", "command": "~/.claude/hooks/auto-approve-readonly.sh" }, { "type": "command", "command": "~/.claude/hooks/block-dangerous.sh", "asyncRewake": true, "statusMessage": "Safety check..." }] }] } } ``` ```bash #!/bin/bash CMD=$(jq -r '.tool_input.command' < /dev/stdin) echo "$CMD" | grep -qE '(rm -rf /|sudo rm|chmod 777|> /dev/)' && exit 2 || exit 0 ``` - ## 모델 override, effort 제어, Agent 위임을 조합한 아키텍처 리뷰 - `effort: max`로 깊은 분석을 지정하고, 특정 Agent에 위임하며, 해당 Agent의 `omitClaudeMd: true`로 기존 프로젝트 관습의 영향을 줄임 ```markdown --- name: architecture-review description: Deep architecture review using max effort, delegated to fresh-eyes agent agent: fresh-eyes effort: max --- Review the architecture of this project. Ignore existing conventions (the agent has omitClaudeMd: true). Focus on: $ARGUMENTS Evaluate structural decisions, dependency graph health, separation of concerns, and scalability characteristics. ``` ### 의미와 한계 - 이벤트별 응답 필드를 가진 Hook 시스템은 AI 도구 사용을 위한 **프로그래밍 가능한 미들웨어 계층**으로 작동함 - 지속 Agent 메모리는 세션을 넘어 경험을 축적하는 AI 전문가를 만들 수 있게 함 - Dream 통합 시스템은 모델 재학습 없이 세션 경험에서 학습하는 구조를 제공함 - Auto Mode 분류기는 자연어 환경 설명을 받아 안전 판단에 반영함 - 이 기능들은 숨겨진 설정이나 이스터에그라기보다 지속적이고 학습하며 자율적인 AI 개발 환경을 위한 기반 기능으로, 현재 npm 패키지에 이미 들어 있음 ## Comments ### Comment 58636 - Author: neo - Created: 2026-05-31T08:42:32+09:00 - Points: 1 ###### [Hacker News 의견들](https://news.ycombinator.com/item?id=48318174) - Pangram으로 확인해 보니 **명백히 AI가 생성한 글**로 보임 이렇게 추천을 많이 받은 게 놀랍고, 사람들이 글을 읽긴 한 건지 의문임. @dang이 댓글에는 AI 생성 콘텐츠 규칙을 만들었지만 글에는 아직 꺼려 온 걸 알고 있음. 개인적으로는 이런 저품질 글에 시간을 낭비하지 않도록 기사에도 **신고 플래그**가 있으면 좋겠음 - 이 내용은 전부 문서화돼 있음 [1]. `Once`도 문서화돼 있고 [2], `async`와 `asyncRewake`도 문서화돼 있음 [3]. Skills의 frontmatter도 완전히 문서화돼 있고 [4], Automode 환경 문자열도 문서에 있음 [5] 이 글은 순수한 **AI 작성 클릭베이트**라서 여기서 이렇게 반응이 좋은 게 놀라움 [1] [https://code.claude.com/docs/en/hooks#pretooluse-decision-co...]() [2] [https://code.claude.com/docs/en/hooks#common-fields]() [3] [https://code.claude.com/docs/en/hooks#command-hook-fields]() [4] [https://code.claude.com/docs/en/skills#frontmatter-reference]() [5] [https://code.claude.com/docs/en/auto-mode-config#define-trus...]() - 이 글은 **2개월 전 글**이라 일부는 오래됐고, 몇몇 기능은 이미 문서화됨 예를 들어 auto mode 문서는 여기 있음: [https://code.claude.com/docs/en/auto-mode-config#define-trus...]() - `claude` 패키지는 매주 새 버전이 10개씩 나오고, 몇 달마다 새 모델도 나오니 그 주변의 **문서화되지 않은 꼼수**에 의존하면 안 됨 바뀌고, 깨지고, 지나치게 세부적인 설정을 망가뜨릴 가능성이 큼 - 내 경험상 **문서화되지 않은 꼼수**는 문서화된 기능만큼 자주 깨짐 1M Opus를 내놓은 뒤 “컨텍스트 창은 더 이상 문제가 아니다”라며 “clear context and execute plan” 옵션을 제거했던 것처럼 - 새 버전이 나올 때마다 저수준 사용자 설정을 효율적으로 처리하는 **자동화**를 만들 수는 있음 - 맞는 말이지만, **일시적 해킹**이 최첨단 워크플로를 살리거나 망칠 때도 있음 매 릴리스마다 Claude 지침을 다시 설계하진 않지만, 어떤 릴리스는 기존 지침이 현재 모델에 맞는지 점검할 만하고 실제로 눈에 띄는 차이를 만들었음 - Claude Code의 **기능 수**는 숨이 막힐 정도임. 이 속도면 다음 교황은 Anthropic 출신일 듯 - 농담은 제쳐두고, Anthropic이 쏟아내는 것들이 너무 많아서 신뢰하기 어려움 이런 방식으로는 충분히 숙고되고 안정적인 제품이 되기 힘들어 보임 - “Honest status”라며 100%가 아니고 왜 더 긴 길인지 솔직히 말하겠다는 식으로 나오는데, [https://github.com/user-attachments/assets/961eff6c-0060-45d...]() 그냥 Claude Code가 작업 달성을 포기하지 않았으면 좋겠음. 너무 짜증남. `/goal`이나 새 `ultracode`를 써도 계속 포기함. 내 프로젝트가 꽤 복잡하긴 하지만 ([https://github.com/mohsen1/tsz]()), Codex는 그렇게 멈추지 않고 계속 밀어붙이는 데 문제가 없음 - 이제는 `/loop`를 써서 계속 가라고 동기부여하는 프롬프트를 넣음 Goal도 쓸 수 있지만, 어떤 작업에는 단순한 **루프**가 더 나음 - 나도 방금 Claude에게 작업 목록을 채우게 했더니, 목록 끝까지 가기 전에 계속할지 아니면 일부만 한 것으로 충분한지 물어봄 - LLM 모델 전반에 어느 정도 보편적인 **AI 코딩 에이전트 애플리케이션 구조**가 생겨나고 있는지 궁금함 이런 아키텍처 스타일을 이해하는 방법을 모으고 정리하는 사람이 있는지도 궁금함 - 같은 사이트에 있는 거 맞나? 요즘 그거 말고 다른 걸 쓰는 사람이 있나? - Claude Code, Codex, Cursor 전반의 패턴은 수렴하는 듯함: **컨텍스트 수집**, 계획 수립, 실행, 검증 덜 표준화된 부분은 각 단계 사이에서 사용자에게 얼마나 많은 제어권을 주느냐임. `showClearContextOnPlanAccept`나 `disableAutoMode` 같은 설정은 “에이전트가 결정”과 “사람이 실행 전에 검토” 사이의 경계를 드러내서 흥미로움. 실제 사용감에서 코딩 에이전트들이 계속 크게 달라질 부분도 그 지점으로 보임 - “magic doc” 기능이 궁금함. 이건 **CLAUDE.md**에 넣는 건지, 프로젝트 파일에 넣는 건지 모르겠음 세션 중에 그 파일을 언급해야 하는지, 아니면 Claude가 프로젝트 안에서 “magic doc” 헤더가 들어간 모든 곳을 자동으로 찾는지도 궁금함 - Claude에게 자기 설정을 직접 만들라고 할 수 있을까? “네가 나라고 생각하고, 네가 원하는 최적의 설정 파일 묶음을 만들어라” 같은 식으로 - 문서에 따르면 `CLAUDE_CODE_NEW_INIT`을 1로 설정하면 `/init`이 **대화형 설정 흐름**으로 실행됨 이 흐름은 코드베이스를 탐색하고 파일을 작성하기 전에 `CLAUDE.md`, skills, hooks 등 어떤 파일을 생성할지 물어봄. 이 변수가 없으면 `/init`은 묻지 않고 `CLAUDE.md`를 자동 생성함 - 아마 가능할 것 같음. 자체 문서를 탐색하는 내장 도구가 있어 보이고, `.claude/` 디렉터리에서 작업하는 특수 모드도 있음 사용자가 그렇게 하도록 의도된 듯함 - 베스트 프랙티스가 담긴 보일러플레이트 파일을 모두 갖춘 **cookie cutter 프로젝트**가 있으면 좋겠음 - 대화 기록을 훑어서 허용 권한을 추가해 주는 **슬래시 명령**이 있음 - 가능함. Claude는 자기 자신을 수정하는 데 꽤 능숙함 - 의존하던 **문서화되지 않은 기능**이 갑자기 멈추는 걸 발견하는 재미를 누리게 될 것임 - Anthropic 주장처럼 소프트웨어 엔지니어링이 정말 해결된 문제라면, 누구든 그냥 바이브코딩으로 다시 만들 수 있어야 함 “open”이라는 단어에 알레르기만 없었다면 Claude Code를 오픈소스로 공개했을 텐데, 지금 시점에서는 공개하지 않을 실질적인 이유가 없음