OrgAI Lab — Oppsettguide for workshop

Alt du trenger for å komme i gang. Følg stegene i rekkefølge.

Du trenger ikke betale for noe. Alle verktøyene du installerer her (Node.js, Git, Claude Code) er gratis. Under workshopen dekkes Claude Code-bruken av NHH gjennom delte API-nøkler. Du trenger ikke opprette en konto eller oppgi betalingsinformasjon.

Før du begynner: Hva er en terminal?

En terminal er et tekstbasert vindu der du skriver kommandoer. I stedet for å klikke på knapper, skriver du en kommando og trykker Enter. Du bruker terminalen til å installere verktøy og kjøre plattformen.

Du trenger ikke forstå kommandoene. Bare kopier og lim inn nøyaktig som vist.

Slik åpner du en terminal

macOS:

Trykk Cmd + Space for å åpne Spotlight
Skriv Terminal og trykk Enter

Windows:

Trykk Windows-tasten
Skriv PowerShell og trykk Enter
Et blått vindu skal dukke opp. Dette er terminalen din

Windows-brukere: Alle Windows-instruksjoner i denne guiden er for PowerShell (det blå vinduet). Ikke bruk den eldre «Command Prompt» (svart vindu). Noen kommandoer fungerer ikke der.

Hold terminalen åpen gjennom hele oppsettet. Alle kommandoer nedenfor skal skrives (eller limes inn) i dette vinduet.

Forutsetninger (installer gjerne hjemme på forhånd)

Installer disse før workshopen om mulig:

1. Node.js

Node.js er et program som kjører OrgAI Lab-plattformen. Du bruker det ikke direkte, det må bare være installert.

Gå til nodejs.org
Trykk på den grønne knappen «Get Node.js»
Nedlastingssiden velger riktig versjon for din maskin. Sjekk at det står Windows Installer (.msi) eller macOS Installer (.pkg), og last ned
Kjør installasjonsprogrammet og godta alle standardvalg

Etter installasjonen, sjekk at det fungerer ved å lime inn dette i terminalen og trykke Enter:

node --version

Du skal se et versjonsnummer som begynner med v24 eller høyere (f.eks. v24.x.x). Versjon v22 fungerer også.

2. Git for Windows (kun Windows)

Windows-brukere trenger også Git:

Gå til git-scm.com/install/windows
Klikk «Click here to download» og kjør installasjonsprogrammet
Godta alle standardvalg
Sjekk at bash er tilgjengelig (Claude Code trenger dette). Åpne en ny PowerShell og skriv:
```
bash --version
```
Du skal se noe som begynner med GNU bash, version 5. Hvis du får en feilmelding, er bash ikke på PATH. Kjør dette:
```
$env:Path += ";C:\Program Files\Git\bin"
```
Prøv bash --version igjen. Fungerer det fortsatt ikke (f.eks. hvis du installerte Git uten admin-rettigheter), prøv i stedet:
```
$env:Path += ";$env:USERPROFILE\AppData\Local\Programs\Git\bin"
```
Denne PATH-endringen gjelder bare for dette terminalvinduet. Hvis du åpner en ny PowerShell, må du kjøre den igjen. Du kan legge mappen permanent i PATH via «Rediger miljøvariabler for kontoen din» i Windows-innstillinger.

Mac-brukere kan hoppe over dette, for Git er allerede installert.

Steg 1 — Installer Claude Code (gjøres i workshopen)

Claude Code er AI-verktøyet du skal bruke i workshopen. Lim inn kommandoen for ditt operativsystem i terminalen:

Windows: Installasjonen finner ikke bash? Gå tilbake til forutsetning 2 (Git for Windows) og sjekk at bash --version fungerer i terminalen din. Du kan også sette banen direkte: $env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe" (eller "$env:USERPROFILE\AppData\Local\Programs\Git\bin\bash.exe" uten admin-rettigheter).

PATH-advarsel etter installasjon? Hvis installasjonsprogrammet sier .local\bin is not in your PATH, legg til mappen det nevner i bruker-PATH (søk etter «miljøvariabler» i Windows-innstillinger), og start PowerShell på nytt før du fortsetter.

