[BUG] Broken documentation links - incorrect redirects with double path ending

Resolved 💬 4 comments Opened Sep 15, 2025 by s111s Closed Nov 19, 2025

Preflight Checklist

  • [x] I have searched existing issues and this hasn't been reported yet
  • [x] This is a single bug report (please file separate reports for different bugs)
  • [x] I am using the latest version of Claude Code

What's Wrong?

I encountered broken documentation links when starting to use Claude Code. The links appear to use a shortlink mechanism that's malfunctioning, causing incorrect redirects.

Links affected:

What Should Happen?

These links should redirect to the appropriate documentation pages.

Actual behavior:

Error Messages/Logs

https://docs.anthropic.com/en/home,/en/home

Steps to Reproduce

  1. Open either of the affected links
  2. Observe the incorrect redirect URL in the browser address bar
  3. Note that the page likely fails to load due to the malformed URL

Claude Model

Sonnet (default)

Is this a regression?

I don't know

Last Working Version

1.0.113

Claude Code Version

1.0.113

Platform

Anthropic API

Operating System

macOS

Terminal/Shell

Terminal.app (macOS)

Additional Information

Impact:

  • New users cannot access security documentation when getting started
  • Repository visitors cannot access the main documentation from the repo description
  • Creates a poor first-time user experience

Suggested fix:

  • The shortlink redirect mechanism needs to be corrected to prevent the path duplication issue.

First-time user experience impact:
As a new Claude Code user, encountering these broken links immediately upon getting started created a frustrating onboarding experience. Here's what happened:

  • Initial setup concerns: When first using Claude Code, I naturally wanted to understand the security implications and best practices. The broken security documentation link (https://docs.anthropic.com/s/claude-code-security) was particularly concerning since security is a critical consideration when integrating AI tools into development workflows.
  • Lost confidence: Broken links in official documentation and repository descriptions raise questions about the overall quality and maintenance of the tool. As a developer evaluating whether to adopt Claude Code, functional documentation links are a basic expectation.
  • Workflow disruption: Instead of focusing on learning and using the tool, I had to spend time troubleshooting why the links weren't working, searching for alternative ways to access the documentation, and ultimately reporting this issue.
  • Barrier to adoption: For developers who are cautious about new tools (especially AI-powered ones), broken documentation links can be a red flag that might cause them to abandon the tool before giving it a proper evaluation.

The irony is that Claude Code appears to be a well-designed tool, but these broken links create an unnecessarily poor first impression that doesn't reflect the actual quality of the product.

Suggestion: Consider implementing automated link checking in your CI/CD pipeline to catch these issues before they affect user experience.

View original on GitHub ↗

This issue has 4 comments on GitHub. Read the full discussion on GitHub ↗