Summary
Anthropic moved the Claude Code documentation from docs.claude.com/en/docs/claude-code/<slug> to
code.claude.com/docs/en/<slug>. The old URLs currently 301-redirect, so nothing is broken yet
— but the repo should migrate while the redirect still works rather than after it is retired.
The bulk migration is already done: a repo-wide sweep finds 369 code.claude.com references
against 5 docs.claude.com stragglers, in 3 files.
docs/OFFICIAL-DOCS.md — this repo's canonical index of official pages — was checked and is
already fully migrated (51 code.claude.com hits, zero stale). No action needed there.
Stale instances
| path:line |
old URL |
disposition |
plugins/claude-ops/skills/known-issues/context/issue-templates.md:198 |
https://docs.claude.com/en/docs/claude-code |
rewrite → https://code.claude.com/docs/en/overview |
plugins/claude-ops/skills/known-issues/context/issue-templates.md:199 |
https://docs.claude.com/en/docs/claude-code/quickstart |
rewrite → https://code.claude.com/docs/en/quickstart |
plugins/claude-ops/skills/known-issues/context/issue-templates.md:200 |
https://docs.claude.com/en/docs/claude-code/troubleshooting |
rewrite → https://code.claude.com/docs/en/troubleshooting |
plugins/playbooks/skills/boris/reference/autonomy.md:78 |
https://docs.claude.com/en/docs/claude-code/settings |
rewrite → https://code.claude.com/docs/en/settings |
plugins/playbooks/skills/boris/vendor/SKILL.md:1129 |
https://docs.claude.com/en/docs/claude-code/settings |
do not touch — verbatim upstream baseline kept for drift detection; any edit manufactures false drift |
Verification
The path shape changes (/en/docs/claude-code/X → /docs/en/X), so a mechanical string swap is
not safe. Each rewritten URL was verified by fetching the old URL, observing the redirect, then
fetching the proposed target and confirming the topic:
/settings — old 301s to code.claude.com/docs/en/settings; target is "Claude Code settings".
/quickstart — old 301s to code.claude.com/docs/en/quickstart; target is "Quickstart".
/troubleshooting — old 301s to code.claude.com/docs/en/troubleshooting; target is
"Troubleshooting".
- The bare root
https://docs.claude.com/en/docs/claude-code does not map like the others:
it 302s to platform.claude.com/docs/en/claude-code, then 307s to code.claude.com/docs (the
bare docs root, a different host from the other three). code.claude.com/docs/en/overview is
therefore an inferred target rather than a redirect-verified one; it was fetched
independently and confirmed to be the real Overview page, and it matches the repo's dominant
/docs/en/<slug> convention.
Deferred
lychee.toml link-checks every markdown file including the vendored baseline, and its exclude
list has no claude.com entry. When Anthropic retires the 301, the weekly advisory link-check lane
will start filing a tracking issue for the vendored URL that cannot be fixed by editing the file.
The remedy is a lychee.toml exclude entry (or an exclude_path for the boris vendor/
directory) — but lychee.toml is a tool config materialized from melodic-software/standards, so
per AGENTS.md the fix belongs upstream, not as a local patch. Tracked here; not addressed in the
accompanying PR.
Summary
Anthropic moved the Claude Code documentation from
docs.claude.com/en/docs/claude-code/<slug>tocode.claude.com/docs/en/<slug>. The old URLs currently 301-redirect, so nothing is broken yet— but the repo should migrate while the redirect still works rather than after it is retired.
The bulk migration is already done: a repo-wide sweep finds 369
code.claude.comreferencesagainst 5
docs.claude.comstragglers, in 3 files.docs/OFFICIAL-DOCS.md— this repo's canonical index of official pages — was checked and isalready fully migrated (51
code.claude.comhits, zero stale). No action needed there.Stale instances
plugins/claude-ops/skills/known-issues/context/issue-templates.md:198https://docs.claude.com/en/docs/claude-codehttps://code.claude.com/docs/en/overviewplugins/claude-ops/skills/known-issues/context/issue-templates.md:199https://docs.claude.com/en/docs/claude-code/quickstarthttps://code.claude.com/docs/en/quickstartplugins/claude-ops/skills/known-issues/context/issue-templates.md:200https://docs.claude.com/en/docs/claude-code/troubleshootinghttps://code.claude.com/docs/en/troubleshootingplugins/playbooks/skills/boris/reference/autonomy.md:78https://docs.claude.com/en/docs/claude-code/settingshttps://code.claude.com/docs/en/settingsplugins/playbooks/skills/boris/vendor/SKILL.md:1129https://docs.claude.com/en/docs/claude-code/settingsVerification
The path shape changes (
/en/docs/claude-code/X→/docs/en/X), so a mechanical string swap isnot safe. Each rewritten URL was verified by fetching the old URL, observing the redirect, then
fetching the proposed target and confirming the topic:
/settings— old 301s tocode.claude.com/docs/en/settings; target is "Claude Code settings"./quickstart— old 301s tocode.claude.com/docs/en/quickstart; target is "Quickstart"./troubleshooting— old 301s tocode.claude.com/docs/en/troubleshooting; target is"Troubleshooting".
https://docs.claude.com/en/docs/claude-codedoes not map like the others:it 302s to
platform.claude.com/docs/en/claude-code, then 307s tocode.claude.com/docs(thebare docs root, a different host from the other three).
code.claude.com/docs/en/overviewistherefore an inferred target rather than a redirect-verified one; it was fetched
independently and confirmed to be the real Overview page, and it matches the repo's dominant
/docs/en/<slug>convention.Deferred
lychee.tomllink-checks every markdown file including the vendored baseline, and itsexcludelist has no claude.com entry. When Anthropic retires the 301, the weekly advisory link-check lane
will start filing a tracking issue for the vendored URL that cannot be fixed by editing the file.
The remedy is a
lychee.tomlexcludeentry (or anexclude_pathfor the borisvendor/directory) — but
lychee.tomlis a tool config materialized frommelodic-software/standards, soper
AGENTS.mdthe fix belongs upstream, not as a local patch. Tracked here; not addressed in theaccompanying PR.