Skip to content

docs: add warning about CLAUDE.md file injection in Claude Code provider #293

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

roomote[bot]
Copy link
Contributor

@roomote roomote bot commented Aug 2, 2025

This PR adds documentation about the CLAUDE.md file injection behavior that occurs with the Claude CLI tool.

Changes

  • Added a warning section explaining that the Claude CLI automatically injects CLAUDE.md file contents
  • Documented the token usage implications of this behavior
  • Provided debugging tips for users who may encounter unexpected behavior
  • Included information about which versions are affected (1.0.62 and potentially others)

Context

This addresses the issue raised in RooCodeInc/Roo-Code#6604 where it was discovered that the Claude CLI tool transparently injects the contents of any CLAUDE.md file found in the repository root into the conversation context.

Impact

Users will now be aware of this behavior and can make informed decisions about:

  • Whether to use CLAUDE.md files with the Claude Code provider
  • The token cost implications of having a CLAUDE.md file
  • How to debug unexpected behavior related to injected instructions

Fixes RooCodeInc/Roo-Code#6604


Important

Adds documentation warning about CLAUDE.md file injection by Claude CLI tool in docs/providers/claude-code.md.

  • Documentation:
    • Adds warning about CLAUDE.md file injection in docs/providers/claude-code.md.
    • Explains automatic injection by Claude CLI tool (version 1.0.62 and potentially others).
    • Details token usage implications and debugging tips.
    • Lists affected versions and clarifies behavior is at CLI level, not Roo Code.

This description was created by Ellipsis for 458aac5. You can customize this summary. It will automatically update as commits are pushed.

- Document that Claude CLI automatically injects CLAUDE.md contents
- Explain token usage implications
- Add debugging tips for users experiencing unexpected behavior
- Reference issue #6604 from Roo-Code repository
Copy link

vercel bot commented Aug 2, 2025

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
roo-code-docs ✅ Ready (Inspect) Visit Preview 💬 Add feedback Aug 2, 2025 6:37pm

Copy link
Collaborator

@daniel-lxs daniel-lxs left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@hannesrudolph want to take a look?

@daniel-lxs daniel-lxs moved this from Triage to PR [Needs Review] in Roo Code Roadmap Aug 2, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Status: PR [Needs Review]
Development

Successfully merging this pull request may close these issues.

Notice: Claude Code Provider Injects CLAUDE.md
2 participants