Bug: SDK query() fails - pathToClaudeCodeExecutable not set in mapCliOptionsToSDK

[Neuro987]

Bug Description

When using claude-code-ui in SDK mode, the query() call from @anthropic-ai/claude-agent-sdk fails with:

ReferenceError: Claude Code executable not found at C:\Users\...\node_modules\@anthropic-ai\claude-agent-sdk\cli.js.
Is options.pathToClaudeCodeExecutable set?

Root Cause

In server/claude-sdk.js, the mapCliOptionsToSDK() function (around line 133) does not set pathToClaudeCodeExecutable in the sdkOptions object. The SDK then defaults to looking for cli.js within its own package directory (claude-agent-sdk/cli.js), which doesn't exist — the actual Claude Code executable is at @anthropic-ai/claude-code/cli.js.

This follows the same pattern as #221 (settingSources missing) and #329 (maxThinkingTokens missing) — mapCliOptionsToSDK is missing a required SDK option.

Suggested Fix

Add pathToClaudeCodeExecutable to mapCliOptionsToSDK() in server/claude-sdk.js:

function mapCliOptionsToSDK(options = {}) {
  const { sessionId, cwd, toolsSettings, permissionMode, images } = options;

  const sdkOptions = {};

  // Set Claude Code executable path
  sdkOptions.pathToClaudeCodeExecutable = process.env.CLAUDE_CLI_PATH || 'claude';

  // Map working directory
  // ... rest of function

This respects the existing CLAUDE_CLI_PATH environment variable (already documented in cli.js line 174) and falls back to the claude command on PATH.

Environment

• OS: Windows 10
• claude-code-ui: latest (npm @siteboon/claude-code-ui)
• claude-agent-sdk: bundled version in node_modules
• claude-code: globally installed via npm

Related Issues

• error： Failed to spawn Claude Code process: spawn node ENOENT #261 — same symptom (spawn ENOENT), likely same root cause
• [BUG] CLAUDE.md not loaded after SDK migration (commit 6dd303a) - Breaking multiple project workflow #221 — same pattern (missing SDK option in mapCliOptionsToSDK)
• Bug: Thinking Mode selection has no effect - maxThinkingTokens not passed to SDK #329 — same pattern (missing SDK option in mapCliOptionsToSDK)

[coderabbitai]

🔗 Related PRs

#208 - feat: Multiple features, improvements, and bug fixes [merged]
#347 - fix(macos): fix node-pty posix_spawnp error with postinstall script [merged]
#385 - fix: update Codex SDK and add GPT-5.3/GPT-5.2 Codex model IDs [merged]
#446 - chore: upgrade @anthropic-ai/claude-agent-sdk to version 0.2.59 and add model usage logging [merged]
#451 - fix(claude): correct project encoded path [merged]

---

📝 Issue Planner

_{Check the box below or use the @coderabbitai plan command to generate an implementation plan and prompts that you can use with your favorite coding assistant.}

• Create Plan

---

🧪 Issue enrichment is currently in open beta.

You can configure auto-planning by selecting labels in the issue_enrichment configuration.

To disable automatic issue enrichment, add the following to your .coderabbit.yaml:

issue_enrichment:
  auto_enrich:
    enabled: false

💬 Have feedback or questions? Drop into our discord!

[viper151]

thank you for reporting @Neuro987 . This has been fixed hence closing this issue