Skip to the content
2 layers120 × 134 mmClaude code pad, the printed circuit board in 3D

A 25-key macropad companion for Claude Code terminal sessions — the Claude Code Pad. Dedicated hardware for firing CLI shortcuts (accept, reject, allow, arrow keys, commit/PR macros, plan/model cycle) with per-key RGB…

Size
120 × 134 mm
Copper layers
2
Thickness
1.6 mm
Parts
137
Nets
78
Pads
451
Tracks, vias
1,095, 1,003
Pours
4
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
19 Apr 2026
Updated
18 Sep 2026

Overview

Claude code pad is an open-source printed circuit board by P47Phoenix, from the P47Phoenix/Claude-Keyboard repository on GitHub. It is a 2-layer board of 120 × 134 mm with 137 parts on 78 nets, routed with 1,095 tracks and 1,003 vias.

It is built around the XIAO NRF52840, 1N4148W and SK6812, with the ESD9L3.3S, BZT52C5V1 and DMG3415U-7 among its other parts. Its parts include 50 diodes, 31 capacitors, 25 switches, 3 resistors and 1 IC. It belongs with the nRF52 and nRF5x boards of this library.

Main components

6

README

README.md

Claude Keyboard

A 25-key macropad companion for Claude Code terminal sessions — the Claude Code Pad. Dedicated hardware for firing CLI shortcuts (accept, reject, allow, arrow keys, commit/PR macros, plan/model cycle) with per-key RGB, a rotary encoder, a 2U stabilized Enter, and RFID artisan keycap support.

Wireless multi-host via BLE on a Seeed XIAO nRF52840; firmware runs ZMK.

Status

Design-complete (2026-04-23). Gerbers + case STLs + firmware UF2 are produced, reviewed, and committed. Hardware bring-up + bench verification of the safety thresholds is the next physical step.

PhaseScopeState
1PCB design (schematic, layout, routing, gerbers, BOM, CPL)Closed (11 cycles)
23D-printed case + bottom plate (CadQuery, PETG)Closed (3 cycles)
3Firmware (ZMK on nRF52840)Closed (3 cycles) — west build clean, ztest 10/10
4TinyML calloutsRetired (Cycle 1 arbitration)
5RFID figurine keycap baseRetired (post-Phase-3 scope decision)
6Integration reviewRetired (post-Phase-3 scope decision)

PN532 NFC header + I²C bus remain on the PCB for any future revisit; firmware can wire them up later without a board respin.

Hardware highlights

  • MCU: Seeed XIAO nRF52840 (direct-solder castellations). BLE 5.x multi-host. Retired the initial XIAO ESP32-S3 + TinyML/OLED path in favour of a simpler, better-supported stack.
  • Keyswitches: 24× 1U + 1× 2U Enter, Kailh MX hot-swap (Keebio MX_Only_HS), 19.05 mm pitch, Cherry plate-mount 2U stabilizer (slotted housing holes per community canonical footprint).
  • RGB: 25× SK6812MINI-E reverse-mount, one per key, serpentine chain. Firmware-capped at 300 mA peak per IEC 62368-1 Annex Q.
  • Encoder: EC11 with metal shaft grounded through plated mounting lugs; ESD TVS on all three encoder signals.
  • NFC: PN532 header for RFID artisan figurine personality switching (Phase 5).
  • Power: 1S LiPo via JST-PH with mandatory cell-level protection PCB (approved cells from Adafruit/SparkFun — see docs/build-guide.md). On-board DMG3415U-7 P-FET reverse-polarity, 500 mA PTC, SPDT slide switch. Charging via the XIAO's USB-C + on-module charger.
  • Safety: NTC cell-temperature monitor, 5× ESD9L3.3 TVS on exposed I²C + encoder, firmware LED cap + VBAT undervoltage cutoff (3.70 V LEDs-on / 3.50 V LEDs-off).
  • Board: 120 × 132 mm, 2-layer FR4, HASL lead-free, black soldermask. Freerouting-autorouted (1095 segments, 148 GND stitching vias, antenna keepout inviolate).

Repository layout

