cd /news/ai-agents/claude-s-code-comments-too-much-or-j… · home topics ai-agents article
[ARTICLE · art-76283] src=news.ycombinator.com ↗ pub= topic=ai-agents verified=true sentiment=· neutral

Claude's code comments – too much or just enough?

A Hacker News user reports that Anthropic's Claude AI assistant generates verbose code comments, prompting debate among engineers about whether the comments are excessive or useful. The user asks whether Claude's commenting style serves a purpose for future agent-driven code or is merely stylistic, noting that some engineers have instructed Claude to avoid comments unless strictly necessary.

read1 min views1 publishedJul 28, 2026

Has anyone else noticed that Claude leaves a lot of large code comments sprinkled throughout its work?

Some of my meat-based engineers have taken issue with it and directed Claude to never leave comments unless strictly necessary, but I want to know what others think. Personally, I write and read a lot of code comments so I’m confused about why these specific comments are so offensive to my fellow engineers.

I have two questions: 1. Why does it do this? 2. Do you have feelings about it?

Is the agent leaving breadcrumbs for other agents? Do they improve the output of future agent-driven code or is it just a stylistic choice?

I don’t want to devolve into a discussion about the purpose of code comments at-large. Instead I’m wondering if there’s a purpose behind the specific comments that agents leave

Comments URL: [https://news.ycombinator.com/item?id=49078710](https://news.ycombinator.com/item?id=49078710)

Points: 2

── more in #ai-agents 4 stories · sorted by recency
── more on @anthropic 3 stories trending now
sponsored brought to you by zahid.host 4,200+ EU-deployed projects
reading about agents? ship yours in a single git push.

Run your AI side-project on zahid.host

EU-based hosting, git-push deploys, automatic HTTPS, no cold starts. Free tier with a custom domain — perfect for shipping the agent you just read about.

$git push zahid main
Live at https://your-agent.zahid.host
Get free account → Pricing
from €0/mo · no card required
LIVE [news/claude-s-code-commen…] indexed:0 read:1min 2026-07-28 ·