[FEATURE REQUEST] Allow Claude Code to access gitignored files

[npupko]

Current Behavior

Claude Code currently respects .gitignore files and excludes gitignored files from:

• @-mention autocomplete suggestions
• General file awareness and reading (unless explicitly requested)

Problem Description

This behavior creates friction for local development workflows where users want to:

• Keep certain files out of version control (private notes, local configs, etc.)
• Still have Claude Code access these files for development assistance
• Avoid committing sensitive or personal files to public repositories

Use Case Example

I maintain a local tasks/ folder with markdown files containing project notes and TODOs. These files are:

• Gitignored to keep them out of the public repository
• Useful for Claude Code to reference when providing development assistance
• Currently inaccessible via @-mentions, making the workflow cumbersome

Proposed Solution

Introduce a .claudeignore file that works similarly to .gitignore but specifically controls Claude Code's file awareness:

• Override gitignore: Allow patterns like !tasks/ to make gitignored files visible to Claude Code
• Additional exclusions: Support standard ignore patterns to exclude files from Claude Code even if they're tracked by git
• Precedence: .claudeignore rules should take precedence over .gitignore for Claude Code's file handling

Example .claudeignore configuration:

# Make tasks folder visible to Claude Code despite being gitignored
!tasks/

# Exclude specific files from Claude Code even if tracked by git
*.log
temp/

Alternative Solutions

1. Command-line flag: --include-gitignored to override gitignore behavior globally
2. Config file option: Setting in Claude Code's configuration to control gitignore respect
3. Environment variable: CLAUDE_RESPECT_GITIGNORE=false for session-based control

Benefits

• Maintains security by keeping sensitive files out of version control
• Improves local development experience with Claude Code
• Provides granular control over file visibility
• Follows familiar patterns (similar to .gitignore syntax)

Impact

This would significantly improve the local development workflow for users who need to reference private/local files while keeping them out of version control.

This issue has been re-created, because the initial one has been closed without the solution: #2305

[nicksergeant]

I'd very much like this as well, though I wonder if an allowlist style would be less complicated, ie.,

.gitignore

tasks/

.claudeallow

tasks/

=> Claude will surface tasks/ things in autocomplete and automatically read them as necessary.

This way Claude can continue to reference .gitignore for ignored files, but then also allow files explicitly allowed in .claudeallow for use in autocomplete and file discovery / reading.

[npupko]

@nicksergeant Yeah, something like this. I think the main concern for everyone is the specs, tasks, plans whatever the folder with the specifications we don't want to commit and track but need for planning

[myousefi]

+1

[github-actions]

Found 3 possible duplicate issues:

1. Need for dedicated .claudeignore file - .gitignore is insufficient for multi-platform projects #1304
2. Make .claudeignore set ignorePattnerns by default #620
3. .claudeignore #579

This issue will be automatically closed as a duplicate in 3 days.

• If your issue is a duplicate, please close it and 👍 the existing issue instead
• To prevent auto-closure, add a comment or 👎 this comment

🤖 Generated with Claude Code

[speto]

Update: This issue persists and shows inconsistent behavior

The Anthropic team claimed to have fixed the gitignore issues in #611, #1818, #2336, but they only fixed the dot-prefix (hidden files) issue, NOT the gitignore exclusion problem.

Current State:

1. Inconsistent behavior: Per [BUG] Read() bypasses .claude/claude.json and .gitignore restrictions for ignored files #1373, Claude Code CAN read gitignored files with Read() but WON'T show them in @ autocomplete. This inconsistency is confusing and suggests the restriction is only partially implemented.

2. Strong community need:

   • Need for dedicated .claudeignore file - .gitignore is insufficient for multi-platform projects #1304 has 58+ 👍 reactions requesting .claudeignore
   • [FEATURE REQUEST] Allow Claude Code to access gitignored files #2305 (the original) had 57+ 👍 reactions
   • Multiple duplicate issues keep being created (Make .claudeignore set ignorePattnerns by default #620, Hidden Directory Listing Failure in LS Tool Compared to Bash ls #611, feature: Allow .claude directory to show up in @ autocompletion #1818, Hidden Files Not Displayed with '@.hidden' Command #2336)

3. Core design flaw: Claude Code conflates two orthogonal concerns:

   • Version control (.gitignore): What should be shared with other developers
   • AI tool access: What the AI should be aware of locally

Real-world Impact:

Developers cannot properly use Claude Code with:

• Local environment files (.env.local, .env.development)
• Personal notes and TODO files (tasks/, notes/)
• Local test data and fixtures
• Project-specific Claude instructions (CLAUDE.local.md)
• Any file that needs to stay out of version control but be accessible to the AI

The Ask:

Please don't close this issue without a proper solution. The community has been clear about the need, and the partial fix for dot-files shows you recognize there's a problem. We need either:

1. A .claudeignore file that overrides gitignore for Claude Code
2. Proper configuration in .claude/claude.json that actually works (currently broken per [BUG] Read() bypasses .claude/claude.json and .gitignore restrictions for ignored files #1373)
3. At minimum, consistent behavior (if files can be read, they should be discoverable)

This has been an issue for 6+ months across multiple reports. The fact that issues keep being closed and recreated shows this is not resolved. Can we please get a proper resolution or at least an explanation of any technical limitations preventing this feature?

Related issues showing the scope of this problem:

• Hidden Directory Listing Failure in LS Tool Compared to Bash ls #611 (claimed fixed, but only for dot-files)
• Make .claudeignore set ignorePattnerns by default #620 (security concerns with .env files)
• Need for dedicated .claudeignore file - .gitignore is insufficient for multi-platform projects #1304 (58+ upvotes for .claudeignore)
• [BUG] Read() bypasses .claude/claude.json and .gitignore restrictions for ignored files #1373 (shows the inconsistent behavior bug)
• feature: Allow .claude directory to show up in @ autocompletion #1818 (dot-directories in autocomplete)
• [FEATURE REQUEST] Allow Claude Code to access gitignored files #2305 (original issue, closed without solution)
• Hidden Files Not Displayed with '@.hidden' Command #2336 (hidden files not shown)

[jaens]

Just to add, the opposite problem is real as well - eg. generated code is usually .gitignore'd though visible to developers – but since Claude respects .gitignore, it becomes quite dumb since it can't look up eg. any generated type definitions.

So there's a need to both ignore more and less.

[luiz00martins]

+1 this.

Quite annoying not being able to access a personal specific file I'm using to aid development, just because I'm (properly, as per git etiquette) gitignoring it.

[oikon48]

+1
.claude/ file can be @ -mentioned . It would be helpful when Claude Code user can optionally choose the setting files and others being autocompleted or not.

[paaneko]

+1

[KerryJones]

+1

[maxpavlov]

Imagine working on a cli tool which places logs in it's "bin" directory which is gitignored. You want CC to read the log when makeing a propmpt but you can't @reference the file and have to copy and paste the path manually. This is simply about convenience and this request will keep on re-appearing until this is implemented by the CC team. Matter of time really.

+1