IssueRaiser

[MODEL] Claude verbose code comments by default — ignores instructions to stop.

### Preflight Checklist - [x] I have searched [existing issues](https://github.com/anthropics/claude-code/issues?q=is%3Aissue%20state%3Aopen%20label%3Amodel) for similar behavior reports - [x] This report does NOT contain sensitive information (API keys, passwords, etc.) ### Type of Behavior Issue Persistent bad behavior. Claude ignores my instructions or configuration. ### 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 or simply making references to the chat with Claude itself, leaking its chain of thoughts. 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, and that still working partially. ### Environment - Claude Code - Model: claude-opus-4-8, also verified on Opus 5 and Sonnet 5. ### What Claude Actually Did Contant verbose code commenting. ### Expected Behavior Restrained commenting as the **default** — comment only genuinely non-obvious constraint

Posted by bhuvarloka on Jun 7, 2026, 12:38 AM

Tags

Related issues

Raise real-world problems, find people facing the same issue, and discuss solutions.2,000 issues0 comments

github (Software)

[MODEL] Claude verbose code comments by default — ignores instructions to stop.

bhuvarlokaJun 7, 2026, 12:38 AM

### Preflight Checklist - [x] I have searched [existing issues](https://github.com/anthropics/claude-code/issues?q=is%3Aissue%20state%3Aopen%20label%3Amodel) for similar behavior reports - [x] This report does NOT contain sensitive information (API keys, passwords, etc.) ### Type of Behavior Issue Persistent bad behavior. Claude ignores my instructions or configuration. ### 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 or simply making references to the chat with Claude itself, leaking its chain of thoughts. 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, and that still working partially. ### Environment - Claude Code - Model: claude-opus-4-8, also verified on Opus 5 and Sonnet 5. ### What Claude Actually Did Contant verbose code commenting. ### Expected Behavior Restrained commenting as the **default** — comment only genuinely non-obvious constraint

Comments (0)

No comments yet. Start the discussion.

Comment on this issue