Claude Code의 모델은 수정을 통해 학습하지 않지만, CLAUDE.md, hooks, 그리고 skills가 설정을 누적시켜 향후 세션을 더 스마트하게 만듭니다. 실질적인 이득을 보려면 설정(configuration)에 투자하세요.

핵심 요약 (Key Takeaways)

• Claude Code의 모델은 수정을 통해 학습하지 않지만, CLAUDE.md, hooks, 그리고 skills가 설정을 누적시켜 향후 세션을 더 스마트하게 만듭니다.
• 실질적인 이득을 보려면 설정(configuration)에 투자하세요.

모든 새로운 Claude Code 사용자를 괴롭히는 질문

당신은 Codex를 사용하다가 Claude Code를 사용한 지 이틀째입니다. 당신은 최대 요금제(max plan)를 사용 중이지만 좌절감을 느끼고 있습니다. 이미 MCP 접근 권한이 있음에도 불구하고 웹사이트에서 수동으로 작업을 수행하라고 요청합니다. Xcode 빌드에서는 실패합니다. 매번 근본적인 원인을 수정하라고 말하지만, 당신은 궁금해합니다: 이 도구가 실제로 좋아지는 것일까, 아니면 한계는 단지 당신이 환경을 얼마나 잘 설정하느냐에 달려 있는 것일까?

이것은 진지한 모든 Claude Code 사용자가 직면하는 질문입니다. 그 답은 당신을 놀라게 할 수도 있으며, 이 도구의 진정한 힘을 잠금 해제하는 열쇠가 될 것입니다.

냉혹한 진실: 모델은 당신으로부터 학습하지 않는다

먼저 이 점을 분명히 합시다: Claude Code의 기반 모델(Claude Opus 4.6과 같은)은 당신의 수정을 통해 학습하지 않습니다. 각 세션은 새로 시작됩니다. "지난번에 증상이 아니라 근본 원인을 수정하라고 말했잖아"와 같은 지속적인 메모리는 없습니다. 만약 당신이 동일한 문제를 반복해서 수정하고 있다면, 당신은 시스템과 싸우고 있는 것입니다.

하지만 좋은 소식이 있습니다: 당신의 설정(setup)은 개선됩니다. 모델은 정적이지만, 당신의 환경—CLAUDE.md, hooks, 그리고 skills—은 당신이 제어할 수 있는 동적인 시스템입니다. Claude Code를 수정할 때마다, 당신은 그 수정을 당신의 설정(configuration)에 인코딩할 기회를 갖게 됩니다. 바로 그 지점에서 복리 효과(compounding)가 발생합니다.

실제로 개선되는 것: 당신의 설정 (Your Setup)

CLAUDE.md: 당신의 지속적인 메모리 (Persistent Memory)

CLAUDE.md는 프로젝트의 메모리입니다. 이는 Claude Code가 매 세션 시작 시 읽는 파일로, 프로젝트의 컨벤션 (Conventions), 아키텍처 (Architecture), 그리고 선호 사항 (Preferences)에 대한 지속적인 컨텍스트 (Context)를 제공합니다. 이곳에 다음과 같은 내용을 문서화합니다:

• 프로젝트 구조 (Project structure): 중요한 파일이 어디에 있는지, 빌드 (Build)가 어떻게 작동하는지.
• 흔한 실수 (Common pitfalls): "pod install을 먼저 실행하지 않으면 Xcode 빌드가 실패합니다."
• 당신의 선호 사항 (Your preferences): "항상 증상이 아닌 근본 원인을 해결하세요."
• 워크플로우 규칙 (Workflow rules): "웹사이트 상호작용에는 MCP 도구를 사용하고, 저에게 수동으로 해달라고 요청하지 마세요."

CLAUDE.md 스니펫 (Snippet) 예시:

# Project: MyApp

## Build
...

Claude Code를 교정할 때마다, 그 교정 내용을 CLAUDE.md에 추가하세요. 몇 주가 지나면 이 파일은 모든 세션을 더 똑똑하게 만드는 강력한 지식 베이스 (Knowledge base)가 됩니다.

Hooks: 교정 자동화하기

