[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.
4 Comments
The security documentation URL has been updated and will be included in the next release of Claude Code. This partially addresses this issue by fixing the documentation link.
Have also pinged someone with the right perms to fix the GitHub link
Both issues fixed! Thanks for reporting 🙌
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.