macOS:

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

Windows (PowerShell):

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

Når installasjonen er ferdig, sjekk at det fungerer:

claude --version

Hvis du ser et versjonsnummer er alt i orden. Hvis du får en feilmelding, lukk terminalen, åpne en ny, og prøv claude --version igjen.

Har du allerede Claude Code installert? Flott, hopp over installasjonskommandoen og bare sjekk med claude --version. Du trenger ikke logge ut eller endre kontoen din. Setup-scriptet i Steg 3 setter miljøvariabler som automatisk bytter Claude Code til workshopens delte nøkler for denne terminaløkten. Din personlige konto påvirkes ikke og fungerer som normalt i andre terminalvinduer.

Steg 2 — Last ned OrgAI Lab

Du får to nedlastingslenker fra foreleseren. En for plattformen (en .tar.gz-fil) og en for setup-scriptet.

Lim inn kommandoene nedenfor. Bytt ut hele <PLATFORM_URL> (inkludert < og >) med lenken du fikk fra foreleseren:

macOS:

curl -fsSL "<PLATFORM_URL>" -o orgai-lab.tar.gz
mkdir -p ~/orgai-lab
tar -xzf orgai-lab.tar.gz -C ~/orgai-lab --strip-components=1

Windows (PowerShell):

curl.exe -fsSL "<PLATFORM_URL>" -o orgai-lab.tar.gz
mkdir -Force $env:USERPROFILE\orgai-lab | Out-Null
tar -xzf orgai-lab.tar.gz -C $env:USERPROFILE\orgai-lab --strip-components=1

Disse kommandoene laster ned en komprimert fil, oppretter en mappe, og pakker ut plattformen. Du trenger ikke forstå detaljene. Bare lim inn og trykk Enter.

Steg 3 — Kjør setup-scriptet

Last ned setup-scriptet til orgai-lab-mappen din. Bytt ut hele <SETUP_SCRIPT_URL> (inkludert < og >) med lenken fra foreleseren. Kjør det deretter.

Setup-scriptet gjør to ting:

Setter opp Claude Code-nøkler i terminaløkten din (slik at du kan kjøre claude)
Skriver plattformnøkler til en fil (.env) slik at plattformen kan bruke AI-evalueringsfunksjonene

macOS:

cd ~/orgai-lab
curl -fsSL "<SETUP_SCRIPT_URL>" -o workshop-setup.sh
source ./workshop-setup.sh

Viktig (macOS): Du må bruke source foran kommandoen. Hvis du bare skriver ./workshop-setup.sh, vil ikke API-nøklene bli tilgjengelige i terminalen din.

Windows (PowerShell):

cd $env:USERPROFILE\orgai-lab
curl.exe -fsSL "<SETUP_SCRIPT_URL>" -o workshop-setup.ps1
Get-Content .\workshop-setup.ps1 -Raw | iex

Du skal se en grønn bekreftelsesmelding med ressursnavn og modellversjoner. Hvis ikke, spør om hjelp.

Steg 4 — Start plattformen

Du trenger to terminalvinduer: ett for plattformen og ett for Claude Code. Plattformen kjører kontinuerlig i sitt eget vindu. Terminalen du har brukt til nå blir Terminal 1 (for Claude Code).

Åpne et nytt terminalvindu — dette blir Terminal 2 (for plattformen):

macOS: trykk Cmd + N i Terminal
Windows: åpne PowerShell fra startmenyen igjen

Start plattformen i Terminal 2:

macOS:

cd ~/orgai-lab
./start.sh

Windows (PowerShell):

cd $env:USERPROFILE\orgai-lab
.\start.ps1

Nettleseren skal åpne seg automatisk til oppsett-siden. Hvis den ikke gjør det, åpne nettleseren og gå til http://localhost:3000/setup.

Du trenger ikke kjøre setup-scriptet igjen i dette vinduet. Plattformen leser nøklene sine fra .env-filen som setup-scriptet opprettet i Steg 3.

Steg 5 — Sjekk at alt fungerer

På oppsett-siden, sjekk at:

