Path A: No install
GitHub can give you a ready-made Linux machine in your browser, called a codespace, with PHP, Composer, Claude Code and FridgeLister already set up. You get an editor, a terminal, and the app at its own web address. No installers, no PATH, no "works on my machine".
The video walks through every step below, including the one tricky bit: logging in to Claude Code.
Set the switch at the top of the page to Linux. A codespace is a Linux machine, so whenever the course has different steps per computer, follow the Linux ones.
You need
- A GitHub account. Free is fine: sign up.
- A paid Claude plan, for Claude Code. Prefer another agent? Install it in the codespace's terminal, the Linux way.
Free accounts get a monthly allowance of codespace time, which is plenty for the course. Without a payment method on file, a codespace just stops when the allowance runs out, so you can't be charged by accident. GitHub's billing page has the current numbers.
1. Fork FridgeLister
Open github.com/PuppetmasterDK/fridgelister, click Fork, then Create fork. Now you have your own copy, history and all.
2. Create a codespace
On your fork, click the green Code button, open the Codespaces tab, and click Create codespace on main.
The first start takes a few minutes. It's done when the terminal says:
Ready. Start the app with: php artisan serve
Start your agent with: claude
3. Run the app
php artisan serve
A box says your application on port 8000 is available. Click Open in Browser. Missed it? Open the Ports tab next to the terminal and click the globe on port 8000.
Log in as grandma@example.com with the password password. The address
is private to you. Leave this terminal running, and open a second one with
the + button for everything else.
4. Log in to Claude Code
In the second terminal:
claude
Claude Code asks you to log in. After you log in in the browser, it
normally sends you back to an address on localhost. In a codespace that's
GitHub's machine, not yours, so that last hop fails. Two ways round it:
-
The page shows a code. Copy it, paste it into the terminal, press Enter.
-
The page says "This site can't be reached" and the address starts with
http://localhost. Copy the whole address. Open a third terminal with + and runcurlon it, in double quotes:curl "http://localhost:…/callback?code=…"Back in the Claude terminal, you're logged in. Be quick: the code expires in a minute or two.
Then quit Claude Code for now with /exit. You'll meet it properly in the
ready check.
Stopping and coming back
Close the tab when you're done. The codespace stops by itself and keeps
your files. To come back, open github.com/codespaces,
click yours, and run php artisan serve again.
Don't delete a codespace with unpushed work. Pushing is covered in Git: commit to it.
Advanced: your own repository in a codespace
Any GitHub repository can run in a codespace if it has a .devcontainer
folder that says what to install. FridgeLister's is a working example.
Writing one is a nice first job for your agent:
Say this to your agent
Add a .devcontainer folder so this project runs in a GitHub codespace, with everything the tests need installed when the codespace is created. Look at how FridgeLister does it: github.com/PuppetmasterDK/fridgelister
Next: meet FridgeLister.
Kept in this browser. Sign in to keep it on every device.