[DOCS] Code Review docs do not state that `ultra` uses cloud review in non-interactive sessions

Documentation Type

Unclear/confusing documentation

Documentation Location

https://code.claude.com/docs/en/code-review

Section/Topic

The “Review a diff locally” explanation of /code-review ultra availability and fallback behavior.

Current Documentation

The page currently says:

/code-review ultra --fix runs the deeper ultrareview in the cloud...

but then says:

When ultrareview is not available, /code-review ultra runs a local review in your session instead.

The page does not distinguish interactive sessions from non-interactive sessions.

What's Wrong or Missing?

Claude Code 2.1.218 fixed /code-review ultra in non-interactive sessions so it launches the cloud review instead of silently running a local review. The current unconditional fallback sentence can therefore lead CI and -p users to expect local behavior when the command is intended to use the cloud review path.

The documentation also does not explain how availability errors are surfaced when a non-interactive caller cannot use the cloud review, or how this differs from the interactive fallback described on the page.

Suggested Improvement

Split the availability guidance by execution mode. State that in interactive sessions, an unavailable ultrareview may fall back to a local review as documented, while in non-interactive sessions /code-review ultra launches the cloud review path and does not silently substitute a local review.

Add a -p or CI example and document the expected failure/exit behavior when authentication, provider availability, or usage-credit requirements prevent a cloud launch.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/code-review | /code-review ultra local/cloud behavior |
| https://code.claude.com/docs/en/ultrareview | Non-interactive claude ultrareview and cloud-review requirements |
| https://code.claude.com/docs/en/headless | Running slash commands and reviews from -p or CI |

Total scope: 3 pages should make the non-interactive execution contract explicit.

The behavior was changed in Claude Code v2.1.218.