본문 바로가기

claude.md5

Claude Code 훅으로 부재 단정 막기: 지침이 닿지 못하는 곳 코딩 에이전트의 "없습니다" 단정을 Claude Code 훅으로 막아본 경험. CLAUDE.md 지침의 한계와 훅의 강제력, 그리고 매칭 기반 훅의 오탐·미탐 한계까지 실무자 관점에서 정리합니다. 왜 이걸 다루는가지침과 훅, 두 가지 통제 수단훅으로 어디까지 강제할 수 있나매칭 기반 훅의 본질적 한계다음 단계로 생각 중인 것: 2차 LLM 게이트마무리왜 이걸 다루는가코딩 에이전트를 실무에 쓰다 보면 "없습니다", "찾을 수 없습니다", "관련 코드가 없습니다" 같은 단정을 자주 보게 됩니다. 문제는 이게 진짜 없어서 그런 게 아니라, 에이전트가 충분히 찾지 않고 결론을 내릴 때가 많다는 점입니다. 최근 직접 겪은 케이스입니다. PR을 작성하던 중 에이전트가 src/lib에 splitName, buildF.. 2026. 5. 11.
Claude Code 실사용자가 본 Codex와의 차이 Claude Code와 OpenAI Codex를 토큰 비용, 코딩 벤치마크, ChatGPT vs Claude 앱까지 3가지 축으로 비교합니다. 순환 루프, Sycophancy 등 실사용 한계까지 정리합니다.📑 목차들어가며 - 왜 이 비교가 필요한가?Claude Code와 Codex, 한눈에 보기토큰 및 비용 측면 비교코딩 실력 비교 - 벤치마크와 실전ChatGPT vs Claude 앱 자체 비교실사용에서 느낀 Claude Code의 한계결론 - 벤치마크보다 중요한 것참고 자료들어가며 - 왜 이 비교가 필요한가?2026년 현재, AI 코딩 에이전트 시장은 Anthropic의 Claude Code와 OpenAI의 Codex가 양대 축을 이루고 있습니다. 저는 Claude Code를 주력으로 사용한 지 꽤 .. 2026. 3. 18.
Claude Code CLAUDE.md: 팀 지침을 위한 계층 구조와 스킬 분리 실전 적용기 Claude Code의 CLAUDE.md를 팀에서 운영하다 보면, ~/.claude에 공통 지침을 넣는 방식의 한계를 느끼게 됩니다. 개인 설정과 섞이고, 무관한 프로젝트에서도 로드되고, 팀 동기화도 안 됩니다. 이 글에서는 공통 지침을 워크스페이스 저장소로 이동하고, 계층형 구조와 플러그인(커맨드·스킬·에이전트)으로 팀 규칙을 체계적으로 관리한 경험을 정리합니다. 💡 한 줄 요약: ~/.claude는 개인 영역으로 남기고, 팀 지침은 Git으로 관리되는 워크스페이스 저장소에 계층형으로 배치하면 됩니다.📑 목차들어가며1. ~/.claude에 팀 공통 지침을 두면 생기는 일2. 해결: 공통 지침을 워크스페이스 저장소로 이동3. 계층으로 정리4. 플러그인: 지침으로 다루기 어려운 것들5. 서브에이전트 동.. 2026. 3. 11.
Claude Code 회사/개인 환경 분리하기 - CLAUDE_CONFIG_DIR부터 WSL까지 Claude Code 설정을 회사용과 개인용으로 나누고 싶다면? symlink, CLAUDE_CONFIG_DIR, WSL 분리까지 직접 시도해본 결과와 현실적인 방법을 정리합니다.들어가며저는 회사에서 Claude Code를 꽤 적극적으로 쓰고 있습니다. ~/.claude/CLAUDE.md에는 회사 DB 구조와 도메인 컨텍스트가 빼곡하고, ~/.claude/commands/에는 업무용 슬래시 커맨드가, ~/.claude/agents/에는 도메인 전문 에이전트가 설정되어 있습니다. 문제는 개인 프로젝트를 할 때였습니다. Claude Code를 실행하면 회사 DB 스키마, 정산 로직, 웨딩 도메인 컨텍스트가 매번 로딩됩니다. 쓸모없는 토큰이 낭비되는 것은 물론이고, 회사용 커맨드와 에이전트가 개인 프로젝트에서.. 2026. 2. 20.
CLAUDE.md 제대로 쓰기 - 전역/프로젝트/개인 설정 분리 CLAUDE.md 하나에 다 넣으면 팀 공유와 개인 설정이 섞입니다. 전역, 프로젝트, 로컬 3단계로 분리해서 팀 규칙은 Git 커밋하고, 내 작업 메모는 로컬에만 유지하는 방법을 정리했습니다. 💡 한 줄 요약: Claude Code 지침 파일을 3단계로 분리하면 팀 규칙은 공유하고, 개인 선호는 따로 관리할 수 있습니다.📑 목차1. 설정 파일 두 종류2. CLAUDE.md 계층 구조3. settings.json 계층 구조4. 전체 구조 정리마무리참고 자료1. 설정 파일 두 종류Claude Code를 사용할 때 알아야 할 설정 파일은 두 종류입니다.파일역할형식CLAUDE.md지침, 컨텍스트 (무엇을 해야 하는지)Markdownsettings.json권한, 도구 설정 (무엇을 할 수 있는지)JSON두 .. 2026. 1. 22.