Skip to the content
2 layers159 × 102 mmClaude Micro, the printed circuit board in 3D

A 13-key agent macropad on clear MX switches: six frosted status keys, seven command keys, a rotary reasoning dial, a planar joystick, a five-pad capacitive touch strip and a 19-LED RGB chain.

Size
159 × 102 mm
Copper layers
2
Thickness
1.6 mm
Parts
95
Nets
68
Pads
314
Tracks, vias
624, 131
Pours
2
Routed
Yes
KiCad
KiCad 7 (file 20221018)
Created
28 Jul 2026
Updated
30 Jul 2026

Overview

Claude Micro is an open-source printed circuit board by Alexpoopy1, from the Alexpoopy1/Claude-Micro repository on GitHub. It is a 2-layer board of 159 × 102 mm with 95 parts on 68 nets, routed with 624 tracks and 131 vias.

It is built around the 74LVC1G17Z, 1N4148W and SK6812MINI-E. Its parts include 33 diodes, 27 capacitors, 13 switches, 10 resistors and 1 IC. It belongs with the keyboards and input boards and the RP2040 boards of this library.

Main components

3

README

README.md

Claude Micro

A 13-key agent macropad on clear MX switches: six frosted status keys, seven command keys, a rotary reasoning dial, a planar joystick, a five-pad capacitive touch strip and a 19-LED RGB chain. Fully printable, fully routed, fully checked.

Design study of the Work Louder × OpenAI Codex Micro — same feature set (13 switches, 1 encoder, 1 planar joystick, 1 touch sensor, 6 agent keys), rebuilt from scratch as open hardware with the Claude mark on the front.

text
make            # build everything, then verify it
open build/claude-micro.html

Deploying to Vercel serves the same file: vercel.json runs the STL, PCB and HTML build steps and publishes build/ as the site, with / rewritten to claude-micro.html. No framework, no Node build — just the Python tooling above, so the deployed page is always generated fresh from config/device.json rather than a stale checked-in copy.

What you get

