AgentFixFind a fix

Paste the error.
Find the fix.

Troubleshoot Codex, Claude Code, MCP, and AI coding agents. Fix errors, validate configuration, and improve agent workflows.

Start with the exact message, then confirm the environment and version.

View all fixes

Latest fixes

Recently checked troubleshooting notes from the current library.

Claude CodeConfirmed workaround

Claude Code Playwright MCP fails after /c becomes C:/

Failed to reconnect to plugin:playwright:playwright
CodexPartial workaround

Windows setup didn't finish: helper_failed

Windows setup didn't finish
CodexPartial workaround

Codex helper_unknown_error while applying deny-read ACLs

windows sandbox: helper_unknown_error: apply deny-read ACLs
CodexOpen issue

CreateProcessAsUserW failed: 1312 in the Codex Windows sandbox

windows sandbox: runner error: CreateProcessAsUserW failed: 1312
MCPConfirmed workaround

MCP Filesystem disconnects when an allowed directory is missing

Error accessing directory ... ENOENT: no such file or directory, stat ...
Claude CodeOpen issue

Claude Code WSL tries to create /mnt/c/Users/.claude

bwrap: Can't mkdir /mnt/c/Users/.claude: Permission denied
MCPConfirmed workaround

MCP Filesystem rejects a mapped drive but allows its UNC path

Access denied - path outside allowed directories: Y:\k8s not in \\server\share\git
CodexOpen issue

Codex times out waiting for runner spawn_ready

windows sandbox: timed out after 15000ms waiting for runner spawn_ready
Claude CodePartial workaround

Claude Desktop passes a literal ${VAR} to an MCP server

MCP server receives the literal string ${VAR}
CodexPartial workaround

Codex bundled MCP fails with JSON-RPC error -32603

MCP startup failed: handshaking with MCP server failed: JSON-RPC error: -32603
CodexOpen issue

Codex Windows sandbox fails HTTPS with SEC_E_NO_CREDENTIALS

SEC_E_NO_CREDENTIALS (0x8009030e)
Claude CodePartial workaround

Claude Code startup fails with ERR_SOCKET_CLOSED behind a proxy

Failed to connect to api.anthropic.com: ERR_SOCKET_CLOSED
CodexPartial workaround

account/read failed during TUI bootstrap

Error: account/read failed during TUI bootstrap
CodexOpen issue

Codex sandbox DPAPI error followed by setup error 0xc0000142

windows sandbox: CryptUnprotectData failed: 2148073483
CodexPartial workaround

Codex Browser fails because browser-client is not trusted

privileged native pipe bridge is not available; browser-client is not trusted
CodexConfirmed workaround

bwrap loopback Failed RTM_NEWADDR: Operation not permitted

bwrap: loopback: Failed RTM_NEWADDR: Operation not permitted
Claude CodePartial workaround

Claude Desktop cancels MCP initialize after 60 seconds

Message from client: method="notifications/cancelled"
CodexPartial workaround

bwrap cannot create the Codex synthetic mount directory in /tmp

bwrap: Can't mkdir /tmp/codex-bwrap-synthetic-mount-targets-1000: Read-only file system
CodexOpen issue

Codex Windows sandbox fails with CreateProcessAsUserW error 5

windows sandbox: runner error: CreateProcessAsUserW failed: 5
CodexOpen issue

CoCreateInstance NetFwPolicy2 failed in Codex sandbox setup

helper_firewall_policy_access_failed: CoCreateInstance NetFwPolicy2 failed: HRESULT(0x80110474)
CodexOpen issue

idle timeout waiting for SSE hides response.failed

idle timeout waiting for SSE
CodexPartial workaround

Codex rewrites a WSL /mnt project path to a Windows drive

Project folder was deleted or moved
CodexOpen issue

Codex Remote Control WebSocket returns HTTP 503

failed to connect to app-server remote control websocket
CodexConfirmed workaround

Codex Desktop SQLite pool times out during startup

Codex cannot access its local database
CodexPartial workaround

configRequirements/read fails with No file descriptors available

configRequirements/read failed during TUI bootstrap
MCPOpen issue

MCP SSE stream disconnects with TypeError: terminated

SSE stream disconnected: TypeError: terminated
CodexOpen issue

thread history projection expected ordinal N, got N-1

thread-store internal error: thread history projection ... expected ordinal 192591, got 192590 (code -32603)
MCPPartial workaround

MCP fails to open an SSE stream with Not Found

StreamableHTTPError: Streamable HTTP error: Failed to open SSE stream: Not Found
CodexPartial workaround

Codex app-server initialize handshake times out in WSL mode

Codex app-server initialize handshake timed out
CodexPartial workaround

Codex fatal error: HW capability requested

Fatal Error: HW capability found: 0x178BFBFF 0x7EF8320B, but HW capability requested: 0x200000 0x00.
Claude CodeOpen issue

Claude Desktop MCP tools fail with side_channel_waiting_key_absent

side_channel_waiting_key_absent
CodexConfirmed workaround

Codex config.toml missing escaped value on Windows

failed to reload config: missing escaped value, expected `b`, `e`, `f`, `n`, `r`, `\`, `"`, `x`, `u`, `U`
Claude CodeConfirmed workaround

Claude Code MCP spawn npx ENOENT on Windows

SPAWN ERROR: ENOENT spawn npx ENOENT
CodexPartial workaround

Codex Linux sandbox helper ENOENT in WSL

Unable to spawn codex-linux-sandbox because it doesn't exist on the filesystem (ENOENT: No such file or directory)
MCPPartial workaround

MCP Filesystem rejects a Windows drive-letter case mismatch

Error: Access denied - path outside allowed directories: c:\Users\... not in C:\Users\...

How AgentFix verifies fixes

We label fixes as Confirmed, Partial or Open instead of pretending every error has a permanent solution.

Read how we verify
  1. 01Exact error
  2. 02Environment + version
  3. 03Cause
  4. 04Safest fix
  5. 05Verify