VSCode Claude Code Extension에서 .py 파일이 @ 자동완성에 안 뜨는 문제

문제

VSCode에서 Claude Code 확장을 사용할 때, @를 입력하면 프로젝트 파일을 자동완성으로 참조할 수 있다. 그런데 Python 프로젝트에서 .py 파일만 목록에 나타나지 않는 문제가 있었다.

• .ini, .toml 등 다른 확장자 파일은 정상적으로 표시됨
• 터미널에서 claude CLI로 실행하면 .py 파일도 정상 표시됨
• VSCode 확장에서만 발생

원인

Python 프로젝트의 .gitignore에 기본으로 포함되는 이 한 줄이 원인이었다:

*.py,cover

이 패턴은 coverage.py의 annotate 명령이 생성하는 파일명.py,cover 형식의 커버리지 결과 파일을 무시하기 위한 것이다. gitignore.io에서 Python 템플릿을 받으면 기본으로 포함된다.

git 자체는 이 패턴을 정확히 해석하지만, VSCode Claude Code 확장의 gitignore 파서는 쉼표를 잘못 처리하여 *.py 파일 전체를 제외시키는 것으로 보인다.

해결

.gitignore에서 해당 줄을 주석 처리하면 된다:

# *.py,cover

*.py,cover 파일은 요즘 거의 생성되지 않는 레거시 포맷이므로, 주석 처리해도 실사용에 영향은 없다.

참고

GitHub Issue #2012에서 @gabor-one이 "claudeCode.respectGitIgnore": false 설정으로 우회할 수 있다는 것을 공유했다. 하지만 gitignore 전체를 무시하면 .env 같은 민감한 파일까지 노출될 수 있으므로, 문제가 되는 줄만 주석 처리하는 것이 더 안전하다.