text
claude-code-pad/
├── pcb/                           # Phase 1 deliverables
│   ├── claude-code-pad.kicad_pro|sch|pcb
│   ├── gerbers/                   # 10 layers + drill + job file (fab-ready)
│   ├── bom.csv / cpl.csv          # JLCPCB format
│   ├── DESIGN-NOTES.md            # design rationale + cycle history + pinout verification
│   └── _gen/                      # generator + autoroute pipeline
│       ├── generate.py            # schematic + placement source of truth
│       └── autoroute/             # export_dsn + freerouting + import_ses + widen_power + stitch_gnd
├── firmware/
│   ├── zmk/                       # Phase 3 primary (nRF52840 + ZMK)
│   │   └── README.md              # Hard Requirements for FW-1
│   └── qmk/                       # alternate path (RP2040)
├── case/                          # Phase 2 (MECH-1, CadQuery)
├── figurines/                     # Phase 5 (RFID artisan keycap)
└── docs/
    ├── build-guide.md             # MANDATORY battery requirements + assembly
    └── review-log.md              # Adversarial review paper trail

Orchestration

Design work is done by persona sub-agents dispatched via Claude's Agent tool, not by the main thread:

  • Designers (ECE-1 for PCB, MECH-1 for case, FW-1 for firmware) produce deliverables.
  • Adversarial reviewers (RED-DFM, RED-SAFETY, RED-COST, RED-MECH, RED-FW) critique in parallel.
  • Primary designer iterates until BLOCKER/MAJOR findings clear.
  • Every cycle is logged in claude-code-pad/docs/review-log.md.

Full orchestration spec: /var/home/meconnelly/Downloads/claude-code-pad-orchestrated-prompt.md (authoritative for personas, phases, and reviewers).

Tooling

This repo targets a Bazzite (immutable Fedora atomic) workstation. Package management notes and KiCad / Freerouting / Distrobox conventions are in CLAUDE.md.

  • KiCad 10.0.1 as a Flatpak (org.kicad.KiCad) for GUI + authoritative file reads.
  • KiCad 9.0.8 in a kicad distrobox (Podman-backed Fedora 43 toolbox) for kicad-cli automation + the KiCad MCP server (lamaalrajih/kicad-mcp, auto-loaded via .mcp.json).
  • Freerouting 2.1.0 (Java 21) in the same distrobox for headless autorouting.
  • CadQuery / OpenSCAD (Phase 2) — user-space Python, no Bazzite layering needed.

Quick commands

bash
# DRC via kicad-cli (flatpak, matches GUI rule set)
flatpak run --command=kicad-cli org.kicad.KiCad pcb drc \
  --output /tmp/drc.rpt pcb/claude-code-pad.kicad_pcb

# Open the PCB in the GUI
flatpak run --command=pcbnew org.kicad.KiCad pcb/claude-code-pad.kicad_pcb

# Re-run Freerouting (from distrobox)
distrobox enter kicad -- python3 pcb/_gen/autoroute/export_dsn.py pcb/claude-code-pad.kicad_pcb
distrobox enter kicad -- java -jar ~/.local/share/freerouting/freerouting.jar \
  -de /tmp/claude-code-pad.dsn -do /tmp/claude-code-pad.ses
distrobox enter kicad -- python3 pcb/_gen/autoroute/import_ses.py pcb/claude-code-pad.kicad_pcb

Getting involved

If you want to build one:

  1. Read claude-code-pad/docs/build-guide.md first — especially the mandatory battery requirements section.
  2. Order the PCB from JLCPCB using claude-code-pad/pcb/gerbers/ and claude-code-pad/pcb/cpl.csv.
  3. Source the cells from the approved vendor list in the build guide. Do not substitute a raw LiPo — the board relies on cell-level protection PCM.
  4. Wait for Phase 2 (case STL) and Phase 3 (ZMK firmware) before assembling a complete unit.

License

TBD.

Parts

