[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
- Ask Claude Code about settings.json configuration options
- Observe the claude-code-guide agent's WebFetch attempts
- 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_
This issue has 7 comments on GitHub. Read the full discussion on GitHub ↗