AI Workshops · BrainIT Consulting All twelve workshops ↗
Setting up Once only Windows and Mac

Getting Set Up

Everything you install across the twelve workshops, in one place, with the Mac version of every step. Nothing here is urgent — come back when a workshop asks you to.

Presented by Emile du Toit
brainitconsulting.com

You do not need any of this to start. Workshops #001 to #003 run in a web browser with nothing installed and nothing paid.

First decisionThree ways to take part

Pick one now. You can move up later, and most people do not need to.

Free

Watch

Read the workshops, watch the exercises being done, install nothing. Plenty of people work this way for the first few sessions and start typing at #004.

You need: nothing at all.

Free

Browser

The one I steer most people to. A free account at claude.ai or chatgpt.com, open in a tab beside your work. You describe, it writes, you paste. This carries you through every workshop.

You need: an email address.

$20/mo

Agent

Claude Code or Codex, working directly in your folder instead of handing you text to paste. Worth it once you are doing this most weeks. Not before.

You need: a paid plan, from #005 onward. Codex also runs on the free ChatGPT plan, sized for quick tasks.

Work free through #008, which is where the thinking is. The browser route does everything #001 to #008 ask for. It gets through #009 and #010 with more effort — both have routes that are all clicking — and it runs out at #011, where the labs need the assistant writing files into your folder and running them.

So pay at the point the free way starts annoying you, and not before. That is a real signal, you will know it when it arrives, and by then you will have used one on real work for a month. That is a far better way to decide than taking my word for it in week one.

The short answerWhat you need, and when

Nobody should install Node.js in week one. Here is the honest order.

WhatFirst neededWhy, and whether you can skip it
A browser account#001claude.ai or chatgpt.com. Free. This is the only thing #001 to #003 need.
VS Code#004The window onto your own folder. Free, from Microsoft, about three minutes.
A coding agent#005Optional, and about $20 a month. The free browser route does everything through #008 with more pasting, and runs out at #011.
Git#007Your undo. Free. On a Mac it may already be there.
A GitHub account#007Free. Where your work lives when the laptop does not.
A Vercel account#009Free hobby plan, no card. The database in #009 comes from its marketplace; #010 is where it puts your work on the internet.
Node.js#009Only if you let the assistant use the Vercel command-line tool. Every lab that needs it has a clicking route that does not.

The installsEach one, both platforms

Open the one a workshop has asked for. Ignore the rest until they come up.

An AI account 5 min · #001

Pick one. You do not need both, and comparing them on day one will only slow you down.

  1. Go to claude.ai or chatgpt.com.
  2. Sign up with your email, or the “continue with Google” button.
  3. Open the email they send. Click the link in it, or type in the code.
  4. If it offers you a plan, look for the word Free. You never need a card for these workshops.

While you are in there

Open Settings and find the option about whether your conversations may be used to improve the model. Both services have one, in slightly different places. Decide once now.

VS Code 5 min · #004

Windows

  1. code.visualstudio.com. The big blue button knows which machine you are on.
  2. Run the file it downloads and accept the agreement.
  3. On the tick-box screen, tick Add “Open with Code” action to Windows Explorer directory context menu and Add to PATH. Both matter later.
  4. Next, Next, Install. Then launch it and close the Welcome tab.
On a Mac
  1. Same site, same button. The download is a zip.
  2. Open it, then drag Visual Studio Code into Applications and open it from there.
  3. macOS asks whether you are sure, because you downloaded it. Click Open.
  4. There are no tick boxes. For the code command, press Cmd+Shift+P, type shell command, pick Install ‘code’ command in PATH.

Everywhere these workshops say Ctrl, you press Cmd.

A coding agent — optional 10 min · #005

Only if you have decided to pay. Everything in the workshops works without this; you paste instead.

Claude Code, with no terminal

  1. Install the desktop app from claude.com/download and sign in.
  2. It needs a Claude Pro plan. The free claude.ai account will not open it.
  3. Point it at the folder you are working in.

Claude Code, in a terminal

