본문 바로가기

claudecode45

Claude Code Hooks로 파일 저장 시 자동 포맷팅 걸기 Claude Code 활용 팁 Claude Code로 코드를 저장할 때마다 포맷터와 린트를 수동으로 돌리고 계신가요?Hooks를 한 번만 설정하면, 파일 저장과 동시에 자동으로 코드가 정리됩니다. 📌 3줄 요약 Hooks는 Claude Code에서 파일 저장 시 포맷터·린트를 자동 실행해주는 기능입니다. settings.json에 PostToolUse 이벤트로 등록하며, matcher로 Write|Edit을 지정합니다. 포맷팅 → 린트 순서로 복합 Hook을 걸면 코드 스타일과 품질을 동시에 관리할 수 있습니다. 🗂️ 목차 Hooks가 필요한 이유와 동작 원리 settings.json에 자동 포맷팅 Hook 등록하기 린트 검사까지 .. 2026. 8. 5.
서브에이전트 스폰 상한으로 자동화 파이프라인 안정화하기 자동화 & 파이프라인Claude Code로 자동화 파이프라인을 구축할 때, 서브에이전트가 통제 없이 늘어나면 API 비용이 기하급수적으로 폭발할 수 있습니다. 환경변수 하나로 이 위험을 차단하는 방법을 정리합니다.📌 3줄 요약서브에이전트 폭주는 API 비용을 예상치의 수십 배로 뻥튀기시킬 수 있다CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION 환경변수로 세션당 서브에이전트 상한을 설정하면 된다작업 유형별로 상한을 분리하고, 초과 시 대응 로직을 미리 설계해두자📚 목차1. 자동화 파이프라인에서 서브에이전트가 위험한 이유2. CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION 설정 방법3. 상한 초과 시 동작 방식과 대응 전략4. 자동화 스크립트에 상한 설정을 녹이는 .. 2026. 8. 5.
Claude Code MCP 서버 연결로 노션 다루기 Claude Code 활용법 Claude Code는 코드 작업에 특화되어 있지만, MCP 서버를 연결하면 노션·GitHub·구글 시트 같은 외부 서비스까지 자연어로 다룰 수 있습니다. 이 글에서는 노션 MCP 서버를 예시로, 설정부터 실제 사용까지 전체 흐름을 정리합니다. 📌 3줄 요약 MCP 서버는 Claude Code와 외부 서비스(노션 등) 사이의 통역사 역할을 하는 중간 다리다. 노션 API 토큰 발급 → .claude/settings.json에 MCP 서버 등록 → 재시작하면 바로 사용 가능하다. 여러 MCP 서버를 동시에 연결하면 서비스 간 연계 작업도 자연어 한 문장으로 처리할 수 있다. 📑 목차 1. MCP 서버가 뭔지 먼저 이.. 2026. 8. 4.
Claude Code MCP 서버 연결 오류 해결법 트러블슈팅 MCP 서버를 처음 연결하다 보면 설정 파일 오타, 경로 오류, 실행 환경 불일치 같은 문제로 막히기 쉬워요.이 글에서는 대표적인 연결 실패 원인과 에러별 대응법, 그리고 연결 성공 후 확인해야 할 사항까지 한번에 정리합니다. 📌 3줄 요약 MCP 서버 연결 실패의 대부분은 설정 파일 경로 오류와 실행 환경 불일치가 원인이에요. 설정 파일 점검 체크리스트 4단계와 에러 메시지별 대응법을 알면 빠르게 해결할 수 있어요. 연결 성공 후에는 /tools로 도구 목록을 확인하고, 프로젝트별로 서버를 분리 관리하는 것이 핵심이에요. 🗂️ 목차 MCP 서버 연결이 안 되는 대표 원인 설정 파일 점검 체크리스트 서버 실행 오류별 대응.. 2026. 8. 4.
Claude Code /loop 명령으로 반복 작업 자동 실행하는 법 Claude Code 입문 Claude Code로 작업하다 보면 같은 명령을 일정 간격으로 반복해야 할 때가 있어요. /loop 명령 하나면 반복 작업을 자동화하고, 본래 작업에 온전히 집중할 수 있어요. 📌 3줄 요약 /loop은 지정한 간격으로 프롬프트나 슬래시 명령을 자동 반복 실행하는 기능이에요. /loop 5m /commit처럼 한 줄로 설정하며, 자연어 프롬프트도 반복 대상으로 지정할 수 있어요. CI/CD 모니터링, 테스트 결과 확인, 파일 변경 감시 등 "잊으면 안 되는 반복 확인" 작업에 특히 유용해요. 📑 목차 1. /loop 명령이 필요한 순간 2. /loop 기본 문법과 설정 방법 3. 반복 실행 결과 확인과 .. 2026. 8. 4.
CLAUDE.md로 프로젝트 규칙을 AI에게 가르치는 법 Claude Code 입문Claude Code에 우리 프로젝트 규칙을 알려주는 가장 쉬운 방법, CLAUDE.md 파일 하나면 충분해요.📌 3줄 요약CLAUDE.md는 프로젝트 규칙을 Claude Code에 자동으로 전달하는 설정 파일이에요.코딩 스타일·금지 사항·폴더 구조·커밋 규칙·명령어, 이 5가지만 넣어도 작업 품질이 확 달라져요.프로젝트 루트에 두면 전체 적용, 하위 폴더에 두면 영역별 적용이 가능해요.📑 목차1. CLAUDE.md가 필요한 이유2. CLAUDE.md 파일 만들기와 기본 구조3. CLAUDE.md에 담으면 좋은 규칙 5가지4. CLAUDE.md 적용 확인과 관리 요령CLAUDE.md가 필요한 이유Claude Code는 똑똑하지만, 우리 프로젝트만의 규칙까지 알지는 못해요. 변.. 2026. 8. 2.

티스토리툴바