Support

Product: Session Keys for Claude Code (Stream Deck plugin for Windows) · Provider: GRAMSHIFT (Tokyo, Japan)

Product page: Session Keys for Claude Code · Get it on the Elgato Marketplace

Ideas and bug reports

Email contact@gramshift.com in English or Japanese. Ideas for new features and bug reports are welcome, and every message is read; we do not guarantee a reply time. Please include your Windows version (Settings > System > About), your Stream Deck app version, your Claude Code version (claude --version), whether you use VS Code or a terminal, and a screenshot of the key's settings page (its Status line says what the plugin sees). Please do not send code or secrets from your projects.

Get started

Install Session Keys for Claude Code from the Elgato Marketplace.
In the Stream Deck app, find Session Keys for Claude Code in the action list. Drag Session onto as many keys as you want sessions, and add Next, Allow, Always, Deny and up to four Answer keys.
Click any of these keys and press Connect in its settings. The Status line says Connected.
Start a new Claude Code session, in VS Code or in a terminal. It appears on the first free Session key. Sessions that were already open appear after you restart them.

The actions

Session (key): one session and its state: working, needs you, waiting for your input, done or error. It shows how long, the size of its context in tokens (for example 84k, as Claude Code counts it) and the folder; while it works, the tool it uses. The frame blinks while a request waits. Press to bring its window to the front. Hold 1 second to take the session off the keys. Sessions take the keys in the order they started, row by row.
Next (key): goes to the session that has waited for you the longest; when nothing waits, to a session that finished. The key shows where it will go and how many wait.
Allow (key): allows the oldest waiting request once. The key shows the command or file and how many more wait.
Always (key): allows the request and adds the rule Claude Code offers for it (for example Bash: npm test for this project), the same as "Yes, and don't ask again". When Claude Code offers no rule, the key says so and does nothing.
Deny (key): refuses the request or the question. Claude is told the message you set on the key (empty = "The user denied this with a Stream Deck key."), so it can try another way. Or choose that Claude stops and waits for you.
Answer (key): option 1, 2, 3 or 4 of a question Claude asks; a press picks it. Questions that take several answers are answered in the app.
Look: Dark or Color, per key.

A press acts only on what the key shows: when the request changed just before the press, nothing is sent and the key shows a warning. You can always answer in Claude Code as usual.

Troubleshooting

What you see	What to do
No session appears on the keys	Open a key's settings and look at the Status line. If it says `Not connected`, press Connect. Then start a new session: sessions that were open before Connect appear after a restart.
`Claude Code's settings folder was not found`	Install Claude Code and start it once, so that `%USERPROFILE%\.claude` exists, then press Connect.
`Claude Code's settings file is not valid JSON`	Nothing was changed. Fix the file (the Status line shows where the error is), then press Connect.
`disableAllHooks` in the Status line	Your Claude Code settings turn all hooks off. Remove `"disableAllHooks": true` from the settings to use the keys.
`allowedHttpHookUrls` in the Status line	Your Claude Code settings allow hooks only to some addresses. Add the address the Status line shows (`http://127.0.0.1:…/*`) to that list.
`Another program uses port …`	Another program, or a second Stream Deck app, uses the port the plugin listens on. Close it; the plugin tries again every few seconds.
A press on a Session key does not bring its window	The Status line of the key says why. VS Code needs the folder name in its window title (the default). When two windows could be the session's, none is chosen. When Windows does not let the window come to the front, it flashes in the taskbar instead.
`the request on the key changed just before the press`	Nothing was sent. Look at the key and press again.
`Claude Code offered no rule for this request`	Use Allow, or answer in Claude Code.
`the Windows helper (Windows PowerShell) did not start`	Security software or a company policy that blocks PowerShell can stop the helper that brings windows to the front; allow it there.

Removing the plugin

Press Disconnect in any key's settings first: it takes the plugin's hooks out of Claude Code's settings file and leaves the rest of the file as it is. If you removed the plugin without Disconnect, Claude Code keeps working and asks in the app as usual, but it may show a hook error for a request, and each event still starts a short PowerShell command. Remove the entries that contain /agentkeys/v1/ from the hooks of the file, or put the plugin back and press Disconnect.

Compatibility

Windows 10 or later, with the Stream Deck app 6.9 or later and Claude Code. Tested on Windows 11 with Claude Code 2.1.305; Windows 10 has not been checked by us. Not for Mac. Windows: VS Code, VS Code Insiders, Cursor, Windsurf, Windows Terminal, PowerShell, cmd and other terminals. English and Japanese. Sessions run without a window (claude -p, the Agent SDK) are not shown, and their permission requests are left to Claude Code.

Session Keys for Claude Code is not made by or affiliated with Anthropic. Claude and Claude Code are trademarks of Anthropic. Privacy: Privacy Policy.