[BUG] Broken documentation links - incorrect redirects with double path ending
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:
- Security documentation link: https://docs.anthropic.com/s/claude-code-security
- General documentation link: https://docs.anthropic.com/s/claude-code (found in the repository description)
What Should Happen?
These links should redirect to the appropriate documentation pages.
Actual behavior:
- Both links redirect to https://docs.anthropic.com/en/home,/en/home which results in a malformed URL with a double path ending (/en/home,/en/home).
Error Messages/Logs
https://docs.anthropic.com/en/home,/en/home
Steps to Reproduce
- Open either of the affected links
- Observe the incorrect redirect URL in the browser address bar
- 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.
This issue has 4 comments on GitHub. Read the full discussion on GitHub ↗