Start Debugging

Tag: claude-code

83 posts · Page 6 of 9

2026-05-30 errors claude-code ai-agents

Fix: "Claude reached its tool-use limit for this turn"

This banner is a pause, not a failure. It maps to the API's pause_turn stop reason (default 10 server-tool iterations). Click Continue, or in code re-send the assistant response. Full fix here.

2026-05-28 dart flutter mcp

The Dart and Flutter MCP server: one command to give Claude Code your running Flutter app

Dart 3.12 ships dart mcp-server, the official MCP bridge into the Dart and Flutter toolchain. Register it once in Claude Code, Cursor, or Codex CLI and your agent gets hot reload, pub.dev search, and live widget introspection without copy-pasting a DTD URI.

2026-05-28 mcp claude-code ai-agents

Fix: HTTP MCP Server URL Won't Connect in Claude Desktop (stdio vs HTTP Transport)

Claude Desktop's claude_desktop_config.json only validates stdio servers. Drop a 'url' field in and it silently strips the entry, crashes on startup, or boots with zero tools. Use a custom connector for remote URLs and mcp-remote as a stdio bridge for local HTTP servers.

2026-05-26 ai-agents aider llm

How to Let Aider Edit Files Outside the Git Repository

Aider is git-first by default. To edit files outside the repo, pass them on the command line, use /read for reference docs, drop --no-git for unversioned dirs, or symlink. Five working patterns with exact flags.

2026-05-25 mcp claude-code ai-agents

How to Reduce the Number of MCP Tools Claude Loads to Avoid the Tool-Use Limit

Five MCP servers can burn 55k tokens and wreck tool-selection accuracy before Claude does any work. How to fix it in Claude Code 2.1.x with ENABLE_TOOL_SEARCH and alwaysLoad, on the raw API with the tool search tool and defer_loading, and on the MCP connector with mcp_toolset. Anchored to claude-opus-4-7, claude-sonnet-4-6, and the 20251119 tool search variants.

2026-05-23 errors mcp llm

Fix: Extra Inputs Are Not Permitted on a Tool Call With a Structured Argument

Your agent's tool call fails with Pydantic's 'Extra inputs are not permitted'. The model added a field your structured argument forbids. Turn on strict tool use so the grammar blocks it, relax the validator, or recover in the loop.

2026-05-22 mcp claude-code ai-agents

Fix: `ECONNREFUSED` When a Local MCP Server Starts Before the Client Is Ready

ECONNREFUSED from an MCP client means nothing was listening on that host:port yet. Fix the startup race, the localhost IPv4/IPv6 trap, and wrong-port mistakes for HTTP MCP servers.

2026-05-19 mcp claude-code ai-agents

Fix: Claude Code Reports `MCP server disconnected` Inside WSL

Why Claude Code shows 'MCP server disconnected' or 'Connection closed' for a working MCP server when launched from WSL2. Covers stdio spawning across the Windows/Linux boundary, npx and node ENOENT, mirrored networking for HTTP servers, VMMem reaping, and how to diagnose the right one with claude --debug.

2026-05-18 errors ai-agents llm

Fix: rate_limit_error on Claude Sonnet 4.6 in a Long Agent Loop

A 429 rate_limit_error on claude-sonnet-4-6 in a long agent loop is almost always ITPM, not RPM. Read retry-after, cache the system prompt, and gate on anthropic-ratelimit-input-tokens-remaining. Step-by-step fix with code.

2026-05-17 errors ai-agents llm

Fix: Context Window Exceeded During an Aider Refactor

Aider 0.86 hit the token limit mid-refactor. The fix is /clear, /drop, --map-tokens, and switching to architect mode with Claude Sonnet 4.6's 1M window. Step-by-step repro, error breakdown, and config.