본문 바로가기

전체 글86

Claude Code 스킬 작성부터 재사용까지 문제 해결법 Claude Code 실전 트러블슈팅 Claude Code에서 만든 스킬이 호출해도 반응이 없다면, 기능이 아니라 파일 구조 문제일 확률이 높습니다. 디렉토리 배치, 프롬프트 작성법, 재사용 설정, 디버깅 팁까지 스킬 관련 문제를 한 번에 정리합니다. 📌 3줄 요약 스킬은 .claude/skills/스킬이름/skill.md 경로를 정확히 지켜야 인식됩니다. 프롬프트가 길면 뒷부분 규칙이 무시되므로 핵심 5~7개 이내로 유지하고, 나머지는 references/로 분리하세요. 여러 프로젝트에서 재사용하려면 절대 경로를 제거하고, 글로벌 스킬과 프로젝트 스킬의 이름 충돌을 점검하세요. 📑 목차 1. 스킬 파일 구조를 잘못 만들면 인식되지 않습니다.. 2026. 8. 9.
Claude Code 블로그 자동화 파이프라인 오류 해결법 트러블슈팅 Claude Code로 블로그 글을 자동 생성하는 파이프라인을 구축하면서 실제로 부딪힌 오류들과 해결법을 단계별로 정리했습니다. 데이터 전달 구조부터 이미지 경로, 인코딩, 디버깅 전략까지 실전 경험을 담았습니다. 📌 3줄 요약 파이프라인 단계 간 JSON 키 불일치와 경로 오류가 가장 흔한 구조 문제이며, 입출력 스키마 문서화와 pathlib 사용으로 예방할 수 있습니다. 서브에이전트 호출 시 타임아웃 설정과 text=True 옵션 누락이 실패의 80% 이상을 차지합니다. 중간 산출물 파일 저장, 로그 기록, 글 단위 예외 처리로 파이프라인 전체 안정성을 확보할 수 있습니다. 📑 목차 파이프라인 설계 단계에서 먼저 부딪히는 구조 .. 2026. 8. 6.
Claude Code 서브에이전트 병렬 실행이 멈출 때 해결법 Claude Code 실전 활용 Claude Code 서브에이전트 병렬 실행, 충돌 없이 돌리는 법 Claude Code에서 반복 작업을 자동화하다 보면, 한 번에 하나씩 처리하는 방식이 답답해지는 순간이 옵니다. 파일 10개를 분석하거나, 여러 폴더에 같은 작업을 적용할 때 순차 실행은 시간이 너무 오래 걸립니다. 특히 각 작업이 서로 독립적이라서 앞선 결과를 기다릴 필요가 없다면, 순서대로 실행하는 건 자원 낭비에 가깝습니다. 📌 3줄 요약 병렬 실행의 진짜 난관은 설정이 아니라 파일 충돌·컨텍스트 초과·순서 의존성 세 가지 오류다. 에이전트별로 출력 경로를 완전히 분리하고, 의존 관계가 있는 작업은 순차로 남겨두면 대부분의 충돌이 사라진다. 실행 후에는 반드시 결과를 검증하고.. 2026. 8. 6.
CLAUDE.md 작성법: AI가 프로젝트 규칙을 무시할 때 Claude Code 입문 Claude Code에 같은 프로젝트를 열고 매번 같은 지시를 반복하고 있다면, CLAUDE.md 파일 하나로 해결할 수 있습니다. 규칙 파일을 만들어두면 AI가 매 세션마다 자동으로 읽어서 일관된 결과물을 만들어냅니다. 📌 3줄 요약 • 대화창에 입력한 규칙은 대화가 길어지면 컨텍스트에서 밀려나 유실됩니다. • CLAUDE.md 파일에 규칙을 적어두면 매 세션마다 자동 로드되어 일관성이 유지됩니다. • 규칙은 20개 이내로 짧고 명확하게, 목록 형태로 작성하는 것이 핵심입니다. 📑 목차 1. CLAUDE.md 없이 작업하면 반복되는 문제 2. CLAUDE.md의 역할과 동작 원리 3. CLAUDE.md .. 2026. 8. 6.
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.

티스토리툴바