Path B: Your own machine
Each tool starts with a check. Passes? Skip ahead. Fails? Install, open a new terminal, check again. The steps follow the computer picked at the top of the page.
Installers change. If a command here stops working, follow the link next to it, and tell me so I can fix the page.
Open a terminal
macOS
Press Cmd+Space, type "Terminal", press Enter.
Windows
Press the Windows key, type "PowerShell", press Enter (no need for administrator). Use PowerShell to install things on this page. After that, use Git Bash, which comes with Git: the course's commands are written for it.
Linux
Your usual terminal. On Ubuntu, Ctrl+Alt+T.
After every install, close the terminal and open a new one. An old terminal doesn't see new programs.
PHP and Composer
php -v
composer --version
You need PHP 8.4.1 or newer (8.4.0 is too old for Laravel 13; I learned that the hard way) and any Composer 2.x:
PHP 8.4.21 (cli) (built: May 7 2026 18:44:14) (NTS)
Composer version 2.8.12 2025-09-19 13:41:59
"command not found" or "not recognized" means it isn't installed. The quickest fix is php.new, which installs PHP, Composer and the Laravel installer in one go:
macOS
/bin/bash -c "$(curl -fsSL https://php.new/install/mac)"
Homebrew users can run brew install php composer instead.
Windows
In PowerShell:
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://php.new/install/windows'))
Still an old version after installing? You have two PHPs.
where.exe php lists them in the order Windows tries them. Remove the old
one or move the new one first in your PATH.
Linux
/bin/bash -c "$(curl -fsSL https://php.new/install/linux)"
Distribution packages work too, if they give you 8.4.1 or newer. Older Ubuntu and Debian releases often don't.
macOS / Windows
Prefer an app with a window? Laravel Herd does the same, and the free version is enough.
Git
git --version
Any recent version prints something like git version 2.47.1.
macOS
Not installed? Running git --version makes macOS offer the developer
tools. Say yes.
Windows
Not installed? Get Git for Windows and
keep the installer's defaults. It brings Git Bash, which the course
uses (PowerShell lacks commands like sort and uniq) and Claude Code
uses too.
Linux
Not installed? sudo apt install git, or your distribution's equivalent.
A coding agent
Any agent that runs commands in your project works. That's the whole point: it runs the checks itself.
| Agent | What it is | Get it |
|---|---|---|
| Claude Code | Anthropic's agent, in the terminal or your editor | code.claude.com |
| Codex | OpenAI's agent, in the terminal or your editor | developers.openai.com/codex |
| Cursor | An editor with an agent built in | cursor.com |
| Aider | Open source, any model, local ones too | aider.chat |
A chat in the browser doesn't count: great for thinking, but it can't run your tests.
Claude Code
The examples use Claude Code. It needs a paid Claude plan or an Anthropic Console account.
claude --version
A working install prints a version followed by (Claude Code). To install:
macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash
Windows
In PowerShell:
irm https://claude.ai/install.ps1 | iex
If it says .local\bin is not in your PATH, add it, then close every
terminal (including the one in your editor):
$bin = "$env:USERPROFILE\.local\bin"
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
if (($userPath -split ';') -notcontains $bin) {
[Environment]::SetEnvironmentVariable("Path", "$userPath;$bin", "User")
}
Then run claude once and log in through the browser. claude doctor
helps if something's off.
Code that can't leave your machine?
Run a model locally with Ollama or LM Studio and connect Aider to it (how). Small local models make more mistakes, which, for this course, shows nicely how much the harness helps.
Get the code
Your own codebase? You have it already. Make sure its tests run, and note the command. On to Git: commit to it.
FridgeLister? Fork it if you have a GitHub account: open github.com/PuppetmasterDK/fridgelister and click Fork. You need a fork for the CI exercises in modules 4 and 6. Then clone your fork (or mine, if you skip GitHub):
git clone https://github.com/YOUR-NAME/fridgelister.git
cd fridgelister
composer setup
php artisan serve
composer setup installs everything, creates a SQLite database and loads
demo data. No Node, no database server. Open
http://127.0.0.1:8000 and log in as
grandma@example.com with the password password. Leave the server
running, and open a second terminal for everything else.
Don't use "Use this template" or a zip download: both lose the Git history that module 5 needs.
Later: a coverage driver
Not needed for the taster. Modules 5 and 9 measure test coverage, which needs a PHP extension: PCOV (fast) or Xdebug (slower, also a debugger).
macOS
With Homebrew's PHP: pecl install pcov. Herd Pro includes Xdebug.
Windows
The Xdebug wizard tells you which file to get
and where to put it: paste the output of php -i into it.
Linux
pecl install pcov, or your distribution's php-pcov package if it
matches your PHP.
php -m should then list pcov or xdebug. With Xdebug, put
XDEBUG_MODE=coverage in front of the test command, as the exercises show.
Next: meet FridgeLister, or Git: commit to it if you use your own code.
Kept in this browser. Sign in to keep it on every device.