Skip to content

docs: migrate remaining docs.claude.com URLs to code.claude.com #1564

Description

@kyle-sexton

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions