[bugfix]

If you let it, Claude Code will write a comment for almost every single line of code.

[mikepurvis]

    # Assign value of x to y
    y = x

[ziml77]

Even if you try to get them to not, they will still overcomment the code. Or at least overcomment it from the perspective of a human. From the perspective of the LLM, I suspect the comments are necessary for it to be able to get the code output correct.

[theshrike79]

It's also a discoverability tool. If the code has good docstrings and decent naming for functions/variables it's a lot easier for the LLM to find the correct places to edit.