본문 바로가기

AI코딩21

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.
CLAUDE.md 프로젝트 규칙 설정으로 AI 헛발질 줄이는 법 Claude Code 입문Claude Code가 엉뚱한 파일을 수정하고, 안 쓰는 라이브러리를 설치하고, 관련 없는 코드를 리팩토링하는 문제를 겪고 계신가요?CLAUDE.md 파일 하나면 이런 "AI 헛발질"을 대폭 줄일 수 있습니다.📌 3줄 요약CLAUDE.md는 AI에게 프로젝트 맥락을 알려주는 온보딩 문서 역할을 한다기술 스택, 금지 사항, 디렉토리 구조를 적으면 AI의 엉뚱한 행동이 크게 줄어든다처음부터 완벽하게 쓰지 말고, AI가 실수할 때마다 규칙을 하나씩 추가하는 방식이 가장 효과적이다🗂️ 목차CLAUDE.md 없이 작업하면 생기는 문제들CLAUDE.md 핵심 규칙 작성법실전 CLAUDE.md 템플릿 적용하기CLAUDE.md 적용 후 달라지는 점CLAUDE.md 없이 작업하면 생기는 문제.. 2026. 8. 2.
Claude Code에서 Opus 모델로 장시간 에이전트 작업이 끊길 때 해결법 트러블슈팅Claude Code에서 Opus 모델로 장시간 에이전트 작업을 돌리다가 갑자기 끊긴 적 있으신가요? 컨텍스트 초과, 타임아웃, 토큰 폭증까지 — 원인별 해결법과 실패 시 복구 방법을 정리했습니다.📌 3줄 요약장시간 작업 실패의 3대 원인은 컨텍스트 윈도우 초과, 네트워크 타임아웃, 토큰 사용량 폭증입니다.작업을 3~5단계로 분할하고, 중간중간 /compact 명령으로 컨텍스트를 압축하면 성공률이 크게 올라갑니다.실패 시 claude --resume으로 세션을 이어가고, git stash로 중간 결과를 보존할 수 있습니다.📑 목차1. Opus 모델로 장시간 작업이 실패하는 이유2. 타임아웃 설정과 모델 선택 확인하기3. 작업을 쪼개서 안정적으로 실행하는 방법4. 장시간 작업 실패 시 복구하는.. 2026. 8. 2.
Claude Code 모델 선택 가이드: Opus vs Sonnet vs Haiku 비교 Claude Code 입문 Claude Code를 처음 설치하면 기본 모델이 자동으로 설정됩니다. 그래서 많은 분이 모델을 바꿀 수 있다는 사실 자체를 모르고 지나칩니다. Opus, Sonnet, Haiku — 세 모델의 차이와 전환 방법을 정리했습니다. 📌 3줄 요약 Claude Code에서 Opus 4.6, Sonnet 4.6, Haiku 4.5 세 모델을 자유롭게 전환할 수 있다. Sonnet을 기본으로 쓰고, 어려운 작업에만 Opus를 꺼내는 전략이 비용 대비 만족도가 가장 높다. 대화 중 /model 명령어 한 줄이면 즉시 전환되고, 대화 맥락도 그대로 유지된다. 🗂️ 목차 1. Claude Code에서 모델을 고를 수 있다는 사실 .. 2026. 7. 29.
Claude Code Fast 모드로 응답 속도 2배 높이는 법 Claude Code 입문Claude Code를 쓸 때 응답 대기 시간이 아깝다고 느낀 적 있으신가요? Fast 모드 하나면 동일한 Opus 모델을 유지하면서 응답 속도를 2배 이상 끌어올릴 수 있습니다. 켜는 법부터 실전 활용 전략까지, 직접 써보고 정리했습니다.📌 3줄 요약Fast 모드는 같은 Opus 모델을 그대로 쓰면서 출력 속도만 높여주는 기능입니다.대화창에 /fast만 입력하면 즉시 전환되고, 다시 입력하면 일반 모드로 돌아옵니다.정형화된 작업은 Fast 모드, 깊은 사고가 필요한 작업은 일반 모드로 구분하면 시간 대비 효율이 크게 올라갑니다.📑 목차Fast 모드가 필요한 순간Fast 모드 켜는 방법과 설정Fast 모드 응답 속도 실제 비교Fast 모드를 활용한 실전 비용 절약 전략Fast.. 2026. 7. 25.
Claude Code MCP 서버 연결로 외부 데이터 가져오는 법 Claude Code 활용Claude Code는 로컬 파일과 터미널만 다룰 수 있어요. 외부 API, 데이터베이스, 사내 시스템에 접근하려면 MCP 서버가 필요해요. 이 글에서는 MCP 서버의 개념부터 설정, 실시간 조회, 백그라운드 전환까지 실전 흐름을 정리했어요.📌 3줄 요약MCP 서버는 Claude Code와 외부 서비스를 연결하는 플러그인이에요..claude/settings.json에 서버 정보를 추가하면 바로 사용할 수 있어요.2분 초과 호출은 자동으로 백그라운드 전환되어 다른 작업을 병행할 수 있어요.📑 목차1. MCP 서버가 필요한 이유2. Claude Code에 MCP 서버 연결하는 설정법3. MCP 도구로 실시간 데이터 조회하기4. 2분 초과 호출과 백그라운드 전환 활용법MCP 서버가.. 2026. 7. 25.