SEARCH : claude code(5)

CATEGORY : claude code(5)

TAGS : claude code(5)

ARCHIVE : claude code(5)

Claude Code로 코딩하다 파일 꼬였을 때 직전 상태로 되돌리는 법 (git restore와 세션 리셋)

2026. 11. 3.

터미널에서 Claude Code 켜두고 바이브코딩하다 보면 누구나 한 번쯤 겪는 상황이 있습니다."이 함수 버그 좀 잡아줘"라고 가볍게 시켰는데, AI가 신나서 함수 하나 고치겠다고 주변 파일 서너 개를 연쇄 수정하고, 패키지 버전까지 건드려서 멀쩡하던 빌드가 와장창 깨지는 순간입니다.당황해서 터미널에 "방금 수정한 거 다 취소하고 원래대로 돌려놔"라고 치면, Claude가 "죄송합니다, 원래대로 복구하겠습니다"라며 사과를 늘어놓더니 코드를 더 이상하게 덮어써서 돌이킬 수 없는 강을 건너곤 합니다.AI에게 말로 복구를 부탁하지 마세요. 파일이 꼬였을 때 가장 빠르고 깔끔하게 직전 상태로 원복하는 현실적인 대처법 3가지를 정리했습니다. 1. 꼬인 파일만 핀포인트로 되돌리기 (git restore)가장 흔한..
AI가 “완료했습니다”라고 한 뒤, 코드를 믿기 전에 확인할 5단계

AI가 “완료했습니다”라고 한 뒤, 코드를 믿기 전에 확인할 5단계

2026. 10. 11.

AI 코딩 도구가 “완료했습니다”라고 말해도, 요구사항을 충족했다는 뜻은 아닙니다. 먼저 변경 범위를 보고, 같은 증상을 다시 확인하고, 테스트가 무엇을 검사했는지 읽은 뒤 실제 화면과 독립 리뷰까지 통과시켜야 합니다.이 글은 Claude Code·Codex·GitHub Copilot으로 코드를 수정하는 초급·중급 사용자를 위한 검증 순서입니다. 2026년 10월 10일 기준 공식 문서를 검토했으며, 아래 명령은 실행 결과가 아니라 프로젝트에 맞게 골라 쓰는 예시입니다.완료 보고와 완료 증거를 분리하세요에이전트의 요약은 작업 기록이지 검수 결과가 아닙니다. “파일 3개를 수정했고 테스트가 통과했다”는 문장이 있어도 예상하지 않은 설정 파일을 건드렸거나, 테스트 자체를 느슨하게 바꿨거나, 실제 브라우저에서..
AGENTS.md와 CLAUDE.md를 둘 다 만들면 끝일까? Claude가 하나를 건너뛰는 조건

AGENTS.md와 CLAUDE.md를 둘 다 만들면 끝일까? Claude가 하나를 건너뛰는 조건

2026. 10. 10.

결론부터 말하면, Claude Code는 기본 설정에서 AGENTS.md와 CLAUDE.md를 자동으로 합쳐 읽지 않습니다. 작업 폴더나 상위 경로에 CLAUDE.md 또는 CLAUDE.local.md가 하나라도 있으면, 공통 지침으로 만든 AGENTS.md를 건너뛸 수 있습니다.이 글은 Codex와 Claude Code를 같은 저장소에서 쓰는 초급·중급 사용자를 위한 선택 가이드입니다. 2026년 10월 9일 기준 Codex 공식 문서와 Claude Code v2.1.277 이후 공식 동작을 확인했으며, 실제 프로젝트 파일을 만들거나 설정을 변경하지 않고 문서 기준으로 정리했습니다.먼저 내 상황에 맞는 답부터 고르세요상황권장 구조이유Codex·Cursor·Claude Code 등 여러 도구가 같은 규칙..
Claude Code가 고쳤다는데 파일이 안 보일 때: 삭제보다 먼저 확인할 6곳

Claude Code가 고쳤다는데 파일이 안 보일 때: 삭제보다 먼저 확인할 6곳

2026. 10. 9.

Claude Code가 수정을 마쳤다고 했는데 VS Code에 파일이나 diff가 안 보인다면, 곧바로 같은 작업을 다시 시키지 마세요. 먼저 같은 작업 폴더인지, 실제 파일이 바뀌었는지, 변경 화면만 빠진 것인지 순서대로 구분해야 중복 수정과 덮어쓰기를 피할 수 있습니다.이 글은 Windows·VS Code·Cursor에서 Claude Code를 처음 쓰는 사람을 위한 초급 진단 가이드입니다. 2026년 10월 8일 기준 공식 문서를 확인했으며, 특정 버전의 버그를 모든 환경에 일반화하지 않습니다.먼저 세 가지 상태를 구분하세요상태보이는 증상먼저 할 일실제 수정 실패파일 시간·내용·git 상태가 모두 그대로Claude Code 오류와 권한, 작업 경로 확인수정됐지만 화면에 안 보임파일 내용이나 git ..
Claude Code Mods 사용 전 확인할 것: 플러그인 권한·보안 체크리스트

Claude Code Mods 사용 전 확인할 것: 플러그인 권한·보안 체크리스트

2026. 10. 7.

Claude Code mod는 Skill이나 테마보다 훨씬 깊게 Claude Code의 동작을 바꿉니다. 프롬프트를 다시 쓰고, 도구 호출을 막거나 바꾸며, 사용자 인터페이스와 일부 권한 처리 흐름을 확장할 수 있습니다. 다만 기본 권한 확인 프롬프트 자체를 다시 그리거나 표시 내용을 바꾸는 것은 허용되지 않습니다.따라서 “재미있는 플러그인”이 아니라 코드 패키지로 검토해야 합니다. 이 글은 2026년 10월 6일 기준 공식 문서와 공개 저장소를 확인해, 무엇이 달라졌고 설치 전에 무엇을 봐야 하는지 정리한 고급 가이드입니다. 이 환경에서는 외부 mod를 설치하거나 실행하지 않았습니다. Claude Code Mod는 무엇인가?mod는 JavaScript 또는 TypeScript 이벤트 핸들러로 Claud..