Error: Failed to spawn Claude Code process: spawn claude ENOENT when using agent mode with Next.js

[brmdbr]

When following the Next.js setup instructions exactly as documented and trying to use agent mode, I get the following error:

Error: Failed to spawn Claude Code process: spawn claude ENOENT

Environment:

• Framework: Next.js
• Setup: Followed the official Next.js integration guide (added scripts to app/layout.tsx with the react-grab and @react-grab/claude-code global scripts)
• Dev command: npx @react-grab/claude-code@latest && next dev

Expected behavior:
Agent mode should connect to Claude Code CLI and allow elements to be grabbed and sent to the agent with instructions.

Actual behavior:
The process fails to spawn with an ENOENT error when attempting to use agent mode.

Steps to reproduce:

1. Set up Next.js project with react-grab according to documentation
2. Add the dev script: "dev": "npx @react-grab/claude-code@latest && next dev"
3. Run npm run dev
4. Attempt to use agent mode (grabbing elements) + sending instructions.

[tt-a1i]

This is the same root cause as #45 - on Windows, npm installs CLI tools as .cmd wrapper scripts, and Node's spawn() can't execute them directly without shell: true.

The tricky part is this specific error comes from inside @anthropic-ai/claude-agent-sdk, not react-grab itself:

// node_modules/@anthropic-ai/claude-agent-sdk
spawn("claude", args, { ... })  // fails on Windows

So this would need a fix upstream in Anthropic's SDK.

As a workaround, you could try installing Claude Code with bun instead of npm - bun downloads actual .exe files rather than .cmd wrappers, which sidesteps the issue entirely.

[brmdbr]

Wont this PR address this issue? #62

[tt-a1i]

Good question! Unfortunately no - PR #62 fixes @react-grab/cursor which uses cursor-agent, but this issue is about @react-grab/claude-code which uses claude.

The spawn call that's failing here is inside @anthropic-ai/claude-agent-sdk, not in react-grab's code directly. So it would need a similar fix but in Anthropic's SDK repo.