Global .claude/CLAUDE.md configuration not automatically loaded in conversations
Resolved 💬 5 comments Opened Nov 27, 2025 by bairdstar Closed Jan 28, 2026
Problem Description
The Claude Code system is designed to support global configuration files at ~/.claude/CLAUDE.md that should be automatically loaded and available to the assistant in every conversation. However, this functionality is not working as designed.
Current Behavior
- The global CLAUDE.md file exists and contains important tool configurations (e.g., ast-grep installation v0.40.0, command availability)
- This context is only visible to the assistant if explicitly provided in the conversation context
- The assistant does not automatically load or integrate this global configuration at conversation start
- Users must manually reference or provide these instructions, defeating the purpose of a global config file
- The assistant fails to proactively use configured tools without being explicitly reminded
Expected Behavior
- The ~/.claude/CLAUDE.md file should be automatically loaded and available to the assistant at the start of every conversation
- The assistant should reference and use tools/configurations from this file without being prompted by the user
- Users should not need to repeat global instructions across conversations
- Configured tools should be part of the assistant's baseline capabilities
Impact
- Reduces reliability of the system - users cannot trust that configured tools will be available
- Creates confusion about system design and capabilities
- Defeats the purpose of global configuration files
- Forces users to manually manage what should be automatic configuration
Environment
- Platform: WSL2 Linux (5.15.167.4-microsoft-standard-WSL2)
- Working directory: /mnt/c/Users/baird/onedrive/projects/stocktrading
- Global config location: ~/.claude/CLAUDE.md
- Installed tools referenced in config: ast-grep (v0.40.0)
Steps to Reproduce
- Create a ~/.claude/CLAUDE.md file with tool configurations
- Start a new conversation with Claude Code
- Observe that the assistant does not reference or use the configured tools
- User must explicitly remind assistant about the global configuration
This issue has 5 comments on GitHub. Read the full discussion on GitHub ↗