훅 (Hooks)은 Claude Code의 라이프사이클 (Lifecycle) 중 특정 시점(도구 호출 전/후, 파일 편집 전/후 등)에 실행되는 스크립트입니다. 이를 통해 규칙을 자동으로 강제할 수 있습니다. 예를 들어, Claude Code가 계속해서 같은 실수를 반복한다면, 이를 잡아내는 훅을 작성할 수 있습니다.

훅 (Hook) 예시 (pre-tool-call):

#!/bin/bash
# Claude가 수동 단계가 필요한 명령을 실행하려 하는지 확인
if [[ "$CLAUDE_TOOL" == "Bash" ]] && [[ "$CLAUDE_INPUT" == *"xcodebuild"* ]]; then
...

훅은 당신의 안전망입니다. 오류가 발생하기 전에 이를 잡아내어 시간과 좌절감을 줄여줍니다.

Skills: 재사용 가능한 지침 팩

스킬 (Skills, 2026년 7월 도입)은 ~/.claude/skills/에 저장되는 재사용 가능한 지침 팩 (Instruction packs)입니다. 복잡한 워크플로우를 한 번 정의해 두고 어디에서나 호출할 수 있습니다. 예를 들어, 빌드가 실패할 때마다 Claude Code가 사용하는 "Xcode 빌드 수정" 스킬을 만들 수 있습니다.

스킬 (Skill) 구조 예시:

~/.claude/skills/xcode-fix/
  SKILL.md  # Xcode 빌드 진단 및 수정을 위한 지침
  scripts/  # 헬퍼 스크립트 (Helper scripts)

스킬은 Claude Code를 위한 매크로 (Macros)와 같습니다. 당신이 어렵게 얻은 지식을 즉각적이고 반복 가능한 동작으로 바꿔줍니다.

이것이 중요한 이유: 토큰 경제학 (Token Economics)

당신이 수행하는 모든 수정 작업은 당신과 Claude 모두의 토큰을 소모합니다. 수정 사항을 당신의 설정(setup)에 인코딩(encoding)함으로써, 필요한 수정 횟수를 줄일 수 있습니다. 이는 다음과 같은 의미를 갖습니다:

• 더 빠른 세션 (Faster sessions): Claude Code가 실수를 반복하지 않습니다.
• 더 낮은 토큰 사용량 (Lower token usage): 주고받는 대화는 줄어들고, 실제 작업량은 늘어납니다.
• 더 나은 결과 (Better results): 모델이 시행착오(trial-and-error)가 아닌 전체 문맥(full context)을 바탕으로 작동합니다.

실제 답변: 모델이 아니라 당신의 설정입니다

그렇다면, Claude Code를 더 많이 사용할수록 성능이 좋아질까요? 네, 하지만 당신이 설정을 적극적으로 개선할 때만 그렇습니다. 모델은 상수(constant)이며, 당신의 CLAUDE.md, 훅 (hooks), 그리고 스킬 (skills)이 당신이 제어할 수 있는 변수 (variables)입니다.

프로젝트의 특이 사항들을 CLAUDE.md에 기록하는 데 이틀을 투자하는 개발자는 극적인 개선을 경험할 것입니다. 반면, 설정을 업데이트하지 않고 단순히 모델의 오류를 수정하기만 하는 개발자는 똑같은 실수가 영원히 반복되는 것을 보게 될 것입니다.

지금 바로 시도해보세요

1. CLAUDE.md를 생성하거나 업데이트하세요: 지금까지 수정했던 모든 내용을 포함하세요.
2. 훅 (hook)을 추가하세요: 가장 빈번하게 발생하는 오류(예: Xcode 빌드 관련)를 위한 훅을 만드세요.
3. 스킬 (skill)을 생성하세요: Claude Code에게 가르친 반복적인 워크플로 (workflow)를 위한 스킬을 만드세요.
4. 다음에 Claude Code를 수정할 때 스스로에게 물어보세요: "이것을 어떻게 인코딩해야 다시는 이런 일이 발생하지 않을까?"

미래의 당신(그리고 미래의 세션들)이 당신에게 고마워할 것입니다.

출처: reddit.com

원문 게시지: gentic.news