137
QtyValueFootprintReferences
29100nclaude-code-pad:C_0402_1005MetricC3, C4, CL1, CL2, CL10, CL11, CL12, CL13, CL14, CL15, CL16, CL17, CL18, CL19, CL20, CL21 +13
251N4148Wclaude-code-pad:D_SOD-123D00, D01, D02, D03, D04, D10, D11, D12, D13, D14, D20, D21, D22, D23, D24, D30 +9
25SK6812claude-code-pad:LED_SK6812_MINI-E_plccn4_3.5x2.8mmLED1, LED2, LED10, LED11, LED12, LED13, LED14, LED15, LED16, LED17, LED18, LED19, LED20, LED21, LED22, LED23 +9
24MX_HSclaude-code-pad:SW_Kailh_HotSwap_MXSW00, SW01, SW02, SW03, SW04, SW10, SW11, SW12, SW13, SW14, SW20, SW21, SW22, SW23, SW24, SW30 +8
5ESD9L3.3claude-code-pad:D_SOD-523TVS_ENCA1, TVS_ENCB1, TVS_ENCSW1, TVS_SCL1, TVS_SDA1
3FIDclaude-code-pad:Fiducial_1mm_Mask2mmFID1, FID2, FID3
210kclaude-code-pad:R_0402_1005MetricR_GREV1, R_NTC1
21Mclaude-code-pad:R_0402_1005MetricR_VBAT1, R_VBAT2
222uclaude-code-pad:C_0805_2012MetricC1, C2
24k7claude-code-pad:R_0402_1005MetricR2, R3
2M3claude-code-pad:MountingHole_3.2mm_M3H1, H2
2M3claude-code-pad:MountingHole_3.2mm_M3_NPTHH3, H4
2TOOLclaude-code-pad:MountingHole_1.5mmTP1, TP2
1470claude-code-pad:R_0402_1005MetricR1
1BZT52C5V1claude-code-pad:D_SOD-523D_GREV1
1DMG3415U-7claude-code-pad:SOT-23Q_REV1
1EC11claude-code-pad:RotaryEncoder_Alps_EC11E-Switch_Vertical_H20mmEC1
1JST-PH-2Pclaude-code-pad:JST_PH_S2B-PH-SM4-TB_1x02-1MP_P2.00mm_HorizontalJ_BAT1
1JUMPERclaude-code-pad:XIAO_BackPad_Jumper_1x7J_XIAO_BP
1MF52A2_10kclaude-code-pad:R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_HorizontalTH1
1MX_HSclaude-code-pad:SW_Kailh_HotSwap_MX_2USW44
1NFCclaude-code-pad:PinHeader_1x04_P2.54mm_VerticalJ_NFC1
1PTC_500mAclaude-code-pad:Fuse_0805_2012MetricF1
1SPDTclaude-code-pad:SW_Slide_1P2T_SS12D00G4SW_PWR1
1XIAO_nRF52840claude-code-pad:XIAO_nRF52840_CastellatedU1

Similar boards

  • 4 layers50 × 50 mmIot diagnostic tool, the printed circuit board in 3D

    Iot diagnostic tool

    mbabela/secured-vehicle-monitoring

    Repository for my bachelor thesis at FEEC BUT

    109 parts
  • 2 layers200 × 120 mmPlytka v2, the printed circuit board in 3D

    Plytka v2

    tmierzwa/WICI

    Otwarty system łączności awaryjnej (Reticulum/LXMF, 869 MHz)

    152 parts4
  • 2 layers136 × 91.7 mmOne, the printed circuit board in 3D

    One

    ergonautkb/one

    Ergonaut One is an open-source ergonomic wireless split mechanical keyboard designed by Ergonaut Keyboards.

    56 parts210CERN-OHL-P-2.0
  • 2 layers117 × 96 mmOne s, the printed circuit board in 3D

    One s

    ergonautkb/one-s

    Ergonaut One S is an open-source ergonomic wireless split mechanical keyboard designed by Ergonaut Keyboards.

    50 parts10CERN-OHL-P-2.0
  • 2 layers161.9 × 120.5 mmDodo keyboard, the printed circuit board in 3D

    Dodo keyboard

    gorbit99/dodo-keyboard

    60% split wireless keyboard

    116 parts9
  • 2 layers111 × 89.1 mmUrxin, the printed circuit board in 3D

    Urxin

    diegolhambi/urxin

    A keyboard made inspired by Urchin, TOTEM and Ergonaut One.

    41 parts6
  • 2 layers25 × 20 mmXIAO CR2032-KEY, the printed circuit board in 3D

    XIAO CR2032-KEY

    kaz-mac/xiao_1key_blekey

    1ボタンだけのワイヤレスキーボード for XIAO nRF52840

    9 parts3MIT

Questions

How big is the Claude code pad PCB?

It measures 120 × 134 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Claude code pad use?

137 parts, built around the XIAO NRF52840, 1N4148W, SK6812 and ESD9L3.3S. 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 code pad KiCad files?

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

Can I use the Claude code pad design in my own project?

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