[BUG] claude-code-guide agent tries non-existent documentation URLs (404 errors)

Resolved 💬 7 comments Opened Nov 26, 2025 by sjnims Closed Feb 8, 2026

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 claude-code-guide subagent attempts to fetch Claude Code documentation from URLs that return 404:

Meanwhile, https://code.claude.com/docs/en/settings.md works successfully.

What Should Happen?

Agent should only attempt URLs that exist, or gracefully handle 404s without trying known-bad paths.

Error Messages/Logs

⏺ claude-code-guide(Research settings.json options)
  ⎿  Prompt:
       Search the Claude Code documentation for all available settings.json configuration options. I need to know:

       1. All available top-level settings keys (not just permissions)
       2. Any configuration options for improving workflow efficiency
       3. Settings related to model selection, context management, hooks, MCP servers, and any experimental features

       Return a comprehensive list of all documented settings.json options with their purposes and example values.

     > Search the Claude Code documentation for all available settings.json configuration options. I need to know:
     Fetch(url: "https://code.claude.com/docs/en/claude_code_docs_map.md", prompt: "Find the URL for settings.json documentation and configuration options")
     Web Search("Claude Code settings.json configuration options")
     # Settings.json Documentation
     Did 1 search in 28s
     Fetch(url: "https://code.claude.com/docs/en/settings.md", prompt: "Extract all available settings.json configuration options, top-level keys, and their purposes with 
example
     # Claude Code settings.json Configuration Options
     Fetch(url: "https://code.claude.com/docs/en/settings.md", prompt: "Find information about context management, alwaysThinkingEnabled, experimental features, model 
selection
     Search(pattern: "alwaysThinkingEnabled|experimentalFeatures|context|thinking", type: "json", head_limit: 20)
       ⎿  Found 0 files
     # Claude Code Configuration Summary
     Read(file_path: "/Users/stevenims/.claude/settings.json")
     Fetch(url: "https://code.claude.com/docs/en/configuration.md", prompt: "Find all configuration options, model selection, context management, thinking mode, and 
experimental
     Read 163 lines
     Error: Request failed with status code 404
     Fetch(url: "https://code.claude.com/docs/en", prompt: "Find documentation index and pages about thinking mode, alwaysThinkingEnabled, and other advanced features")
     Web Search("Claude Code alwaysThinkingEnabled extended thinking feature")
     Error: Request failed with status code 404
     Did 1 search in 19s
     Fetch(url: "https://code.claude.com/docs/en/settings.md", prompt: "Extract complete documentation on sandbox settings, hooks configuration, MCP servers, marketplace
     # Claude Code Configuration Documentation Summary

Steps to Reproduce

  1. Ask Claude Code about settings.json configuration options
  2. Observe the claude-code-guide agent's WebFetch attempts
  3. Note 404 errors on the above URLs

Claude Model

Opus

Is this a regression?

I don't know

Last Working Version

_No response_

Claude Code Version

2.0.54

Platform

Anthropic API

Operating System

macOS

Terminal/Shell

Terminal.app (macOS)

Additional Information

_No response_

View original on GitHub ↗

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