AI19 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. Gemini CLI sessionId 추출 및 DB 관리 가이드: 여러 AI 에이전트 협업 시스템 구축하기 Gemini CLI의 sessionId를 로컬 로그에서 추출하는 '세션 낚시' 기술로 각 AI 에이전트에게 고유한 식별 정보를 부여합니다. CLI의 한계를 넘어 여러 에이전트를 DB로 체계적으로 관리하고 협업 시스템을 구축하는 실전 가이드를 확인하세요.📑 목차들어가며: "Gemini CLI로 서브 에이전트를 만들 수 있을까?"문제: sessionId는 어디에 있나?발견: 로컬 로그는 모든 것을 안다해결: 세션 낚시(Session Fishing) 기술보너스:에이전트 간 세션 공유와 오케스트레이션마무리: 다음 단계는?1. 들어가며: "Gemini CLI로 서브 에이전트를 만들 수 있을까?"최근 Claude Code 같은 도구들은 스스로 서브 에이전트를 생성하고 제어하며 복잡한 태스크를 수행합니다. 하지만 .. 2026. 3. 4. 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. 이전 1 2 3 4 다음
