[DOCS] Interactive mode missing repo-qualified syntax for clickable issue/PR references

Open 💬 6 comments Opened Mar 26, 2026 by coygeek

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/interactive-mode

Section/Topic

PR review status section, with a short note explaining how GitHub issue and PR references become clickable in Claude Code output

Current Documentation

The interactive mode page currently documents only the footer-specific PR link behavior:

When working on a branch with an open pull request, Claude Code displays a clickable PR link in the footer (for example, "PR #446"). The link has a colored underline indicating the review state: Cmd+click (Mac) or Ctrl+click (Windows/Linux) the link to open the pull request in your browser.

Related GitHub workflow examples also use bare-number PR prompts without explaining the clickable-link form:

Then work with GitHub: Review PR #456 and suggest improvements

and:

Once configured, ask Claude to use the tools (e.g., "Review PR #456").

No documentation currently explains which issue/PR reference syntax becomes clickable in Claude Code output.

What's Wrong or Missing?

Changelog v2.1.84 introduced a specific linkification rule for GitHub references:

Changed issue/PR references to only become clickable links when written as owner/repo#123 — bare #123 is no longer auto-linked

The docs do not explain this anywhere. Users reading the current UI and GitHub workflow pages cannot tell that:

A. Repo-qualified references are now the clickable form

If users want a clickable GitHub issue or PR reference in Claude Code output, they need to write it as owner/repo#<number>.

B. Bare `#<number>` references now stay plain text

The old shorthand no longer becomes a clickable link.

C. Current GitHub examples do not teach the clickable form

Examples like Review PR #456 are still reasonable prompts, but they do not tell users what syntax produces a clickable link in the UI.

Suggested Improvement

Add a short note in interactive-mode near the existing clickable PR/footer guidance, for example:

GitHub issue and pull request references in Claude Code output become clickable when written as owner/repo#<number>. Bare #<number> text is shown as plain text.

Then add the same note or a repo-qualified example to GitHub workflow pages such as mcp, vs-code, and ide-integrations so at least one GitHub integration example shows the supported clickable form.

Impact

Low - Minor confusion or inconvenience

Additional Context

Affected Pages:
| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/interactive-mode | Existing docs for clickable PR links in the footer; closest place to explain issue/PR link syntax |
| https://code.claude.com/docs/en/mcp | GitHub workflow example uses a bare PR #456 prompt with no note about repo-qualified clickable references |
| https://code.claude.com/docs/en/vs-code | Repeats the same GitHub MCP example in IDE docs |
| https://code.claude.com/docs/en/ide-integrations | Repeats the same GitHub MCP example in IDE docs |

Total scope: 4 pages affected

Source: Changelog v2.1.84

Exact changelog entry: