본문 바로가기

전체 글86

Claude Code 멀티 세션 충돌 없이 동시 실행하는 방법 CLAUDE CODE 실전 활용 Claude Code 멀티 세션, 충돌 없이 동시 실행하는 방법 Claude Code로 작업하다 보면 한 가지 일만 시키기엔 아까운 순간이 옵니다. 프론트엔드 수정을 맡겨놓고, 다른 터미널에서는 백엔드 API를 고치고 싶을 때가 대표적이에요. 테스트 코드를 돌리면서 동시에 다른 파일의 리팩토링을 진행하고 싶은 경우도 자주 생깁니다. 특히 빌드 시간이 긴 프로젝트에서는 빌드를 기다리는 동안 다른 작업을 병렬로 처리하면 시간을 크게 절약할 수 있어요. 문제는 준비 없이 세션을 여러 개 띄우면 반드시 한 번은 꼬인다는 점입니다. 📌 3줄 요약 같은 프로젝트 폴더에서 claude 세션 두 개를 띄우면 파일 덮어쓰기·git 커밋 이력 충돌이 발생.. 2026. 8. 18.
Claude Code 세션 끊겼을 때 recap으로 작업 이어가기 Claude Code 입문 · 세션 관리 Claude Code로 한창 작업하다가 터미널이 툭 닫히거나, 노트북 덮개를 덮었다 열었더니 세션이 사라져 있던 적 있으신가요? 파일은 그대로 남아 있는데 "내가 뭘 하던 중이었는지"만 통째로 증발하는 상황이요. 오늘은 세션이 끊겼을 때 /recap 명령으로 빠르게 복구하는 방법과, 애초에 끊겨도 타격이 없도록 미리 대비하는 습관까지 정리해드릴게요. 📌 3줄 요약 ① 세션이 끊기면 파일 수정 내역은 남지만 작업 맥락은 통째로 사라져요. ② 새 세션에서 /recap을 입력하면 직전 세션의 수정 파일·대화·진행 상황을 요약해줘요. ③ 가장 안정적인 조합은 작업 쪼개기 + progress.md 중간 저장이에요. .. 2026. 8. 14.
Claude Code에서 Git 명령 실패할 때 Git Bash 경로 설정법 Claude Code 문제 해결 Claude Code에서 코드를 수정하다 보면 git commit이나 git diff 같은 명령을 자동으로 실행하는 경우가 많아요. 그런데 Windows 환경에서는 "git: command not found" 에러가 뜨면서 작업이 멈추는 일이 종종 발생해요. 📌 3줄 요약 1. 원인은 Claude Code가 쓰는 bash 셸이 Git 실행 파일의 위치를 모르기 때문이에요. 2. 시스템 PATH에 Git\cmd, Git\bin, Git\usr\bin 세 경로를 등록해요. 3. 그래도 안 되면 settings.json의 shell 항목을 Git Bash로 지정하고 재시작해요. 목차 · Git 명령이 실패하는 원인 확인하기 · Git 설치.. 2026. 8. 14.
Claude Code exit code 3 오류, Node 업그레이드로 해결 Claude Code 오류 해결 Claude Code를 실행했는데 아무 반응 없이 exit code 3만 뜨고 꺼지는 경우가 있어요. 이 오류는 Claude Code가 요구하는 최소 Node.js 버전을 충족하지 못할 때 발생해요. 정상적인 실행이라면 Claude Code 인터페이스가 바로 뜨는데, 이 오류가 나면 터미널에 숫자 하나만 찍히고 아무 일도 일어나지 않아요. 처음 보면 뭐가 잘못된 건지 감이 안 잡혀서 당황스러울 수 있어요. 📌 3줄 요약 · exit code 3은 Node.js 에러가 아니라 Claude Code가 자체 정의한 종료 코드예요. · 원인은 대부분 Node.js 18 버전 사용이고, 20 이상(권장 22 LTS)으로 올리면 해결돼요. · 업그레이드 후에는 .. 2026. 8. 13.
Claude Code가 수정된 파일을 못 읽을 때 해결법 트러블슈팅 Claude Code에서 파일을 분명히 수정했는데, 수정 전 내용을 기준으로 답변하는 경험을 한 적 있나요? 이 글에서는 이 현상이 발생하는 원인과 확실한 해결법 3가지를 알려드립니다. 📌 3줄 요약 Claude Code는 파일을 매번 자동으로 다시 읽지 않아서, 외부 수정 시 옛날 내용을 참조할 수 있다 "파일 다시 읽어줘" 요청 또는 /clear 명령으로 최신 상태를 반영할 수 있다 Claude Code 안에서 직접 수정하면 이 문제가 아예 발생하지 않는다 📑 목차 1. 파일을 고쳤는데 옛날 내용을 참조하는 이유 2. Read 도구로 파일을 다시 읽게 만드는 방법 3. 컨텍스트 초기화로 최신 상태 반.. 2026. 8. 12.
Claude Code /clear로 이상 동작 초기화하기 Claude Code 입문 Claude Code를 한참 사용하다 갑자기 엉뚱한 동작을 할 때, /clear 한 줄이면 깔끔하게 해결됩니다. 이 글에서 원인부터 예방법까지 모두 정리해 드릴게요. 📌 3줄 요약 Claude Code가 엉뚱한 동작을 하는 원인은 컨텍스트 윈도우 과부하입니다. /clear 명령어 한 줄로 세션을 즉시 초기화하면 정상으로 돌아옵니다. 작업 전환 시점마다 /clear를 습관화하면 이상 동작 자체를 예방할 수 있습니다. 📑 목차 1. Claude Code가 갑자기 이상해지는 원인 2. /clear 명령어로 세션 즉시 초기화하기 3. /clear 실행 후 정상 동작 확인하는 법 4. /clear로도 해결되지.. 2026. 8. 11.
Claude Code /doctor로 설정 문제 한 번에 진단하기 Claude Code 입문Claude Code를 설치했는데 뭔가 안 돼요. 에러 메시지를 검색해봐도 답이 안 나와요. 이럴 때 /doctor 명령어 하나면 30초 안에 원인을 찾을 수 있어요.📌 3줄 요약/doctor는 Claude Code 환경 전체(Node.js·API 키·네트워크)를 자동으로 진단해주는 내장 명령어예요.초록색 ✓ / 빨간색 ✗ 표시로 문제 항목을 직관적으로 파악하고, 해결 방향까지 안내받을 수 있어요./doctor로 해결이 안 되면 캐시 초기화 → 재설치 → GitHub Issues 순서로 대응하면 돼요.🗂️ 목차1. /doctor 명령어가 하는 일2. /doctor 실행 방법과 출력 결과 읽기3. 자주 나오는 진단 항목별 해결법4. /doctor로 해결되지 않을 때 다음 단계/.. 2026. 8. 10.
WSL에서 Claude Code 실행 안 될 때 해결법 트러블슈팅 WSL에서 Claude Code 설치가 안 된다면, Node.js 버전·npm 권한·네트워크·WSL 설정 네 가지를 순서대로 점검해보세요. 대부분 10분 안에 해결됩니다. 📌 3줄 요약 WSL에서 Claude Code 설치 실패는 Node.js 미설치/구버전, npm 권한, 네트워크 차단, WSL 설정 네 가지 원인이 대부분입니다. nvm으로 Node.js 18 이상을 설치하고, npm 글로벌 경로를 사용자 디렉토리로 변경하면 권한 문제까지 한 번에 해결됩니다. WSL 2 + 리눅스 홈 디렉토리 조합이 가장 안정적인 실행 환경입니다. 📑 목차 1. WSL 환경에서 Claude Code가 안 되는 이유 2. Node.js 버전과.. 2026. 8. 10.
Claude Code 서브에이전트 역할 충돌 문제 해결법 Claude Code 활용법 Claude Code에서 서브에이전트를 여러 개 운영할 때 가장 먼저 부딪히는 문제, 역할 충돌.프롬프트 분리부터 데이터 전달 설계까지, 에이전트 팀을 안정적으로 굴리는 실전 해결법을 정리했습니다. 📌 3줄 요약 서브에이전트 역할 충돌은 프롬프트에 역할 경계를 명시하지 않아서 발생한다. 에이전트별 프롬프트를 별도 파일로 분리하고, 중간 산출물의 파일 경로와 JSON 스키마를 사전 고정하면 대부분 해결된다. 모든 서브에이전트 호출은 반드시 오케스트레이터를 거치는 순차 구조가 가장 안정적이다. 📑 목차 1. 서브에이전트 역할이 겹치는 원인 파악하기 2. 에이전트별 프롬프트 분리로 충돌 방지하기 3. 서브에이.. 2026. 8. 10.

티스토리툴바