Choose your AI and set up your machine.
Everything in this tutorial works with Claude, Gemini or ChatGPT. The method is the same. Only the install commands and folder names change.
What you will learn
By the end of this chapter- 01Choose between Claude Code, Gemini CLI and Codex for your situation.
- 02Install the tool and check that it runs from a terminal.
- 03Create a project folder and serve it on a local address.
- 04Start your AI inside the folder, so it can read and edit the files.
01 · What you need
5 itemsA terminal
Terminal on macOS, PowerShell on Windows, or any Linux shell. If you have never opened one, a two-minute search for your operating system is enough.
A code editor
VS Code is a free choice. Any editor that can open a folder will do.
Node.js
Provides npm and npx, which install most skills and command-line tools. Download the LTS version from nodejs.org.
A current browser
Chrome, Safari or Firefox, to test the page on a desktop and a phone-sized window.
One AI account
Claude, Gemini or ChatGPT. Check each product page for which plan includes the tool you want, because plans change.
02 · Compare the three
Verified against official docs| Claude | Gemini | ChatGPT and Codex | |
|---|---|---|---|
| Chat app | claude.ai (skills on Pro, Max, Team and Enterprise plans) | gemini.google.com | ChatGPT (skills are in beta and depend on your workspace) |
| Command-line tool | Claude Code | Gemini CLI | Codex CLI |
| Install | curl -fsSL https://claude.ai/install.sh | bash | npm install -g @google/gemini-cli | npm install -g @openai/codex |
| Start it | claude | gemini | codex |
| Personal skills folder | ~/.claude/skills/ | ~/.gemini/skills/ | ~/.agents/skills/ |
| Project skills folder | .claude/skills/ | .gemini/skills/ | .agents/skills/ |
| Run a skill | /skill-name or just describe the task | Describe the task. List skills with /skills list | $skill-name or describe the task |
03 · Install your tool
Pick oneInstall the one you already use or pay for. Every later chapter works the same with all three; only the install commands and folder names change, and the site remembers your choice.
Claude Code is the command-line tool. It needs a Claude subscription or an Anthropic Console account. There is also a desktop app and a VS Code extension, both from the same page.
curl -fsSL https://claude.ai/install.sh | bashirm https://claude.ai/install.ps1 | iexbrew install --cask claude-code
winget install Anthropic.ClaudeCodeOpen a new terminal, then check the install and start it inside a project folder. It asks you to log in the first time.
claude --version
cd your-project
claudeSource: Claude Code overview
Gemini CLI installs through npm, so Node.js must be installed first.
npm install -g @google/gemini-cli
geminiWhen it asks how you would like to authenticate, choose “Sign in with Google” and follow the browser prompt.
Source: Get started with Gemini CLI
Codex CLI is OpenAI’s command-line tool. Use one install method only, because a second copy can put an older version first on your PATH.
curl -fsSL https://chatgpt.com/codex/install.sh | shbrew install --cask codex
npm install -g @openai/codexcodex login
codex --version
codexIf you only use the ChatGPT website, skills work differently: you ask ChatGPT to build one and click Install. Chapter 02 covers it.
Sources: OpenAI, Build skills and a third-party install guide that quotes the same commands. Commands can change, so check the official page.
04 · Make the project folder
2 minutesCreate it
Make an empty folder and three files. Plain HTML, CSS and JavaScript is enough. No framework or build step is needed.
mkdir cinematic-site
cd cinematic-site
touch index.html style.css app.jsmkdir cinematic-site
cd cinematic-site
ni index.html, style.css, app.jsServe it
Run a local web server and open the address it prints. Do not double-click the HTML file. Browsers treat a file:// page differently, and scroll libraries and fetch calls can misbehave there.
python3 -m http.server 8000
# Windows: py -m http.server 8000
# then open http://localhost:8000Start your AI inside it
Run the AI tool from this folder so it can see and edit your files: claude, gemini or codex. On the ChatGPT website, upload the three files instead.
05 · Which one should you pick?
Use the one you already pay for or know. Skills are plain folders with a SKILL.md file, and the same format is read by Claude Code, Gemini CLI and Codex. What you learn in chapter 02 carries over. The models do differ in taste and in how carefully they check their own work, so look at every result yourself.
Practice · Work with AI
The same task in your toolYour first session. Let the tool look around before it writes anything, and make it ask before every change.
Open a terminal in the project folder and run claude. Press Shift+Tab until plan mode is on, paste the prompt, read the plan, then approve it. Project rules go in CLAUDE.md.
Get oriented
Look at this folder and tell me what is in it. Do not create or change any file yet. Then tell me the command you would use to serve it locally on port 8000, and wait for my answer.Check the setup
Check that index.html, style.css and app.js exist and are linked: index.html loads style.css in the head and app.js with defer. If something is missing, show me the change before you make it.Open a terminal in the project folder and run gemini; the first time, it asks whether you trust the folder, so say yes for your project. Paste the prompt. Gemini CLI asks before it edits a file or runs a command: read each request before you accept it. Project rules go in GEMINI.md.
Get oriented
Look at this folder and tell me what is in it. Do not create or change any file yet. Then tell me the command you would use to serve it locally on port 8000, and wait for my answer.Check the setup
Check that index.html, style.css and app.js exist and are linked: index.html loads style.css in the head and app.js with defer. If something is missing, show me the change before you make it.Open a terminal in the project folder and run codex, then paste the prompt and approve each change. In the ChatGPT app without Codex, attach the files, paste the prompt and copy the changes back yourself. Project rules go in AGENTS.md.
Get oriented
Look at this folder and tell me what is in it. Do not create or change any file yet. Then tell me the command you would use to serve it locally on port 8000, and wait for my answer.Check the setup
Check that index.html, style.css and app.js exist and are linked: index.html loads style.css in the head and app.js with defer. If something is missing, show me the change before you make it.Practice · Exercises
Try first, then compareTwo terminals
Keep the local server running in one terminal and your AI in a second one, both inside the project folder. Close both, then open them again from scratch.
Hint: each terminal needs its own cd into the folder.
Show the solution
The server has to keep running while you work; stopping it with Ctrl C makes http://localhost:8000 unreachable. Your AI runs in the other terminal, started from the same folder.
# terminal 1
cd cinematic-site
python3 -m http.server 8000
# terminal 2
cd cinematic-site
claude # or gemini, or codexWhy not file://
Open index.html by double-clicking it, then through http://localhost:8000. Compare the address bar in both cases.
Hint: look at how each address starts.
Show the solution
A double click opens file:///…; through the server the address starts with http://localhost:8000. ES modules, fetch and several browser features only work over http, which is why every step in this course uses the server.
Know your versions
Write down the versions of Node.js and of your AI tool. You will need them when something behaves differently from the course.
Hint: every tool has a --version flag.
Show the solution
Keep the output in a notes file in the project. When a command in the course fails, the version is the first thing to compare with the official documentation.
node --version
claude --version # or: gemini --version, codex --versionPractice · Course project
One site, built across the courseAcross the course you build one cinematic one-page site for [subject]. Each chapter adds a step. This one sets up the folder.
- Create the folder
cinematic-sitewithindex.html,style.cssandapp.js. - Paste the starting page below into
index.htmland change the title to [subject]. - Serve the folder and open http://localhost:8000.
- Start your AI in the folder and run the “Get oriented” prompt.
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>My cinematic site</title>
<link rel="stylesheet" href="style.css">
<script src="app.js" defer></script>
</head>
<body>
<main>
<h1>Hello</h1>
</main>
</body>
</html>Practice · Test it
Check the result- http://localhost:8000 shows the heading “Hello”.
- In DevTools, the Network tab shows
style.cssandapp.jsloaded with status 200. - The Console is empty.
- Your AI answered the orientation prompt with the three file names and changed nothing.
Practice · Assessment
Acceptance criteria0 of 4 criteria met