Paste the error.
Find the fix.
Troubleshoot Codex, Claude Code, MCP, and AI coding agents. Fix errors, validate configuration, and improve agent workflows.
Popular fixes
Start with the exact message, then confirm the environment and version.
Windows cannot find codex-windows-sandbox-setup.exe
Windows cannot find 'codex-windows-sandbox-setup.exe'AbsolutePathBuf deserialized without a base path on Windows
Error creating task Invalid request: AbsolutePathBuf deserialized without a base pathApp-server queued follow-up no longer exists
App-server queued follow-up no longer existsBrowse by agent
Narrow the troubleshooting library before changing configuration.
Diagnostics
Check the configuration and environment behind an agent failure.
MCP Config Validator
Check MCP JSON configuration syntax and common command, args, env, npx, and Windows path risks locally in your browser.
No configuration upload →AI coding agents · Local browser toolAgent PATH Inspector
Inspect a copied Windows, WSL, macOS, or Linux PATH for duplicates, empty entries, quoting, delimiter, and mixed-namespace risks.
No configuration upload →AI coding agents · Local browser toolWindows Command Resolver
Compare pasted where.exe and PowerShell Get-Command results to find stale shims, duplicate installs, and executable precedence conflicts.
No configuration upload →Codex · Local browser toolCodex Error Log Parser
Match pasted Codex logs to known exact-error branches and source-linked troubleshooting pages without uploading the log.
No configuration upload →Codex · Local browser toolTOML Path Escape Checker
Check Codex config.toml snippets for unsafe Windows backslashes, mixed WSL paths, duplicate keys, and unexpanded placeholders.
No configuration upload →Latest fixes
Recently checked troubleshooting notes from the current library.
Claude Code Playwright MCP fails after /c becomes C:/
Failed to reconnect to plugin:playwright:playwrightWindows setup didn't finish: helper_failed
Windows setup didn't finishCodex helper_unknown_error while applying deny-read ACLs
windows sandbox: helper_unknown_error: apply deny-read ACLsCreateProcessAsUserW failed: 1312 in the Codex Windows sandbox
windows sandbox: runner error: CreateProcessAsUserW failed: 1312MCP Filesystem disconnects when an allowed directory is missing
Error accessing directory ... ENOENT: no such file or directory, stat ...Claude Code WSL tries to create /mnt/c/Users/.claude
bwrap: Can't mkdir /mnt/c/Users/.claude: Permission deniedMCP Filesystem rejects a mapped drive but allows its UNC path
Access denied - path outside allowed directories: Y:\k8s not in \\server\share\gitCodex times out waiting for runner spawn_ready
windows sandbox: timed out after 15000ms waiting for runner spawn_readyClaude Desktop passes a literal ${VAR} to an MCP server
MCP server receives the literal string ${VAR}Codex bundled MCP fails with JSON-RPC error -32603
MCP startup failed: handshaking with MCP server failed: JSON-RPC error: -32603Codex Windows sandbox fails HTTPS with SEC_E_NO_CREDENTIALS
SEC_E_NO_CREDENTIALS (0x8009030e)Claude Code startup fails with ERR_SOCKET_CLOSED behind a proxy
Failed to connect to api.anthropic.com: ERR_SOCKET_CLOSEDaccount/read failed during TUI bootstrap
Error: account/read failed during TUI bootstrapCodex sandbox DPAPI error followed by setup error 0xc0000142
windows sandbox: CryptUnprotectData failed: 2148073483Codex Browser fails because browser-client is not trusted
privileged native pipe bridge is not available; browser-client is not trustedbwrap loopback Failed RTM_NEWADDR: Operation not permitted
bwrap: loopback: Failed RTM_NEWADDR: Operation not permittedClaude Desktop cancels MCP initialize after 60 seconds
Message from client: method="notifications/cancelled"bwrap cannot create the Codex synthetic mount directory in /tmp
bwrap: Can't mkdir /tmp/codex-bwrap-synthetic-mount-targets-1000: Read-only file systemCodex Windows sandbox fails with CreateProcessAsUserW error 5
windows sandbox: runner error: CreateProcessAsUserW failed: 5CoCreateInstance NetFwPolicy2 failed in Codex sandbox setup
helper_firewall_policy_access_failed: CoCreateInstance NetFwPolicy2 failed: HRESULT(0x80110474)idle timeout waiting for SSE hides response.failed
idle timeout waiting for SSECodex rewrites a WSL /mnt project path to a Windows drive
Project folder was deleted or movedCodex Remote Control WebSocket returns HTTP 503
failed to connect to app-server remote control websocketCodex Desktop SQLite pool times out during startup
Codex cannot access its local databaseconfigRequirements/read fails with No file descriptors available
configRequirements/read failed during TUI bootstrapMCP SSE stream disconnects with TypeError: terminated
SSE stream disconnected: TypeError: terminatedthread history projection expected ordinal N, got N-1
thread-store internal error: thread history projection ... expected ordinal 192591, got 192590 (code -32603)MCP fails to open an SSE stream with Not Found
StreamableHTTPError: Streamable HTTP error: Failed to open SSE stream: Not FoundCodex app-server initialize handshake times out in WSL mode
Codex app-server initialize handshake timed outCodex fatal error: HW capability requested
Fatal Error: HW capability found: 0x178BFBFF 0x7EF8320B, but HW capability requested: 0x200000 0x00.Claude Desktop MCP tools fail with side_channel_waiting_key_absent
side_channel_waiting_key_absentCodex config.toml missing escaped value on Windows
failed to reload config: missing escaped value, expected `b`, `e`, `f`, `n`, `r`, `\`, `"`, `x`, `u`, `U`Claude Code MCP spawn npx ENOENT on Windows
SPAWN ERROR: ENOENT spawn npx ENOENTCodex 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)MCP Filesystem rejects a Windows drive-letter case mismatch
Error: Access denied - path outside allowed directories: c:\Users\... not in C:\Users\...Skills
Practical instructions that make coding agents better at real troubleshooting work.
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- 01Exact error
- 02Environment + version
- 03Cause
- 04Safest fix
- 05Verify