Back/Engineering/Claude/Claude
AdvancedEngineering

How to Build a $20 Physical AI 'Buddy' with Claude Code

Build a Bluetooth desk button that lights up when Claude needs permission, lets you approve the action physically, and celebrates successful runs. Claude Code handles the device protocol and firmware, even if hardware is new to you.

How to Build a $20 Physical AI 'Buddy' with Claude Code

Felix shows a small Wi-Fi and Bluetooth device with a screen, then connects it to Claude Desktop as a physical permission button.

Before you start

What you need

  • A programmable Bluetooth device with a screen and physical button
  • A USB cable and computer that can flash the device
  • Claude Code and Claude Desktop
  • The device model or board documentation

What you’ll make

A Bluetooth hardware buddy paired with Claude Desktop that displays permission requests and sends approval when you press its button.

Tools used

Step by step

The workflow

Follow the sequence once, then adapt the prompts, checks, and handoffs to your own setup.

5 steps

Step01

Acquire the Hardware

Choose a small programmable device with Bluetooth, a screen, and a physical button. Felix used an inexpensive self-contained device that also had Wi-Fi. Save the product page and board documentation so Claude Code can identify the chip, display, button pins, and flashing process.

Step02

Generate Code with a Descriptive Prompt

Connect the device by USB and open Claude Code in an empty project folder. Give it the board documentation and describe the full interaction: show a small Claude character, celebrate successful work, display permission requests, and send approval when the physical button is pressed. Ask Claude to create the firmware, build instructions, and flashing command.

Example prompt
I want Claude to live on this device. Use the attached board documentation to identify the display, button, and Bluetooth interface. Build firmware that shows a small Claude character, celebrates when a task succeeds, and displays Claude Desktop permission requests. When I press the physical button, send approval back over Bluetooth. Include the exact build and flashing commands for this board.
Step03

Enable Developer Mode in the Claude Desktop App

Open Claude Desktop and go to Help, then Troubleshooting. Enable Developer Mode and let the app restart. The Developer menu should appear in the system menu bar after the restart.

Step04

Connect the Hardware Buddy via Bluetooth

Open Developer, choose Open Hardware Buddy, and put the device into pairing mode. Select the device when it appears, confirm the passcode if prompted, and wait for Claude Desktop to report that the connection is active.

Step05

Use Your Physical Approval Button

Run a harmless task that requires permission, such as asking Claude to create a test file in a temporary folder. Confirm that the device lights up or makes a sound, shows the request, and lets the task continue only after you press the button.

What good looks like

  • Claude Desktop discovers and pairs with the device.
  • A permission request appears on the device with an audible or visual signal.
  • Pressing the hardware button allows the pending Claude action to continue.

Build your next product with ChatPRD

Turn an idea into a PRD, user stories, and a plan.

Try ChatPRD free

After the steps

Runbook notes

How to recover when the loop fails and where human judgment helps.

Recover

If it goes sideways

Claude Desktop cannot discover the device
Confirm the device is powered, Bluetooth is enabled, and the firmware is advertising. Restart the scan from Open Hardware Buddy after the device enters pairing mode.
The generated firmware does not compile or flash
Give Claude Code the exact board model, its documentation, the toolchain version, and the full compiler or flashing error. Ask it to revise the smallest failing part and rerun the command.
The device pairs but does not react to permission requests
Reconnect the device and inspect the Bluetooth event logs. Verify that the firmware listens for the event Claude Desktop sends and returns the expected approval response.

Start shipping
better products.

Join 100,000+ product managers who use ChatPRD to write better docs, align teams faster, and build products users love.

Free to start
No credit card
SOC 2 certified
Enterprise ready