[DOCS] 25+ stale documentation URLs reference old domains across repository

[miraexhoi]

Documentation Type

Incorrect/outdated documentation

Documentation Location

No response

Section/Topic

Documentation URLs referencing migrated domains (docs.anthropic.com and docs.claude.com)

Current Documentation

The repository contains 25+ URLs pointing to old domains.

For example:

examples/hooks/bash_command_validator_example.py:9

Read more about hooks here: https://docs.anthropic.com/en/docs/claude-code/hooks

plugins/README.md:75

Claude Code Documentation

.github/ISSUE_TEMPLATE/config.yml:7

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

Full list of affected files:

docs.anthropic.com (2 files):

• examples/hooks/bash_command_validator_example.py:9
• .github/ISSUE_TEMPLATE/documentation.yml:35

docs.claude.com (20+ occurrences across 11 files):

• plugins/README.md (lines 9, 45, 75, 76, 77)
• .github/ISSUE_TEMPLATE/config.yml (lines 7, 10, 13)
• plugins/plugin-dev/skills/hook-development/SKILL.md:693
• plugins/plugin-dev/skills/mcp-integration/SKILL.md:536
• plugins/agent-sdk-dev/README.md (lines 168-171)
• plugins/agent-sdk-dev/commands/new-sdk-app.md (lines 12, 14, 15, 150, 151)
• plugins/agent-sdk-dev/agents/agent-sdk-verifier-ts.md:97
• plugins/agent-sdk-dev/agents/agent-sdk-verifier-py.md:91
• plugins/explanatory-output-style/README.md (lines 60, 71)
• plugins/learning-output-style/README.md:89

Additionally, plugins/README.md:35 still recommends the deprecated
npm install -g @anthropic-ai/claude-code, contradicting the main README.md.

What's Wrong or Missing?

All Claude Code documentation has been migrated to code.claude.com/docs,
but these files still reference old domains. The old URLs currently return
301 redirects, but should be updated to canonical URLs for:

• Faster page loads (no redirect hops)
• Future-proofing (redirects may be removed)
• Consistency with the rest of the codebase

URL mapping:

• docs.anthropic.com/en/docs/claude-code/ → code.claude.com/docs/en/
• docs.claude.com/en/docs/claude-code/ → code.claude.com/docs/en/
• docs.claude.com/en/api/agent-sdk/ → platform.claude.com/docs/en/agent-sdk/

Suggested Improvement

1. Replace all docs.anthropic.com and docs.claude.com URLs with
   their code.claude.com/docs equivalents
2. Update plugins/README.md installation instructions from deprecated
   npm to the native install method
3. Verify each replacement URL resolves correctly

Impact

Low - Minor confusion or inconvenience

Additional Context

Verified with curl that all old URLs return 301 to the new domain:

$ curl -sI https://docs.anthropic.com/en/docs/claude-code/hooks
HTTP/2 301 → https://code.claude.com/docs/en/hooks

$ curl -sI https://docs.claude.com/en/docs/claude-code/overview
HTTP/2 301 → https://code.claude.com/docs/en/overview

[mvanhorn]

I've submitted a fix for this in PR #32753. Replaces all stale docs.anthropic.com and docs.claude.com URLs with code.claude.com across 12 files.

[github-actions]

Closing for now — inactive for too long. Please open a new issue if this is still relevant.

[github-actions]

This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.