Alle helsesjekker viser grønne haker
Kom-i-gang-guiden er synlig

Bytt deretter tilbake til Terminal 1 (der du kjørte setup-scriptet) og skriv:

claude --version

Hvis du ser et versjonsnummer, er du klar for workshopen! Du har nå:

Terminal 1 — for å kjøre Claude Code (claude)
Terminal 2 — kjører plattformen (la den stå åpen)

Feilsøking

Problem	Løsning
`claude: command not found`	Lukk terminalen, åpne en ny, og prøv igjen. Hvis det fortsatt ikke fungerer: macOS — kjør `echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc`, prøv deretter `claude --version`. Windows — sjekk at mappen installasjonsprogrammet nevnte er i PATH (se PATH-advarselen i Steg 1). Hvis ingenting hjelper, kjør installasjonskommandoen fra Steg 1 på nytt.
`node: command not found`	Installer Node.js fra nodejs.org (se Forutsetninger ovenfor).
Node.js-versjon for gammel	Kjør `node --version`. Hvis den er lavere enn v22, last ned LTS-versjonen fra nodejs.org.
Autentiseringsfeil (Claude Code)	Sjekk at du kjørte setup-scriptet (Steg 3) i samme terminal der du bruker `claude`. Hvis du har lukket terminalen, kjør setup-scriptet på nytt.
AI-evaluering kjører ikke	Plattformen leser nøkler fra `.env`-filen som setup-scriptet oppretter. Hvis den mangler, kjør setup-scriptet (Steg 3) på nytt og start plattformen på nytt.
Claude Code-installasjon feiler — finner ikke bash (Windows)	Gå tilbake til forutsetning 2 og kjør `bash --version`. Hvis det feiler, kjør `$env:Path += ";C:\Program Files\Git\bin"` (eller `$env:Path += ";$env:USERPROFILE\AppData\Local\Programs\Git\bin"` uten admin) og prøv igjen. Alternativt: `$env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"`.
Script kjører ikke (Windows)	Bruk `Get-Content .\workshop-setup.ps1 -Raw \| iex` i stedet for `. .\workshop-setup.ps1`. Dette omgår restriksjoner for kjøring av script.
Plattformen starter ikke	Sjekk at Node.js er installert: `node --version`. Du trenger v22 eller høyere.
Port allerede i bruk	Lukk programmet som bruker port 3000 og prøv igjen. Du kan også sette en annen port: kjør `PORT=4000 ./start.sh` (macOS) eller `$env:PORT=4000; .\start.ps1` (Windows) før du starter.
Noe annet	Kjør `claude doctor` i terminalen for en diagnostisk sjekk, eller spør foreleseren.

Greit å vite

Claude Code-nøkler varer bare for gjeldende terminaløkt. Hvis du lukker terminalen der du kjørte setup-scriptet, åpne en ny og kjør setup-scriptet (Steg 3) igjen før du bruker claude.
Plattformnøkler lagres i en fil. Plattformen leser nøklene sine fra .env-filen som setup-scriptet opprettet. Du kan starte plattformen på nytt uten å kjøre setup-scriptet igjen.
Plattformen og Claude Code er uavhengige. Du kan starte den ene på nytt uten at det påvirker den andre.
Vennligst ikke del API-nøklene utenfor denne workshopen.
Oppdatere plattformen? Hvis foreleseren ber deg laste ned en ny versjon, stopp plattformen (trykk Ctrl + C i Terminal 2) og kjør:

macOS:

cd ~/orgai-lab
curl -fsSL "<PLATFORM_URL>" -o orgai-lab.tar.gz
tar -xzf orgai-lab.tar.gz -C ~/orgai-lab --strip-components=1
./start.sh

Windows (PowerShell):

cd "$env:USERPROFILE\orgai-lab"
curl.exe -fsSL "<PLATFORM_URL>" -o orgai-lab.tar.gz
tar -xzf orgai-lab.tar.gz --strip-components=1
.\start.ps1

Bytt ut <PLATFORM_URL> med den nye lenken fra foreleseren. Setup-scriptet trenger ikke kjøres på nytt.