In VS Code use Terminal → New Terminal, which opens already inside the right folder. On Windows:

irm https://claude.ai/install.ps1 | iex

On a Mac:

curl -fsSL https://claude.ai/install.sh | bash

Close that terminal, open a new one, and type claude. There is also winget install Anthropic.ClaudeCode on Windows or brew install --cask claude-code on a Mac.

Codex

Start at chatgpt.com/codex and choose Sign in with ChatGPT when it first runs. Which plans include how much has changed more than once — check it yourself rather than trusting a figure written months ago.

Either one, inside VS Code

  1. Click the Extensions icon in the left strip, or press Ctrl+Shift+X (Cmd on a Mac).
  2. Search Claude Code or Codex.
  3. Check the publisher before you install. It should say Anthropic or OpenAI. There are lookalikes, and installing one of those hands a stranger your files.
  4. Install, reload if asked, then sign in from the new icon in the left strip.

The extension and the desktop app are the same thing in different clothes and share one sign-in. You do not need both.

Git 5 min · #007

Windows

  1. git-scm.com/downloads, run the installer, and click Next through every screen. The defaults are right and there are a great many screens.
  2. Close VS Code completely and reopen it. It only notices Git at startup. This one step causes more confusion than anything else in the series.
On a Mac
  1. It may already be there. In VS Code open Terminal → New Terminal and type git --version.
  2. A version number means you are done.
  3. A box offering to install developer tools means click Install and wait a few minutes. No decisions needed.
  4. Close VS Code completely and reopen it.
A GitHub account 3 min · #007
  1. github.com/signup. Free.
  2. Pick a username you would not mind a customer seeing.
  3. Write the password down somewhere real.
  4. Confirm the email they send you.

You will not be typing git commands. VS Code has buttons for all of it, and #007 walks you through them.

A Vercel account 3 min · #009
  1. vercel.com/signup. Choose the Hobby plan — free, and no card. It is meant for personal projects; #010 covers when to move to the paid one.
  2. Continue with GitHub is the quickest, because Vercel can then see your repositories straight away.
  3. But sign in however you like. Google works, and it is what I use. Vercel then asks to connect GitHub at the moment you publish instead — one extra click.
Node.js — only if you want the command line 5 min · #009

Skip this unless a workshop has told you that you need it. Publishing to Vercel through its website needs none of it and gives the same result.

  1. nodejs.org and take the version marked LTS.
  2. Run the installer and accept everything.
  3. Close and reopen your terminal, then check it took:
node --version

A number means you are set. Then the Vercel tool:

npm i -g vercel
vercel login

Keep this openWhen an install goes wrong

All of these have happened to somebody, and none of them mean you have broken anything.

What you seeWhat to do
VS Code asks whether you trust the authorsYes. It is your own folder and you are the author.
claude or node is not recognisedThe terminal was open before the install finished. Close it, open a new one. Works nearly every time.
No Source Control options in VS CodeGit was installed while VS Code was running. Close it fully and reopen.
“Claude Code requires a paid plan”Expected — the free account does not open it. Use the browser route and carry on.
The Vercel tool will not installIt needs Node.js 20 or newer. Install Node, or skip it and publish through the website.
missing_scope from the Vercel toolYour account is in more than one team, so it will not guess. Add --scope <your team>.
An installer wants an administrator passwordNormal for Git and Node on Windows. If it is a work laptop and you do not have one, that is the one thing these workshops cannot get around.

Stuck?Ask the thing you are installing

This works better than searching, and it is a habit worth forming early.

Open your free browser account and paste this, with your own details filled in. Being walked through one step at a time beats being handed the whole answer.

I am on [Windows 11 / a Mac] and I am trying to install [VS Code]. I have never done anything like this before. Walk me through it one step at a time. Wait for me to say "done" before you give me the next step. If something on my screen does not match what you described, I will tell you and you can adjust.

If it goes wrong in a way this page does not cover, paste the exact error message in. Error messages look like nonsense and read perfectly well to an assistant.