Onboarding · Claude on macOS

Claude quick-start for Uncle Mike.

Zero to "jamming on the drone build with Claude" in about ten minutes. Two paths below — terminal (Claude Code, the team's preference) and the desktop app. Pick one, follow the numbered steps, then jump to the example prompts.

Platform
macOS · Intel or Apple Silicon
14+ recommended
Cost
$0 to start
free tier · paid sub later if you like it
Time
~10 min
install + sign in + first chat
What you'll do
Plan the drone build with Claude
using the .md spec from the build doc

§ 01Pick your route

Path A · Recommended

Terminal · Claude Code

A CLI tool you run in the macOS Terminal. Lives in your project folder. Claude can read files directly with @ mentions and can also write/edit files for you. Most powerful option; what the team uses.

Setup · ~10 min
Path B · Simpler

Desktop app · claude.ai

A regular Mac app from Anthropic. Sign in, drag-drop the build file into the chat, ask questions. No terminal required. Perfect if Path A sounds intimidating.

Setup · ~5 min

You can use both. They share the same Claude account. Pick whichever fits the moment.

§ 02Path A · Terminal (Claude Code)

  1. Open Terminal

    Press ⌘ + Space to open Spotlight, type Terminal, hit return. You're now in a blank shell.

    Or use iTerm2 / Warp / Ghostty if you already have one. Any shell works.
  2. Install Homebrew (skip if you already have it)

    Homebrew is the standard Mac package manager. Paste this single line into Terminal and hit return:

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

    It will ask for your Mac password (this is normal — it's installing into /opt/homebrew). Takes ~3 minutes.

    Already have brew? Type brew --version. If it prints a number, skip ahead.
  3. Install Claude Code

    One line:

    brew install --cask claude-code

    ~30 seconds.

    If brew install fails for any reason, the official installer is at docs.claude.com/claude-code/setup.
  4. First run · sign in

    Type:

    claude

    It will print a welcome banner and open your browser to sign in with your Anthropic account. If you don't have one yet, you can make a free account on the same screen. Free tier is enough to get started; subscribe later if you want bigger context windows and more daily usage.

    After signing in, the browser tab will say "you can close this window". Return to Terminal — you're authed.
  5. Save the build doc somewhere

    Make a folder for the drone-build files and download the spec into it:

    mkdir -p ~/Documents/aigp-build
    cd ~/Documents/aigp-build
    curl -O https://aigp-dashboard.pages.dev/documents/diy-5inch-racer-build.md
    curl -O https://aigp-dashboard.pages.dev/documents/diy-5inch-racer-build-parts.json

    You now have the full build doc and a JSON parts list in ~/Documents/aigp-build/.

  6. Start Claude in that folder

    Still in the same Terminal window:

    claude

    Claude Code starts up inside ~/Documents/aigp-build/. It can now see all the files in that folder. To point it at the build spec specifically, type:

    @diy-5inch-racer-build.md what does this drone build cost in total?

    Hit return. Claude will read the file and answer.

    The @ prefix is how you reference files. Tab-autocompletes filenames.
  7. Quit when done

    Type /quit or press Ctrl+C twice. Next time, just cd ~/Documents/aigp-build && claude.

§ 03Path B · Desktop app

  1. Download the Mac app

    Open claude.ai/download in any browser. The page detects macOS and offers a .dmg installer.

  2. Install

    Double-click the downloaded Claude.dmg, then drag the Claude icon into your Applications folder. Same drill as any Mac app.

    First launch: macOS will ask "are you sure you want to open this app?" — yes.
  3. Sign in

    Same Anthropic account as Path A (or make one fresh if this is your first time). The app opens straight to a chat window.

  4. Grab the build doc

    Download diy-5inch-racer-build.md from the build page. It lands in your ~/Downloads folder.

  5. Drop it into a chat

    In Claude, click the paperclip icon next to the chat input (or just drag the .md file from Finder onto the chat window). The file becomes part of the conversation.

    Now type a question — try one of the prompts below — and hit return.

§ 04Example prompts to start with

Copy-paste any of these. They all assume the build doc is loaded (via @ in Path A, or attached to the chat in Path B). Claude will use the doc as ground truth.

budget What's the total cost if I want to build two of these drones? List every line item.
shopping Make me a single shopping list grouped by retailer. Tell me what to buy from GetFPV vs Amazon vs Adafruit.
csv export Convert the BOM into a CSV I can paste straight into Google Sheets. Columns: part, qty, unit_price, total, retailer, link.
wiring walkthrough Walk me through the wiring step by step, like I've never soldered an FPV drone before. Tell me what to check after each connection.
props Which propellers should I use if I'm flying outdoors with 10-15 mph wind? Explain the tradeoff vs the primary pick.
substitution What changes if I swap the Jetson Orin Nano for the Orin NX 16GB? Cost, weight, power budget, performance.
field session Generate a packing checklist for a 4-hour outdoor test session. Include tools, spares, batteries, safety gear.
troubleshooting My drone won't arm and BetaFlight is showing "GYRO calibration failed". Walk me through the most likely causes.
first flight I'm about to do my first hover test. Read me the pre-flight checklist one item at a time and wait for me to confirm each before moving on.
battery life Estimate flight time per battery pack at hover, at race speed, and at cruise. Show your math.
camera spec Explain the +20° camera tilt in plain English. Why does the spec call for it, and what would happen if I mounted it level?
spares planning For a 3-month training campaign with 4 drones flying 30 minutes each per week, how many spare propellers and motors should I stock?

§ 05Tips for a new Claude user

One more thing. If you ever want to share what Claude said with someone else on the team, the desktop app has a "Share" button that makes a public link. In the terminal, just copy the text out and paste it wherever.

§ 06Where to go next

CLAUDE-QUICKSTART · macOS · v1.0 2026-05-19 · ← Index · Build doc