Updated June 8, 2026
How do I review the changes Claude Code made?
Quick answer
Push the plan or diff as a Drafty canvas, comment on the exact lines, and Claude reads your comments and ships a new version. It's a review surface for work Claude Code does in the terminal — comment on a specific paragraph or code block instead of scrolling back through the chat.
To review the changes Claude Code made, push the plan or diff as a Drafty canvas, comment on the exact lines, and Claude reads your comments and ships a new version. It's a review surface for work Claude does in the terminal — you point at a specific paragraph or code block instead of describing it back in chat.
The loop is the same one you'd use for a doc review: read, mark up the parts you want changed, hand it back. The difference is that the thing you're marking up is what Claude just built, and the person picking up your notes is Claude.
The problem: reviewing AI work by scrolling a terminal is hard
When Claude Code writes a plan or a diff, it scrolls past in the chat. To push back on one line you have to quote it, describe where it is, and hope nothing gets lost. The longer the output, the worse this gets — by the time you've scrolled back up, you've forgotten the three other things you wanted to flag.
A canvas turns that output into a page you can read top to bottom and annotate in place.
Push the plan or diff as a canvas
Ask Claude to "drafty this," or push the file yourself:
- Save the plan, diff, or doc as an HTML or Markdown file.
- Run
drafty canvas push plan.md(pass--titleto name it). - Open the
drafty.im/canvas/<slug>link the CLI prints.
The link opens in any browser, including your phone, so you can read it away from the terminal.
Comment on the exact lines
On the canvas, click any element — a heading, a paragraph, a list item, or a code block — and leave a threaded comment pinned to that exact spot, Figma-style. Each note carries its own context, so you can drop five comments on five different lines without explaining where any of them go. The comment stays anchored to its element even after a new version is pushed.
Claude reads comments and revises (live mode)
Back in the terminal, Claude reads your comments with drafty comments inbox or drafty comments watch <slug>, then edits the file and pushes a new version. Every push is saved, so you can compare against earlier versions or roll one back.
By default a canvas is in feedback mode, where Claude waits for your go-ahead before acting. Switch to live mode to have Claude work on threads as they arrive:
drafty canvas mode <slug> live
That's the full loop — point at a line, hand it back, get a new version. See canvas modes for when to use each one, or grab the CLI to set up the review surface.
Frequently asked
- How does Claude see my comments?
- The Drafty CLI reads them. Run `drafty comments inbox` to pull open threads, or `drafty comments watch <slug>` to stream new ones as they land. Your comments stay anchored to the exact element you clicked, so Claude knows which line each one is about.
- Can Claude respond to comments automatically?
- It depends on the canvas mode. In feedback mode (the default) Claude waits for your go-ahead before acting on a thread. In live mode Claude works on comment threads as they arrive. Set the mode with `drafty canvas mode <slug> live`.
- What's the difference between feedback and live mode?
- Feedback mode lets viewers comment while Claude holds until you say go — good for a round of review before any changes. Live mode has Claude pick up threads as they come in. There's also read-only mode, where viewers can't comment at all.
- Do my comments survive a new version?
- Yes. Every push saves a new version, and a comment stays pinned to its element even after you push an update. You can preview and restore earlier versions with `drafty canvas versions` and `drafty canvas restore`.
Related
- How can I comment on an AI-generated document?To comment on an AI-generated document, publish it as a Drafty canvas, then click any element to pin a comment to that exact spot.
- Push and pull Drafty canvases from the CLI and Claude CodeUse the Drafty CLI to push a file to a canvas and pull comments back, so Claude and your reviewers stay on the same page.
- Drafty canvas modes: read-only, feedback, and liveCanvas modes control comments and Claude's role: read-only (no comments), feedback (the default), and live.
- GuideHow to Claude Code from your phoneRemote Control gives you the hands. Drafty gives you the eyes — and the memory.