[BUG] claude-code-guide Agent Cannot Access Documentation (HTTP 403)

Resolved 💬 2 comments Opened Dec 14, 2025 by gilesbateman Closed Dec 14, 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?

The built-in claude-code-guide agent fails to access Claude Code documentation due to HTTP 403 (Forbidden) errors, preventing users from getting help with Claude Code features and APIs.

What Should Happen?

The claude-code-guide agent should be able to access Claude Code documentation to answer questions about:

  • Claude Code features and capabilities
  • How to use specific features (hooks, slash commands, MCP servers)
  • Claude Agent SDK architecture and development
  • UI tips and shortcuts (like the "# to memorize" feature)

Error Messages/Logs

Agent reports: "I'm unable to access the official Claude Code documentation at this time due to access restrictions."
WebFetch returns HTTP 403 (Forbidden) for both documentation map URLs.

Steps to Reproduce

  1. Use the Task tool with subagent_type="claude-code-guide" to look up any Claude Code feature
  2. Agent attempts to access documentation via WebFetch
  3. Both documentation endpoints return HTTP 403 errors:
  • https://code.claude.com/docs/en/claude_code_docs_map.md - Status: 403
  • https://docs.claude.com/en/api/agent_sdk_docs_map.md - Status: 403

Claude Model

Sonnet (default)

Is this a regression?

I don't know

Last Working Version

_No response_

Claude Code Version

0.0.122

Platform

Anthropic API

Operating System

macOS

Terminal/Shell

VS Code integrated terminal

Additional Information

Example Use Case That Failed

I saw UI tip: "Use # to memorize shortcut to quickly add to CLAUDE.md"
When I asked about it, Claude attempted to look up this feature using claude-code-guide agent, but agent couldn't access documentation to provide answer.

Agent Response:

"I'm unable to access the official Claude Code documentation at this time due to access restrictions." "Both documentation resources are returning HTTP 403 (Forbidden) errors"

Impact

  • Users cannot get in-session help for Claude Code features
  • The claude-code-guide agent is effectively non-functional for its intended purpose
  • Users must leave Claude Code to access documentation in browser
  • Reduces discoverability of Claude Code features

Possible Fix

One or more of:

  1. Allow documentation access even when CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 is set (treat docs as essential)
  2. Provide authentication mechanism for WebFetch to access documentation endpoints
  3. Bundle documentation locally so claude-code-guide can access it offline
  4. Add alternative access method (e.g., local cache, different endpoint)
  5. Update documentation to explain workarounds if this is intended behavior

View original on GitHub ↗

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