OutputWhereWhat it is
Interactive viewerbuild/claude-micro.htmlOne self-contained file: WebGL model with an exploded-view slider, PCB layer viewer, schematic, BOM, print guide, firmware reference and the full check report. No network, no CDN.
Printable partsbuild/stl/*.stl9 parts, 22 pieces, ~88 g of filament. Every one proven watertight before it is written.
PCBbuild/pcb/claude-micro.kicad_pcbOpen in KiCad 7/8. Placed, routed, poured, zoned. Also .kicad_sch, .kicad_pro, .net.
EasyEDA schematicbuild/pcb/claude-micro-easyeda.jsonmake easyeda. Opens in EasyEDA (File → Open → EasyEDA) and imports into EasyEDA Pro via File → Import → EasyEDA Standard — for publishing to OSHWLab or ordering through JLCPCB.
Fabricationbuild/pcb/gerbers/RS-274X gerbers for all nine layers plus separate plated and non-plated Excellon drill files. Upload as-is.
Assemblybuild/pcb/bom.csv, positions.csv18 BOM lines, 89 components, pick-and-place positions.
Firmwarefirmware/qmk/claude_micro/Drop-in QMK keyboard folder.
Reportsbuild/pcb/drc_report.json, build/stl_report.jsonMachine-readable results of every check.

Hardware

Keys13 × clear-housing MX switches, 5-pin PCB mount, on a 19.05 mm grid — 6 agent, 7 command
DialEC11E rotary encoder with push, on a 26 mm knurled knob
Joystick20 mm 2-axis analog thumbstick into ADC0/ADC1, click on its own pin
Touch5-pad strip read by RC charge time — no touch controller
RGB19 × SK6812 (13 per-key + 6 underglow), 5 V through a 74LVC1G17 buffer
MCURP2040 module, Raspberry Pi Pico form factor (USB-C variant recommended)
Board159 × 102 mm, 2 layer, 1.6 mm, 0.2 mm rules
Case165 × 108 × 19.5 mm printed two-piece, 6° tilt feet

Agent keys

The six frosted keys mirror six host threads. The host pushes state over raw HID and the board renders it:

StateColour
idlewhitenothing running
thinkingblue, breathingmodel is reasoning
runninglight blue, breathingtools are executing
waitingamberneeds your input
donegreenfinished cleanly
errorredfailed

If the host goes quiet for 30 s every key falls back to idle, so a crashed bridge never leaves stale status on the desk.

The dial

Turning it walks reasoning effort — low → medium → high → max. Pressing it is an ordinary matrix key (row 3, col 1), so it can be remapped like any other.

How it is built

Everything derives from config/device.json. Change the key pitch there and the STLs, the board, the firmware descriptors and the viewer all move together; the test suite fails if any of them disagree.

text
config/device.json      one source of truth
        │
tools/  device.py       loader + derived layout (LED chain, matrix nodes, pads)
        mesh.py         watertight mesh kernel (no CSG, no dependencies)
        parts.py        every physical part, printable and purchased
        circuit.py      schematic as data: components, footprints, nets
        router.py       grid maze router + copper pour generator
        build_pcb.py    place → route → pour → check
        outputs.py      KiCad, gerbers, Excellon, BOM, board.json
        checks.py       ERC + DRC + mechanical fit
        schematic.py    SVG schematic
        build_easyeda.py   schematic → EasyEDA Standard source
        build_stl.py    printable parts → binary STL
        build_html.py   the single-file viewer
        build_firmware.py  QMK descriptors
tests/  test_all.py     36 checks across geometry, layout, circuit and board

No third-party packages. Python 3.11 standard library only.

The mesh kernel

There is no CSG. Every solid is built from operations that are watertight by construction — polygon extrusion, lofting, and lathing — and the awkward case (capping an outline riddled with holes) is handled by a trapezoidal scanline decomposition that re-subdivides the side walls so caps and walls share exactly the same vertices. Mesh.validate() then proves each part is a closed, consistently oriented 2-manifold with positive volume, and build_stl.py refuses to write a file that fails.

The router

The board is rasterised onto a 0.2 mm grid where every piece of copper is stamped along with its clearance halo, so "may net N occupy this cell?" is one array lookup. Nets are then routed shortest-first with A* over that grid, with a cost for changing layer and a separate keepout map that stops a via being drilled too close to another hole. Leftover free space becomes the ground pour, emitted as scanline runs. Any GND pad the pour cannot reach gets found by a flood fill and routed in with a track — the same flood fill the DRC uses, so the fixer and the checker cannot drift apart.

Verification

make test runs 36 checks:

  • Geometry — kernel invariants, analytic volume checks, a fuzz pass over random hole patterns, and every printable part proven watertight, manifold, correctly oriented, printer-sized and thick enough to print.
  • Layout — key pitch, top-surface collisions, bezel window clearances, a monotonic Z stack, and that the encoder shaft does not bottom out in the knob.
  • Circuit — ERC, one switch and one diode per matrix node, unique matrix addresses, an unbroken LED chain, no double-booked GPIO, the LED rail fused and level-shifted, the touch strip fully wired.
  • Board — every connection routed, ≥ 0.2 mm copper clearance verified on a fresh raster of the finished geometry, annular rings, hole-to-hole spacing, all copper inside the profile, the ground pour reaching every GND pad, no courtyard overlaps, and nothing under the MCU module taller than its standoff.
  • Outputs — balanced s-expressions in the KiCad files, well-formed gerbers and Excellon, drill counts matching the board, the BOM covering every component, the viewer free of external references, and the firmware agreeing with the config on pins, LED count, layers and layout size.
  • EasyEDA — every shape string matching EasyEDA's documented field order, no duplicate ids, and the connectivity rebuilt out of the exported file the way EasyEDA reads it — pin dot → wire → net label — coming back identical to the source netlist, all 265 pads and 68 nets.

Current status: 0 DRC errors, 0 warnings, 141/141 connections routed, 9/9 meshes watertight.

Building one

  1. Print at 0.2 mm, 3 walls, 25% infill. No supports on any part. Print the six agent keycaps in natural or clear filament — the roof is 1.0 mm so the status colour reads through. All 13 caps take a standard MX cross stem, so bought keycaps drop straight in if you would rather not print them.
  2. Order the PCB — upload build/pcb/gerbers/ as a zip. Nothing exotic: 2 layer, 1.6 mm, 0.2 mm track and clearance.
  3. Populate — bottom side first (diodes, 0603s, the SOT-23-5, then the RP2040 module on a 2.54 mm header), then the top: the 19 SK6812s, then the 13 MX switches, the EC11 and the thumbstick. Seat every switch fully — the two locating posts must bottom out before you solder, or the plate will not sit flat.
  4. Flash — qmk compile -kb claude_micro -km default, hold BOOTSEL, copy the UF2 across.
  5. Assemble — six M2 heat-set inserts in the bezel, drop the diffuser into the touch window, six M2 × 6 mm screws from underneath.

Full step-by-step with per-part orientation is in the viewer's Print & assemble tab.

Licence

Hardware and firmware are open. The Claude mark is Anthropic's; it is used here on a personal build, not a product for sale.

Parts

95
QtyValueFootprintReferences
22100nFclaude-micro:C_0603C1, C2, C3, C10, C11, C12, C13, C14, C15, C16, C17, C18, C19, C20, C24, C25 +6
141N4148Wclaude-micro:D_SOD123D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14
13MX clearclaude-micro:MX_PCBSW1, SW2, SW3, SW4, SW5, SW6, SW7, SW8, SW9, SW10, SW11, SW12, SW13
13SK6812MINI-Eclaude-micro:SK6812MINILED1, LED2, LED3, LED4, LED5, LED6, LED7, LED8, LED9, LED10, LED11, LED12, LED13
6SK6812-3535claude-micro:SK6812_3535LED14, LED15, LED16, LED17, LED18, LED19
51Mclaude-micro:R_0603R5, R6, R7, R8, R9
210kclaude-micro:R_0603R1, R2
210nFclaude-micro:C_0603C26, C27
210uFclaude-micro:C_0805C22, C23
21kclaude-micro:R_0603R3, R4
11.1A PPTCclaude-micro:F_1206F1
12-axis analog thumbstickclaude-micro:Joystick_20mmJS1
1470Rclaude-micro:R_0603R10
1470uF 10Vclaude-micro:C_1210_BULKC21
174LVC1G17claude-micro:SOT-23-5U2
1EC11E + switchclaude-micro:EC11EENC1
1RP2040 Pico-form-factor moduleclaude-micro:RP2040_Module_PicoMOD1
1Resetclaude-micro:SW_Push_6mmSW_RST

The 89 most common of 95 parts.

Similar boards

  • 2 layers304.3 × 108.3 mmNyx, the printed circuit board in 3D

    Nyx

    HorrorTroll/Nyx

    65% layout PCB with compatible many UDB position

    316 parts1GPL-2.0
  • 2 layers87.2 × 135.7 mm12key, the printed circuit board in 3D

    12key

    mknudsen404-QA/4KeyPOC

    65 parts
  • 2 layers90 × 135 mmVoron badge, the printed circuit board in 3D

    Voron badge

    tanaes/whopping_Voron_mods

    111 parts787GPL-3.0
  • 6 layers46.5 × 47.2 mmNAVCORE SoOP, the printed circuit board in 3D

    NAVCORE SoOP

    kfilipekk/iridium_drone

    STM32H743 flight controller that navigates without GPS from Iridium satellite Doppler

    217 parts2MIT
  • 4 layers72.4 × 69.8 mmWedge, the printed circuit board in 3D

    Wedge

    aaravjhamb/wedge

    a v2 of aaravjhamb/openIEMA!! hijack sound like never before

    117 parts
  • 4 layers101.9 × 84.6 mmTdm b1, the printed circuit board in 3D

    Tdm b1

    awlowell/nucleo_tdm_breakout1

    86 parts
  • 4 layers100 × 60 mmWork after r3, the printed circuit board in 3D

    Work after r3

    cfbird/usb3-sdr

    USB3 direct-sampling HF SDR: AD9649 ADC -> ECP5 FPGA DDC -> FT601 USB 3. KiCad 9 + Verilog, co-designed by Claude and Gemini (AGY).

    231 parts

Questions

How big is the Claude Micro PCB?

It measures 159 × 102 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Claude Micro use?

95 parts, built around the 74LVC1G17Z, 1N4148W and SK6812MINI-E. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Claude Micro KiCad files?

From the Alexpoopy1/Claude-Micro repository on GitHub, at the commit this page was made from: the board is build/pcb/claude-micro.kicad_pcb and its schematic build/pcb/claude-micro.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Claude Micro design in my own project?

Its repository states no licence, so its author keeps all rights: ask Alexpoopy1 before reusing the design.