claudeignore 파일 만들면 클로드 코드가 진짜 무시하나요?
답변 1
- 첫째운영진Lv.67일 전
안녕하세요, 운영진입니다. 결론부터 말씀드리면 .claudeignore는 Claude Code의 공식 기능이 아니고, 파일을 만들어 두셔도 아무 효과가 없습니다. 민감한 파일을 막으려면 설정의 권한 규칙(deny)을 쓰셔야 합니다. Claude Code 공식 권한 문서에는 "프로젝트에 .claudeignore 파일이 있어도 효과가 없으니, 항목을 Read deny 규칙으로 옮기라"고 안내되어 있습니다. .gitignore처럼 알아서 먹히지 않는 것이 맞습니다. 설정 방법은 프로젝트의 .claude/settings.json에 deny 규칙을 넣는 것입니다. 예시는 다음과 같습니다. { "permissions": { "deny": [ "Read(./.env)", "Read(./.env.*)", "Read(./secrets/**)" ] } } node_modules도 같은 방식으로 Read(node_modules/**) 규칙을 추가할 수 있습니다. 파일명만 적은 패턴은 gitignore 방식으로 하위 폴더까지 매칭됩니다. 확인 방법은 간단합니다. 설정을 저장한 뒤 Claude Code에게 ".env 파일을 읽어줘"라고 요청해 보세요. 규칙이 적용됐다면 읽기가 거부됩니다. 다만 한계도 알아두셔야 합니다. 1. Read 규칙은 내장 파일 도구와, cat·head 같이 Claude Code가 인식하는 Bash 파일 명령에 적용됩니다. 2. Grep·Glob 등에는 최선 노력(best-effort) 방식으로 적용된다고 문서에 명시되어 있습니다. 3. 파일 이름을 지정하지 않고 읽는 명령(예: 폴더 전체를 grep)이나, 파이썬·노드 스크립트가 직접 파일을 여는 경우는 deny 규칙이 막지 못합니다. 4. 모든 프로세스의 접근을 확실히 막으려면 공식 문서가 권하는 샌드박스를 함께 켜는 것이 안전합니다. 정리하면 .env 같은 비밀 값은 deny 규칙을 기본으로 걸고, 중요도가 높다면 샌드박스까지 병행하시길 권합니다. 애초에 실제 키를 프로젝트 폴더 밖에 두는 것도 좋은 방법입니다. 권한 규칙(allow·deny)과 권한 모드는 아래 가이드에 자세히 정리해 두었습니다. https://usingclaude.com/ko/claude-code/install/claude-code-permissions