본문 바로가기

전체 글25

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.
Claude Code 슬래시 명령어 만들기 - 반복 작업을 한 단어로 매번 같은 프롬프트 치는 게 귀찮다면 슬래시 명령어를 만들어보세요. .claude/commands/ 폴더에 마크다운 파일 하나 만들면 /commit, /plan 같은 나만의 단축 명령어를 쓸 수 있습니다.📑 목차들어가며1. 슬래시 명령어란?2. 명령어 만들기 기초3. 실전 예제 3가지4. 고급 기능5. 전체 구조 정리마무리참고 자료들어가며Claude Code를 쓰다 보면 비슷한 프롬프트를 반복해서 치게 됩니다. "커밋 전에 console.log 있는지 확인해줘", "이 기능 구현 계획 세워줘", "코드 리뷰해줘"... 매번 같은 말을 하는 건 귀찮고, 빼먹는 조건도 생깁니다. Claude Code 슬래시 명령어를 쓰면 이런 반복 프롬프트를 /commit, /plan, /review 같은 한 단어로 줄일.. 2026. 1. 22.
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.