Claude Code 상세 사용법 61: 설정과 메모리 디버깅 루프 | DAKER 커뮤니티

Claude Code 상세 사용법 61: 설정과 메모리 디버깅 루프

Claude Code가 “분명히 적어 둔 규칙”을 따르지 않을 때는 프롬프트를 더 세게 쓰기 전에 실제로 무엇이 로드됐는지 봐야 합니다. 공식 debug configuration 문서 기준 핵심 명령은 /context, /memory, /doctor, /hooks, /mcp, /permissions, /status입니다.

Mermaid 흐름으로 보는 확인 순서

아래 Mermaid source처럼 전체 로드 상태를 본 뒤 표면별로 좁힙니다.

Mermaid source:
flowchart TD
  A[문제 재현] --> B[/context]
  B --> C[/memory]
  B --> D[/doctor]
  B --> E[/hooks 또는 /mcp]
  C --> F{지침이 로드됐나}
  F --> G[위치와 충돌 수정]
  F --> H[문장 구체화]

먼저 /context를 본다

/context는 현재 세션의 context window에 들어온 항목을 범주별로 보여 줍니다. CLAUDE.md, rules, skills, MCP tools, 대화 메시지가 실제로 있는지 먼저 확인하세요.

/context
/memory
/skills
/agents

/memory에 하위 디렉토리 CLAUDE.md가 안 보인다고 바로 버그로 보면 안 됩니다. 공식 문서는 하위 디렉토리 CLAUDE.md가 세션 시작 때가 아니라 해당 디렉토리 파일을 읽을 때 로드된다고 설명합니다.

지침과 강제 경계를 나눈다

CLAUDE.md와 auto memory는 Claude에게 맥락을 주는 장치입니다. 보안 경계나 “절대 실행 금지” 같은 강제 정책은 permissions나 hook으로 옮겨야 합니다.

{
  "permissions": {
    "deny": ["Bash(rm -rf:*)"]

  }
}

반대로 코딩 스타일, 테스트 명령, 폴더 구조, PR 작성 방식은 CLAUDE.md에 둡니다. 개인 예외는 settings.local.json이나 CLAUDE.local.md처럼 git에 넣지 않는 파일로 분리합니다.

훅과 MCP는 상태 명령으로 본다

훅이 안 돈다면 /hooks에서 이벤트와 matcher를 봅니다. matcher는 배열이 아니라 문자열이고, 여러 도구는 Edit|Write처럼 |로 묶습니다. 대소문자도 맞아야 합니다.

/hooks
claude --debug hooks

MCP 서버가 안 보이면 /mcp에서 연결, 승인, 도구 개수를 확인합니다. project .mcp.json은 저장소 루트에 있어야 하고, 처음 clone한 사용자는 승인해야 합니다.

/mcp
claude --debug mcp

깨끗한 세션으로 분리한다

원인을 못 찾으면 --safe-mode로 사용자 정의를 끄고 재현합니다. 그래도 남으면 임시 설정 디렉토리로 더 좁힙니다.

cd /tmp && CLAUDE_CONFIG_DIR=/tmp/claude-clean claude

macOS는 Keychain 때문에 인증이 유지될 수 있지만, Linux와 Windows는 다시 로그인해야 할 수 있습니다. 이 차이를 팀 문서에 적어 두면 온보딩 실패가 줄어듭니다.

선임 엔지니어 takeaways

클로드 코드 설정 디버깅은 감이 아니라 증거 수집입니다. 먼저 /context로 로드 여부를 보고, /memory로 지침 범위를 확인하고, /doctor로 schema를 검증하고, /hooks와 /mcp로 자동화 표면을 분리하세요. 이렇게 해야 Claude Code 기반 AI 코딩, MCP, CLI 자동화, 테스트 자동화가 “왜 안 듣지?”가 아니라 운영 가능한 agentic coding 루프가 됩니다.

참고: Anthropic Claude Code debug configuration, .claude directory, memory, llms.txt 문서를 2026-06-15 Asia/Seoul 기준으로 확인했습니다.