claude code13 Claude Code CLAUDE.md: 팀 지침을 위한 계층 구조와 스킬 분리 실전 적용기 Claude Code의 CLAUDE.md를 팀에서 운영하다 보면, ~/.claude에 공통 지침을 넣는 방식의 한계를 느끼게 됩니다. 개인 설정과 섞이고, 무관한 프로젝트에서도 로드되고, 팀 동기화도 안 됩니다. 이 글에서는 공통 지침을 워크스페이스 저장소로 이동하고, 계층형 구조와 플러그인(커맨드·스킬·에이전트)으로 팀 규칙을 체계적으로 관리한 경험을 정리합니다. 💡 한 줄 요약: ~/.claude는 개인 영역으로 남기고, 팀 지침은 Git으로 관리되는 워크스페이스 저장소에 계층형으로 배치하면 됩니다.📑 목차들어가며1. ~/.claude에 팀 공통 지침을 두면 생기는 일2. 해결: 공통 지침을 워크스페이스 저장소로 이동3. 계층으로 정리4. 플러그인: 지침으로 다루기 어려운 것들5. 서브에이전트 동.. 2026. 3. 11. Gemini CLI에 Serena MCP 연동하기 - Git Clone 방식 실전 설정 지난 포스팅 Claude Code에 Serena MCP 연동하기 - Java/TypeScript LSP 설정에서 Claude Code에 Serena를 붙이는 방법을 다뤘습니다. 이번엔 Gemini CLI 버전입니다. 기본 개념은 같지만 설정 명령어와 구성 파일 형식이 다르고, 소스를 직접 클론해서 쓰는 방식을 택했기 때문에 그 차이를 중심으로 정리합니다.목차Claude Code 버전과 뭐가 다른가Serena 클론 및 환경 구성Project Server 시작Gemini CLI에 MCP 등록하기설정 파일 직접 확인하기실전 테스트 및 대시보드 활용마무리Claude Code 버전과 뭐가 다른가 구조 자체는 동일합니다. Gemini CLI → Serena MCP Server → Project Server(LSP).. 2026. 3. 8. Claude Code에 Serena MCP 연동하기 - Java/TypeScript LSP 설정 grep 방식의 한계를 넘어, Serena MCP로 LSP 기반 심볼 탐색을 Claude Code에 연동하는 방법을 Java/TypeScript 프로젝트 기준으로 설치부터 실전 활용까지 정리했습니다.목차들어가며 - grep의 한계전체 구조 이해하기설치 및 MCP 등록프로젝트 추가하기Language Server 설정설정 파일 직접 편집하기Project Server 시작하기주요 도구 정리매일 시작하는 순서트러블슈팅마무리들어가며 - grep의 한계한 줄 요약: Serena MCP를 Claude Code에 연동하면 grep 대신 LSP 기반 심볼 검색으로 대형 Java/TypeScript 코드베이스를 훨씬 정확하게 탐색할 수 있습니다. Claude Code로 레거시 코드를 보다 보면 어느 순간 이런 상황이 옵니.. 2026. 3. 7. 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 Code Hooks로 자동화하기 - 실수 방지부터 작업 기록까지 Claude Code가 파일 수정하거나 삭제할 때 자동으로 검사하고 싶다면 Hooks를 쓰세요. 의도치 않은 파일 삭제 방지, console.log 자동 감지, 작업 내역 저장까지 설정 한 번으로 자동화할 수 있습니다.📑 목차들어가며1. Hooks란?2. 설정 방법3. 실전 예제 4가지4. matcher 작성법5. 전체 구조 정리마무리참고 자료들어가며Claude Code를 쓰다 보면 가끔 의도치 않은 동작이 발생합니다. 요청하지 않은 파일이 삭제되거나, 디버깅용 console.log가 남아있는 채로 커밋되거나. 매번 직접 확인하는 건 한계가 있습니다. Claude Code Hooks를 쓰면 이런 상황을 자동으로 감지하고 차단할 수 있습니다. 파일 삭제 전에 확인을 요청하거나, 수정 후에 자동으로 린트 .. 2026. 1. 26. Claude Code 슬래시 명령어 만들기 - 반복 작업을 한 단어로 매번 같은 프롬프트 치는 게 귀찮다면 슬래시 명령어를 만들어보세요. .claude/commands/ 폴더에 마크다운 파일 하나 만들면 /commit, /plan 같은 나만의 단축 명령어를 쓸 수 있습니다.📑 목차들어가며1. 슬래시 명령어란?2. 명령어 만들기 기초3. 실전 예제 3가지4. 고급 기능5. 전체 구조 정리마무리참고 자료들어가며Claude Code를 쓰다 보면 비슷한 프롬프트를 반복해서 치게 됩니다. "커밋 전에 console.log 있는지 확인해줘", "이 기능 구현 계획 세워줘", "코드 리뷰해줘"... 매번 같은 말을 하는 건 귀찮고, 빼먹는 조건도 생깁니다. Claude Code 슬래시 명령어를 쓰면 이런 반복 프롬프트를 /commit, /plan, /review 같은 한 단어로 줄일.. 2026. 1. 22. 이전 1 2 3 다음
