[Agent Client Protocol] Claude Code not Responding
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 7.8k
- Forks
- 6.9k
- Avg merge
- 2d 6h
- Merged PRs (30d)
- 442
Description
Extension
https://www.raycast.com/Yukai/agent-client-protocol
Raycast Version
1.104.23
OS Version
MacOS 26.5.2 (25F84)
Description
I configured the Claude Code Agent so the connection worked. Then I tried to send a message and the Agent did not respond, and an error message was shown. Then I looked into the logs and there seems to be a protocol error when calling the acp agent.
Steps To Reproduce
- Install the Claude ACP Proxy
The official npm package changed its name, so I installed theclaude-agent-acppackage using the following command:
npm i -g @agentclientprotocol/claude-agent-acp - Configure the Agent in Raycast
I changed the command to:claude-agent-acp
I also added the installation path of the acp proxy using the Additional PATH Directories. Looks like this:/Users/<user>/.nvm/versions/node/v24.18.0/bin/
The Test Agent Connection Command worked and resulted in a working connection - Testing the Agent
I opened the Ask the Agent window and sent a message. Then there was an error while sending the message to the agent. The console log:
Tap to open Logs
20:08:20 [2026-07-26T20:08:20.498Z] [INFO] [SessionService] Creating new session { agentConnectionId: 'conn_1785096500376_3cerj7imv', promptLength: 5 }
20:08:20 [2026-07-26T20:08:20.498Z] [INFO] [ACPClient] Creating ACP session {
cwd: '/Users/torbenkeller/Documents/knowledgebase',
mcpServersCount: 0,
mode: undefined
}
20:08:21 [2026-07-26T20:08:21.041Z] [INFO] [ACPClient] ACP newSession response received {
response: '{\n' +
' "sessionId": "942594a6-ce6b-45ff-b3e4-a66bcfb3e0d9",\n' +
' "modes": {\n' +
' "currentModeId": "default",\n' +
' "availableModes": [\n' +
' {\n' +
' "id": "auto",\n' +
' "name": "Auto",\n' +
' "description": "Use a model classifier to approve/deny permission prompts"\n' +
' },\n' +
' {\n' +
' "id": "default",\n' +
' "name": "Manual",\n' +
' "description": "Standard behavior, prompts for dangerous operations"\n' +
' },\n' +
' {\n' +
' "id": "acceptEdits",\n' +
' "name": "Accept Edits",\n' +
' "description": "Auto-accept file edit operations"\n' +
' },\n' +
' {\n' +
' "id": "plan",\n' +
' "name": "Plan Mode",\n' +
' "description": "Planning mode, no actual tool execution"\n' +
' <…>
20:08:21 [2026-07-26T20:08:21.041Z] [INFO] [ACPClient] Sending prompt to agent {
sessionId: '942594a6-ce6b-45ff-b3e4-a66bcfb3e0d9',
promptLength: 5,
promptPreview: 'Hallo'
}
20:08:21 [2026-07-26T20:08:21.044Z] [DEBUG] [ACPClient] ACP session update received from agent {
sessionId: '942594a6-ce6b-45ff-b3e4-a66bcfb3e0d9',
updateType: 'available_commands_update',
fullUpdate: '{\n' +
' "sessionId": "942594a6-ce6b-45ff-b3e4-a66bcfb3e0d9",\n' +
' "update": {\n' +
' "availableCommands": [\n' +
' {\n' +
` "description": "Capture inbound thoughts, learnings, insights, summaries, quotes, or external sources (articles, YouTube videos, books, papers) into Torben's Obsidian knowledge vault. Use proactively when an inbound message looks like something worth saving — a thought, a learning, a reference, a key takeaway. Skip for casual conversation, questions, or task instructions. (project)",\n` +
' "input": null,\n' +
' "name": "capture"\n' +
' },\n' +
' {\n' +
' "description": "Deep research harness — fan-out web searches, fetch sources, adversarially verify claims, synthesize a cited report. (dyn<…>
20:08:21 [2026-07-26T20:08:21.045Z] [DEBUG] [SessionService] Session update received {
sessionId: '942594a6-ce6b-45ff-b3e4-a66bcfb3e0d9',
updateType: 'available_commands_update',
updateData: '{\n' +
' "availableCommands": [\n' +
' {\n' +
` "description": "Capture inbound thoughts, learnings, insights, summaries, quotes, or external sources (articles, YouTube videos, books, papers) into Torben's Obsidian knowledge vault. Use proactively when an inbound message looks like something worth saving — a thought, a learning, a reference, a key takeaway. Skip for casual conversation, questions, or task instructions. (project)",\n` +
' "input": null,\n' +
' "name": "capture"\n' +
' },\n' +
' {\n' +
' "description": "Deep research harness — fan-out web searches, fetch sources, adversarially verify claims, synthesize a cited report. (dynamic workflow)",\n' +
' "input": null,\n' +
' "name": "deep-research"\n' +
' },\n' +
'<…>
20:08:21 [2026-07-26T20:08:21.046Z] [WARN] [SessionService] Session not found for update {
sessionId: '942594a6-ce6b-45ff-b3e4-a66bcfb3e0d9',
updateType: 'available_commands_update'
}
20:08:21 [2026-07-26T20:08:21.047Z] [DEBUG] [SessionService] Available sessions when update failed {
requestedSessionId: '942594a6-ce6b-45ff-b3e4-a66bcfb3e0d9',
availableSessions: []
}
20:08:21 [2026-07-26T20:08:21.047Z] [INFO] [SessionService] Buffering session update for later processing {
agentSessionId: '942594a6-ce6b-45ff-b3e4-a66bcfb3e0d9',
updateType: 'available_commands_update'
}
20:08:21 [2026-07-26T20:08:21.086Z] [ERROR] [ACPClient] Failed to send prompt {
sessionId: '942594a6-ce6b-45ff-b3e4-a66bcfb3e0d9',
error: '[object Object]',
stack: undefined
}
20:08:21 [2026-07-26T20:08:21.086Z] [ERROR] [SessionService] Failed to create ACP session {
sessionId: '0c9b8b7b-ed7e-4c61-ac6a-54d6240d898f',
agentConnectionId: 'conn_1785096500376_3cerj7imv',
error: {
code: 'PROTOCOL_ERROR',
message: 'Failed to send prompt: Unknown error',
details: '{\n' +
' "sessionId": "942594a6-ce6b-45ff-b3e4-a66bcfb3e0d9",\n' +
' "prompt": "Hallo",\n' +
' "originalError": {\n' +
' "code": -32000,\n' +
' "message": "Authentication required"\n' +
' }\n' +
'}',
timestamp: 2026-07-26T20:08:21.086Z,
context: {
sessionId: '942594a6-ce6b-45ff-b3e4-a66bcfb3e0d9',
prompt: 'Hallo',
originalError: [Object]
}
}
}
20:08:21 [2026-07-26T20:08:21.086Z] [INFO] [Performance] Performance: createSession-conn_1785096500376_3cerj7imv took 588ms {
success: false,
error: 'Failed to create session with agent',
duration: 588
}
20:08:21 [ACP Error] PROTOCOL_ERROR: Failed to create session with agent {
code: 'PROTOCOL_ERROR',
message: 'Failed to create session with agent',
details: 'Unknown ACP error',
timestamp: 2026-07-26T20:08:21.086Z,
context: 'Starting chat session'
}
20:08:21 Error stack: Unknown ACP error
20:08:21 Error context: {
sessionId: '0c9b8b7b-ed7e-4c61-ac6a-54d6240d898f',
agentConnectionId: 'conn_1785096500376_3cerj7imv'
}
20:08:21 Error handling notification {
jsonrpc: '2.0',
method: 'session/update',
params: {
sessionId: '942594a6-ce6b-45ff-b3e4-a66bcfb3e0d9',
update: {
sessionUpdate: 'usage_update',
used: 0,
size: 1000000,
cost: [Object],
_meta: [Object]
}
}
} {
code: -32602,
message: 'Invalid params',
data: {
_errors: [],
update: {
_errors: [],
content: [Object],
sessionUpdate: [Object],
title: [Object],
toolCallId: [Object],
entries: [Object],
availableCommands: [Object],
currentModeId: [Object]
}
}
}
Current Behaviour
The Agent does not respond and throws an error
Expected Behaviour
The Agent should respond and the connection should work
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reproducing the failure with the Claude ACP Proxy using the reported Raycast configuration and inspect the ACPClient and SessionService logs. Trace the authentication-required prompt error and the session/update handling; done means a prompt receives a response without protocol or invalid-params errors.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- node.js, typescript
- Domain
- api, backend
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 52/100