[MODEL] Claude verbose code comments by default — ignores instructions to stop. · Issue #65961 · anthropics/claude-code · GitHub
//voltron/issues_fragments/issue_layout" data-turbo-transient="true" />
Skip to content
Type / to search
Sign in<br>Sign upAppearance settings
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
Uh oh!
There was an error while loading. Please reload this page.
anthropics
claude-code
Public
Notifications<br>You must be signed in to change notification settings
Fork<br>22.7k
Star<br>141k
[MODEL] Claude verbose code comments by default — ignores instructions to stop. #65961
New issue<br>Copy link
New issue<br>Copy link
Open
Open<br>[MODEL] Claude verbose code comments by default — ignores instructions to stop.#65961
Copy link
Labels<br>area:modelbugSomething isn't workingSomething isn't workingmodel
Description
bhuvarloka<br>opened on Jun 7, 2026
Issue body actions
Preflight Checklist
I have searched existing issues for similar behavior reports
This report does NOT contain sensitive information (API keys, passwords, etc.)
Type of Behavior Issue
Claude modified files I didn't ask it to modify
What You Asked Claude to Do
Description
Claude Code adds far too many code comments by default. The comments are mostly redundant, restating what the adjacent code already makes obvious. It happens on every language, every model.
Crucially, this default persists even when explicitly told to stop:
A clear, mandatory rule in CLAUDE.md does not reliably suppress it.
Reinforcing the rule via the memory system does not stop it either.
I suppose the core problem is that verbose commenting is the out-of-the-box default , and that default is strong enough to override explicit user instructions. Users shouldn't have to stack a CLAUDE.md rule + memory entries + enforcement hooks just to get clean code.
Environment
Claude Code
Model: claude-opus-4-8
What Claude Actually Did
Contant verbose code commenting.
Expected Behavior
Expected behavior
Restrained commenting as the default — comment only genuinely non-obvious constraints or "why" decisions, not self-evident "what." And when a project instruction says to minimize comments, that instruction should be reliably respected.
Actual behavior
Reflexive explanatory comments on most code output, even when instructed otherwise. Requires constant manual cleanup .
Files Affected
all
Permission Mode
Accept Edits was ON (auto-accepting changes)
Can You Reproduce This?
Yes, every time with the same prompt
Steps to Reproduce
No response
Claude Model
Opus
Relevant Conversation
Impact
High - Significant unwanted changes
Claude Code Version
2.1.17
Platform
Anthropic API
Additional Context
No response
Reactions are currently unavailable
Metadata<br>Metadata<br>Assignees
No one assigned
Labels
area:modelbugSomething isn't workingSomething isn't workingmodel
Type
No type
Projects
No projects
Milestone
No milestone
Relationships
None yet
Development
No branches or pull requests
Issue actions<br>Open in GitHub Copilot app
You can’t perform that action at this time.