Setup Guide ≈ 15 Minutes · Once · No Experience Needed

Get set up.

This page assumes nothing. If you've never opened a terminal in your life, you're exactly who it was written for. Follow the numbered steps top to bottom, copy the commands exactly, and compare your screen to the pictures. If anything looks different from what you expect, jump to troubleshooting — your problem is almost certainly one of the four listed there.

00 — BEFORE WE START

One word to learn: "terminal."

A terminal is just a window where you type instructions to your computer instead of clicking. It looks intimidating and it isn't — you will only ever paste things into it and press Enter. Mac calls its terminal Terminal. Windows calls its PowerShell. That's the whole vocabulary lesson; you're ready.

Rather watch than read?

There's a free official video course.

Anthropic publishes a free hands-on course, Claude Code in Action — how to steer Claude through bigger jobs, set up permissions, and trust the results. Do the steps below first (15 minutes, and you're working), then take the course this week to go deeper.

01 — INSTALL CLAUDE CODE

Pick your computer. Follow the pictures.

You only need one of these two blocks — Mac or Windows. The windows shown are illustrations of what your screen will look like at each step.

macOSOn a Mac4 steps
1
Open the Terminal app

Hold the ⌘ command key and press the space bar. A search bar appears in the middle of your screen. Type terminal and press Enter.

Spotlight Search — ⌘ + Space
terminal
>_ Terminal Applications / Utilities

A window with plain text opens. That's the terminal. It's supposed to look boring.

2
Copy the install command, paste it, press Enter

Select the whole line below, copy it (⌘C), click inside the terminal window, paste it (⌘V), then press Enter.

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

Your terminal will print some progress text for a minute. When it stops, it should look like this:

Terminal
$ curl -fsSL https://claude.ai/install.sh | bash
Downloading Claude Code…
Installing to ~/.local/bin…
✔ Claude Code installed successfully.
Restart your terminal, then run: claude
3
Close the terminal, open it again

Quit Terminal completely (⌘Q), then open it again the same way as step 1. This is required — the computer only notices new programs in fresh windows.

4
Check it worked

Type this and press Enter:

type this › claude --version
Terminal
$ claude --version
2.1.x (Claude Code)

Any version number = success. "command not found" = go to troubleshooting #1 below.

WindowsOn a Windows PC5 steps
1
Open PowerShell

Press the Windows key (bottom row, looks like four squares). Type powershell and press Enter.

Start Menu — press the Windows key and type
powershell
>_ Windows PowerShell App

A blue window opens with text ending in PS C:\Users\yourname>. The "PS" at the start matters — it means you're in the right place.

2
Copy the install command, paste it, press Enter

Select the line below, copy it (Ctrl+C), click inside the blue window, paste it (right-click pastes in PowerShell, or Ctrl+V), press Enter.

copy this › irm https://claude.ai/install.ps1 | iex
Windows PowerShell
PS C:\Users\you> irm https://claude.ai/install.ps1 | iex
Downloading Claude Code…
Claude Code installed successfully.
Restart PowerShell, then run: claude

If it says "irm is not recognized" — your window says C:\ without the PS. That's Command Prompt, not PowerShell. Close it and redo step 1.

3
Install Git for Windows

Go to git-scm.com/downloads/win in your web browser, download the installer, run it, and click Next through every screen — the defaults are all correct.

Why: this quietly gives Claude a better set of tools for running commands. You'll never interact with it directly.

4
Close PowerShell, open it again

Close the blue window, then open it again exactly like step 1. Fresh windows are how the computer notices newly installed programs.

5
Check it worked

Type this and press Enter:

type this › claude --version
Windows PowerShell
PS C:\Users\you> claude --version
2.1.x (Claude Code)

Any version number = success. An error = troubleshooting #1 or #2 below.

02 — SIGN IN & SAY HELLO

Three steps and you're talking to it.

first-runStart Claude inside the project3 steps
1
Open a terminal in the project folder

Mac: in Finder, find the Unreal project folder your lead pointed you to. Right-click it → New Terminal at Folder (near the bottom of the menu).

Windows: open the project folder in File Explorer, click once in the address bar at the top, type powershell over what's there, press Enter.

Why it matters: started here, Claude can see the project, our shared skills, and the Unreal connection. Started anywhere else, it can't.

2
Type claude and press Enter
type this › claude
Terminal — your project folder
$ claude
✳ Welcome to Claude Code
Opening your browser to sign in…

Your web browser pops open a sign-in page. Sign in with your Lasting Light account — the one your lead gave you, not a personal one.

claude.ai/login
Sign in to Claude

Use your @lastinglight work account

Continue with your work email Continue with Google

First time only, Claude also asks you to approve this project's connections (the MCP servers). Say yes — they're ours, committed in the repo.

3
Say something

Back in the terminal, you'll see a box waiting for your message. Type like you'd text a colleague — no special language needed:

you › Hi! I'm new. What is this project, in one paragraph?

If Claude answers with a summary of our game — you're done. You are set up. Everything else on this page is connecting extra powers, and you can come back for it later.

03 — CONNECT THE MCPS

MCPs are how Claude gets hands.

An MCP is a plug-in connection that gives Claude new abilities — driving the Unreal editor, giving it new tools. One rule before the commands: where you add an MCP decides who gets it. Connections in the repo's .mcp.json file are shared with the whole team automatically; connections added "at user scope" are just for you — which is exactly right for anything that carries your personal API key.

unreal-mcpClaude ↔ the Unreal Editoralready set up for you
Good news: zero commands

The Unreal connection has two halves, and both come with the repo: an editor plugin in our Plugins/ folder (if the editor asks to enable or rebuild it on first launch, say yes), and the server entry in .mcp.json, which Claude Code picks up automatically when you start it in the project folder.

The one rule: the Unreal editor must be open for the live editor tools to work. No editor running = Claude has no hands.

Check it's alive

With the editor open, type /mcp in your Claude session. You want to see this:

Claude Code — /mcp
/mcp
MCP servers:
✔ unreal — connected

Then prove it end to end:

you › Using the Unreal MCP, list the actors in the currently open level.
anything-elseThe general recipe for any MCPpattern
Two shapes cover nearly everything

Hosted servers (a URL):

$ claude mcp add -s user --transport http <name> <url>

Local servers (a program on your machine):

$ claude mcp add <name> -- npx -y <package-name>

Same pattern for Supabase, Netlify, Slack, Notion — check each service's docs for its URL or package, and ask in the tools channel before installing anything unofficial. For real, verified commands rather than the generic shape — Notion, Figma, Linear, Blender, and more — see the MCPs & APIs for Design section.

Managing what you've added
$ claude mcp list
$ claude mcp get <name>
$ claude mcp remove <name>

And inside any session, /mcp shows live status for every connection, and is where you complete sign-in for servers that use OAuth.

Team rule

Shared tools go in the repo. Keys stay personal.

If you set up an MCP the whole team should have, don't post instructions in chat — add it to .mcp.json at project scope (with no secrets in it) and PR it, so everyone gets it on next pull. Anything that needs your API key gets added with -s user and never leaves your machine.

04 — WHEN IT FIGHTS YOU

The four failures and their fixes.

01

"claude: command not found" right after installing

Close the terminal completely and open a new one — the installer updates your setup, but only brand-new terminal windows see it. Still failing? Re-run the install command from section 01 and read its last line carefully.

02

Windows: "irm is not recognized" or "&& is not a valid statement separator"

You're in the wrong window. Look at your prompt: PS C:\ means PowerShell (correct for our commands). Plain C:\ without the PS means Command Prompt — close it and open PowerShell instead (section 01, step 1).

03

/mcp shows unreal as failed or missing

Checklist, in order: Is the Unreal editor actually open? Is the MCP plugin enabled (in Unreal: Edit → Plugins → search for our MCP plugin → check the box → restart the editor)? Did you start claude from inside the project folder? Did you approve the project's servers when first asked? One of those four is it, in that order of likelihood.

04

Signed in but Claude says no access

You signed into a personal account instead of the studio one. Type /login in the session and switch to your Lasting Light account. If the studio account itself doesn't work, that's a ticket to your lead — not a you-problem.

Done?

Setup complete. Two things next.

Now: find your department page and run its first "try it" prompt — that's your real day one. Print the Cheat Sheet and pin it to your desk. This week: take the free official course, Claude Code in Action — plan mode, permissions, automation, and verifying Claude's work. It will make everything on this site click faster.

← Back
Home