Documentation: Consolidate Disparate Claude Code Documentation into a Single Source of Truth

Resolved 💬 5 comments Opened Sep 4, 2025 by coygeek Closed Jan 17, 2026

Title: Documentation: Consolidate Disparate Claude Code Documentation into a Single Source of Truth

Labels: documentation, enhancement, suggestion

Overview

The Claude Code documentation is currently split across two different websites, which can be confusing for users and makes important information difficult to discover. This issue proposes consolidating all documentation into the official docs.anthropic.com site.

The Problem

There are two primary locations for Claude Code documentation:

  1. The Official Documentation: https://docs.anthropic.com/en/docs/claude-code/overview

This site appears to be the main, comprehensive technical documentation for the product.

  1. The Support/Help Center: https://support.anthropic.com/en/collections/14445694-claude-code

This site contains a collection of articles that are highly relevant but are not present in, or linked from, the official documentation.

The following 5 articles exist only on the support site:

  • Claude Code Model Configuration
  • Using Claude Code with your Pro or Max plan
  • Automated Security Reviews in Claude Code
  • Setting up Console single sign-on with Claude Code role auto-provisioning
  • Using Claude Code with your Team or Enterprise plan

Because these articles are separate, users who rely on the official documentation may miss crucial information related to model configuration, security, billing plans, and SSO setup.

Proposed Solution

I strongly suggest consolidating all documentation into the official docs.anthropic.com site.

  1. Migrate Content: Move the content from the 5 articles on support.anthropic.com into the appropriate sections of the official documentation.
  2. Deprecate Old Pages: Remove the "Claude Code" collection from the support site.
  3. Implement Redirects: Set up 301 redirects from the old support article URLs to their new locations in the official docs to ensure old links don't break.

Justification

  • Single Source of Truth: This creates a single, reliable place for all users to find information, eliminating confusion and ensuring they have access to the most up-to-date content.
  • Improved Discoverability: Important topics like plan-specific usage and SSO will be easily discoverable within the main documentation structure.
  • Better User Experience: Users won't have to hunt across multiple sites to piece together information.
  • Simplified Maintenance: It will be easier for the Anthropic team to maintain a single, unified set of documentation.

Suggested Migration Plan

Based on the titles of the support articles and the structure of the official docs, here is a suggested plan for where the content could be integrated:

| Support Article Title | Suggested Destination in docs.anthropic.com | Rationale |
| :--- | :--- | :--- |
| Claude Code Model Configuration | /en/docs/claude-code/model-config | This page already exists and is the perfect home for this content. The support article can be merged directly. |
| Using Claude Code with your Pro or Max/Team or Enterprise plan | A new /plans-and-billing page, or integrated into /setup and /costs. | This content is crucial for new users to understand usage limits and how billing works with different subscription tiers. |
| Automated Security Reviews in Claude Code | /en/docs/claude-code/security | The security page is the logical place for this. It could also be cross-linked from the /github-actions page. |
| Setting up Console single sign-on with Claude Code role auto-provisioning | /en/docs/claude-code/iam | This is a core Identity and Access Management topic and fits perfectly within the existing iam documentation. |

---

Thank you for your consideration. I believe this change would significantly improve the clarity and usability of the Claude Code documentation for all developers.

View original on GitHub ↗

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