›_ Claude Code Issues
Claude Code Issues / #12482

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

Status Closed — not planned
Maintainer reply None cached
Activity 7 comments · opened Nov 26, 2025 · 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 ↗

7 Comments

Defiect · 10 months ago

Just happened to me as well. Transcript excerpt and system info are pasted below (edited to remove PII).

> How can I permanently switch the auth/login mode for Claude Code from Claude Pro to Azure AI Foundry (without setting env vars)? I need docs for Windows 11 and Linux. Also, I was provided these 3 endpoints asssociated with my Azure resource, which of these should be used?
https://[REDACTED_RESOURCE_ID].services.ai.azure.com/models
https://[REDACTED_RESOURCE_ID].openai.azure.com/
https://[REDACTED_RESOURCE_ID].cognitiveservices.azure.com/

∴ Thinking…	

  The user is asking for help with configuring Claude Code to use Azure AI Foundry instead of the default Claude Pro subscription. They want:
  1. Permanent configuration (not environment variables)
  2. Instructions for Windows 11 (current system)
  3. Instructions for Linux as well
  4. Help understanding which endpoint to use from the three Azure endpoints they provided

  Since they explicitly mentioned that I should look at the official Claude Code docs, I should use the Task tool with subagent_type='claude-code-guide' to get accurate information about:
  - How to configure Claude Code authentication
  - How to set up Azure AI Foundry as a provider
  - Where configuration files are stored on Windows vs Linux
  - Which endpoint format is correct for Azure

  This is a clear case where I need to look up official documentation rather than guessing.

● I'll look up the official Claude Code documentation to help you configure Azure AI Foundry as your authentication provider.

