Edit a FreeCAD Model with Claude AI Without Breaking It

October 31, 2026 · FreeCAD + Claude Course (part 6)

▶ Watch on YouTube & subscribe to The Stack Underflow

A change that looks small can break a part quietly: a hole drifts, a wall thins, a rounded edge disappears. The habit that catches it works with or without AI: write down what must stay true, measure before and after, then check every line.

The one-line version: one change, a measured number before and after, and a list you check line by line.

Last verified in our lab: 31 October 2026 (FreeCAD 1.1.4; freecad-mcp 0.1.28; Claude Code 2.1.308 with Claude Sonnet 5.5; Linux in Docker). The hook comes from lessons 2-5.

The words first

  • Opening: the gap between the back plate and the front lip.
  • hook_depth: the whole bottom, wall to wall: thickness + opening + thickness. For a 45 mm opening you type 55. Typing 45 gives a 35 mm opening.
  • Must-stay-true list: the facts the change must not break, written before you change anything.

The change and the list

Our example: the opening from 30 mm to 45 mm, so a padded backpack strap fits. The list:

  1. one solid, no errors
  2. the back plate 60 mm tall and 30 mm wide
  3. every wall 5 mm thick
  4. the lip 10 mm tall
  5. both screw holes hole_d (4 mm), centred across the width, 15 and 45 mm up
  6. the 2 mm rounded edge on the lip
  7. the sizes still driven by the names in the spreadsheet

Pass rule (written before the runs): the opening measures 45.00 mm, all 7 lines hold, and the volume is 17,098.6 mm³ (14,848.6 + 15 x 5 x 30), all read by a script from the saved file.

By hand (FreeCAD 1.1.4)

  1. Keys 0, then V, F: the corner view.
  2. Tools, Measure. Mode: Distance (on Auto, a face and an edge give an angle, 90 degrees).
  3. Click the back plate’s inside face; hold Ctrl and click the lip’s inside top edge (the lip’s inside face points away from you). Result: 30.00 mm. Close.
  4. Double-click Spreadsheet. Set hook_depth to 55.
  5. Measure again: 45.00 mm. Then check the list: Measure, Mode Radius, a hole’s rim: 2.00 (4 mm across); the small curve at the lip’s end: 2.00; no error marks in the tree; only hook_depth changed in the sheet; click Fillet and type Gui.Selection.getSelection()[0].Shape.Volume in the Python console: 17098.58…

Then with Claude

Lesson 5’s hook open, a fresh session each run. Without the list (1 run):

In FreeCAD, the open document is my wall hook. Make its opening, the gap between the back plate and the front lip, 45 mm wide so a backpack strap fits. After the change, check it and show me the numbers.

With the list (3 runs): the same first two sentences, then:

These must stay true: one solid with no errors; the back plate 60 mm tall and 30 mm wide; every wall 5 mm thick; the lip 10 mm tall; both screw holes hole_d (4 mm), centred across the width, 15 and 45 mm up from the bottom; the 2 mm rounded edge on the lip; and the sizes still driven by the names in the spreadsheet. After the change, check each one and show me the numbers.

Note: our typing script sent the list without its semicolons (a terminal quirk we found afterwards and fixed); the same words reached all three runs.

  • Runs 1 and 2: changed one cell, hook_depth 40 to 55, then a table with a number for every size on the list.
  • Run 3: added a spreadsheet name, opening = 45 mm, and wrote hook_depth = 2 x thickness + opening (55).
  • Without the list: changed the same cell; reported the opening, the size (55 x 30 x 60) and the volume, said the other sizes were unchanged and the holes and the rounded edge still in place, and said nothing about the spreadsheet names.
  • Our script: every line held in all four runs. Replays of the logged tool calls with no AI gave the same part, 4 of 4.

What this can and can’t tell you: with the list, 3 of 3 runs kept every line, measured by our script from the saved file. The one run without the list also kept every line; its report just left out line 7. Three runs: a good sign, not a promise.

The course

Sources

  • The lab: the pre-written pass rule, scripts, logs and replays behind every number here

Change notes

  • 16 Nov 2026: first published, from the lesson’s lab results of 31 Oct 2026.

Not affiliated with or endorsed by the FreeCAD project, the freecad-mcp project or Anthropic. Found a mistake? Tell us in the video’s comments and we’ll correct this page.

Found this useful? The deep version lives on YouTube — new breakdowns of how AI dev tools actually work, weekly.

Subscribe on YouTube →

Prefer email? Get the free newsletter: one failure, traced step by step, about once a week.