● claude-code-guide(Look up Azure AI Foundry config)
  ⎿  Prompt:
       The user wants to configure Claude Code to use Azure AI Foundry instead of Claude Pro subscription auth. They need:

       1. How to permanently configure Claude Code to use Azure AI Foundry (not environment variables)
       2. Which endpoint to use - they have three options from their Azure resource:
          - https://[REDACTED_RESOURCE_ID].services.ai.azure.com/models
          - https://[REDACTED_RESOURCE_ID].openai.azure.com/
          - https://[REDACTED_RESOURCE_ID].cognitiveservices.azure.com/
       3. Where the config file is located on Windows 11
       4. Where the config file is located on Linux
       5. The exact format/structure needed in the config file

       Please search the Claude Code documentation for information about:
       - Configuring authentication providers
       - Setting up Azure AI Foundry
       - Configuration file locations on different platforms
       - The correct endpoint format for Azure
       - How to specify which models to use (they mentioned opus 4.5, sonnet 4.5, haiku 4.5 deployments)

       Return the exact instructions and file paths they need.

     > The user wants to configure Claude Code to use Azure AI Foundry instead of Claude Pro subscription auth. They need:
     Fetch(url: "https://code.claude.com/docs/en/claude_code_docs_map.md", prompt: "Find documentation about Azure AI Foundry configuration, authentication providers, and config file
     I've reviewed the Claude Code documentation map, but I don't see any information about **Azure AI Foundry configuration** in the provided content.
     Fetch(url: "https://code.claude.com/docs/en/third-party-integrations.md", prompt: "What authentication providers and cloud integrations does Claude Code support? Is Azure AI Foundry
     # Claude Code Authentication & Cloud Support
     Fetch(url: "https://code.claude.com/docs/en/configuration.md", prompt: "How to configure Azure AI Foundry, Microsoft Foundry, or any authentication provider in Claude Code? What are
     Error: Request failed with status code 404
     Fetch(url: "https://code.claude.com/docs/en/authentication.md", prompt: "How to configure Azure AI Foundry authentication in Claude Code? What are the config file locations and
     Error: Request failed with status code 404
     Fetch(url: "https://code.claude.com/docs/en/azure-setup.md", prompt: "Complete instructions for setting up Azure AI Foundry with Claude Code, including config file location and
     Fetch(url: "https://code.claude.com/docs/en/llm-configuration.md", prompt: "How to configure LLM providers and Azure in Claude Code config files?")
     Fetch(url: "https://code.claude.com/docs/en/settings.md", prompt: "Configuration file location and format for different operating systems")
     Error: Request failed with status code 404
     Error: Request failed with status code 404
     # Claude Code Settings Configuration Locations
     Fetch(url: "https://code.claude.com/docs/en/network-config.md", prompt: "How to configure alternative LLM providers like Azure, including endpoints and API keys in Claude Code
     Fetch(url: "https://code.claude.com/docs/en/llms.md", prompt: "How to configure alternative LLM providers, model selection, and Azure endpoints")
     Fetch(url: "https://code.claude.com/docs/en/getting-started.md", prompt: "Initial setup and authentication configuration for alternative providers like Azure")
     Error: Request failed with status code 404
     Error: Request failed with status code 404
     Based on the provided content, I cannot answer your question about configuring alternative LLM providers like Azure in Claude Code settings.
     Fetch(url: "https://code.claude.com/docs/en/", prompt: "List all available documentation pages, especially those related to LLM configuration, authentication, and Azure setup")
     Fetch(url: "https://code.claude.com/docs/en/providers.md", prompt: "How to configure different LLM providers including Azure")
     Error: Request failed with status code 404
     Error: Request failed with status code 404
     Web Search("Claude Code Azure AI Foundry configuration settings.json")
     Fetch(url: "https://code.claude.com/docs/en/setup.md", prompt: "Configuration instructions for alternative authentication providers like Azure")
     Error: Permission to use WebSearch has been auto-denied in dontAsk mode.
     # Claude Code Setup Guide
     Fetch(url: "https://code.claude.com/docs/en/enterprise-integrations.md", prompt: "Complete configuration instructions for Microsoft Foundry/Azure AI Foundry including endpoint format
     Fetch(url: "https://code.claude.com/docs/en/bedrock.md", prompt: "Configuration format for alternative providers - this will show the general pattern used")
     Error: Request failed with status code 404
     Error: Request failed with status code 404
     Search(pattern: "https://code.claude.com/docs/en/*.md")
       ⎿  Found 0 files
  ⎿  Interrupted · What should Claude do instead?

Claude Model

Sonnet 4.5

Claude Code Version

2.0.55

Platform

Logged into a Claude.ai Pro subscription account

Operating System

Windows 11 (native installation of Claude Code)

Terminal/Shell

Windows Terminal (Preview)/CMD

mmarks13 · 10 months ago

I'm getting the same thing. Here is my console output:

 I'll help you investigate and plan the implementation of prompt and tool definition caching for your application. 
 Let me start by exploring the codebase and documentation.

● 2 agents finished (ctrl+o to expand)
   ├─ Explore (Explore LangChain agent implementation) · 4 tool uses · 20.5k tokens
   │  ⎿  Done
   └─ claude-code-guide (Research LangChain caching documentation) · 3 tool uses · 14.6k tokens
      ⎿  Done

● Fetch(https://docs.anthropic.com/en/docs/build-with-claude/prompt-caching)
  ⎿  Received 1021 bytes (301 Moved Permanently)

● Let me fetch the correct Claude API documentation and continue my research.

● Fetch(https://docs.claude.com/en/docs/build-with-claude/prompt-caching)
  ⎿  Received 1014 bytes (302 Found)

● Read(app/langchain_agent.py)
  ⎿  Read 100 lines

● Read(prompts/system_prompt.md)
  ⎿  Read 292 lines

● Fetch(https://platform.claude.com/docs/en/build-with-claude/prompt-caching)
  ⎿  Received 75.8KB (200 OK)
github-actions[bot] · 9 months ago

This issue has been inactive for 30 days. If the issue is still occurring, please comment to let us know. Otherwise, this issue will be automatically closed in 30 days for housekeeping purposes.

sjnims · 9 months ago

This is a legitimate bug that others have validated, do not close IMO

github-actions[bot] · 8 months ago

This issue has been automatically closed due to 60 days of inactivity. If you're still experiencing this issue, please open a new issue with updated information.

marcindulak · 8 months ago

This issue was closed incorrectly despite recent human comments. This behavior of the bot is reported at https://github.com/anthropics/claude-code/issues/16497. Please upvote that issue, so maybe it gets noticed.

github-actions[bot] · 7 months ago

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.

Related Claude Code issues

Matched on shared title terms, labels, topic and reported release — ranked so issues with real discussion come first.

Browse by topic

Same class of failure, ranked by community engagement — this issue is one of many, so it may not appear in the visible list: MCP server connection issues, Hooks & automation

Browse all Claude Code issue topics →