From 33f1bdd412a386307358ffd3e3e088c61bee32c8 Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Fri, 27 Mar 2026 16:11:16 +0500 Subject: [PATCH] added installation guide --- tutorial/day0/{Day0.md => README.md} | 19 +++- tutorial/day0/linux.md | 4 +- tutorial/day0/mac.md | 4 +- tutorial/day0/windows.md | 125 ++++++--------------------- 4 files changed, 47 insertions(+), 105 deletions(-) rename tutorial/day0/{Day0.md => README.md} (62%) diff --git a/tutorial/day0/Day0.md b/tutorial/day0/README.md similarity index 62% rename from tutorial/day0/Day0.md rename to tutorial/day0/README.md index e0e51bb..595777f 100644 --- a/tutorial/day0/Day0.md +++ b/tutorial/day0/README.md @@ -39,10 +39,23 @@ Run `claude` in your terminal. On first launch, it will ask you to choose a logi - Browser opens — sign in and authorize - Return to terminal, you're logged in -### Method 2: API Key (Pay-as-you-go) +### Method 2a: API Key (Team Invite) -- Go to [console.anthropic.com](https://console.anthropic.com) → **API Keys** → **Create Key** -- Select **Anthropic API Key** in the prompt +Your team admin invites you from the Anthropic dashboard. + +- You receive an **invite email** — accept it and create your Anthropic account +- Run `claude` in your terminal +- Select **Anthropic API Key** +- Your key is **auto-generated** on the dashboard — no manual setup needed +- Claude Code starts working immediately + +### Method 2b: API Key (You have the key) + +If someone shared the key with you (via Slack, email, etc.) or you created your own: + +- Run `claude` in your terminal +- Select **Anthropic API Key** - Paste your key (starts with `sk-ant-`) +- The key is **stored permanently** — you won't be asked again --- \ No newline at end of file diff --git a/tutorial/day0/linux.md b/tutorial/day0/linux.md index 9151b79..bdcefab 100644 --- a/tutorial/day0/linux.md +++ b/tutorial/day0/linux.md @@ -1,6 +1,6 @@ # Linux Setup -[Back to Day 0](Day0.md) +[Back to Day 0](README.md) ## Prerequisites @@ -108,7 +108,7 @@ npm install -g @anthropic-ai/claude-code claude --version ``` -You should see the Claude Code version printed. Now head back to [Day0.md](Day0.md) for authentication setup. +You should see the Claude Code version printed. Now head back to [README.md](README.md) for authentication setup. --- diff --git a/tutorial/day0/mac.md b/tutorial/day0/mac.md index e46c813..b159ba9 100644 --- a/tutorial/day0/mac.md +++ b/tutorial/day0/mac.md @@ -1,6 +1,6 @@ # macOS Setup -[Back to Day 0](Day0.md) +[Back to Day 0](README.md) --- @@ -29,4 +29,4 @@ --- -Now head back to [Day0.md](Day0.md) for authentication setup. +Now head back to [README.md](README.md) for authentication setup. diff --git a/tutorial/day0/windows.md b/tutorial/day0/windows.md index a086842..1a135ce 100644 --- a/tutorial/day0/windows.md +++ b/tutorial/day0/windows.md @@ -1,104 +1,33 @@ # Windows Setup -[Back to Day 0](Day0.md) - -## Prerequisites - -You need **Node.js v18 or higher** and **npm** (bundled with Node.js). - -## Step 1: Install Node.js - -### Option A: Via nodejs.org Download Page with fnm (Recommended) - -**fnm** (Fast Node Manager) is officially recommended by Node.js. It's fast, lightweight, and lets you switch Node versions easily if needed later. - -1. Open your browser and go to [nodejs.org/en/download](https://nodejs.org/en/download). - -2. You'll see a row of dropdowns that says: **"Get Node.js® vXX.XX.X (LTS) for __ using __ with __"**. Set the dropdowns as follows: - - | Dropdown | Select | - |----------|--------| - | Version | **vXX.XX.X (LTS)** — keep the default LTS version, don't change it | - | OS | **Windows** | - | Package Manager | **fnm** (under "Recommended (Official)") | - | Package Format | **npm** — keep the default | - -3. The page will show you the exact commands to run. Open **PowerShell as Administrator** (right-click the Start menu > "Terminal (Admin)" or search for PowerShell > right-click > "Run as administrator"). - -4. Copy and paste the commands from the page. They will look something like this: - - ```powershell - # Step 1 — Install fnm - winget install Schniz.fnm - - # Step 2 — Configure fnm environment (add to your PowerShell profile) - fnm env --use-on-cd --shell powershell | Out-String | Invoke-Expression - - # Step 3 — Install Node.js - fnm install 24 # The page will show the exact version number - ``` - - > The version number may differ from above — always use whatever the website shows. - -5. **Close and reopen your terminal** after installation. This is important so that `node` and `npm` are available in your PATH. - -> **Why fnm?** It's in the "Recommended (Official)" category on the Node.js download page, installs in seconds (written in Rust), and works natively on Windows — unlike nvm which requires a separate community port for Windows. - -### Option B: Official .msi Installer (Alternative) - -If you prefer a traditional installer: - -1. Go to [nodejs.org](https://nodejs.org). The homepage shows a big **"Download Node.js (LTS)"** button. -2. Click it to download the `.msi` file. -3. Run the installer: - - Click **Next** through the wizard. - - Accept the license agreement. - - Keep the default install location (`C:\Program Files\nodejs\`). - - On the "Tools for Native Modules" screen, **check the box** for "Automatically install the necessary tools" — this installs build tools you may need later. - - Click **Install** and wait for it to finish. -4. **Restart your terminal** after installation. - -### Option C: Using winget (One-liner) - -If you have `winget` (built into Windows 10/11): - -```powershell -winget install OpenJS.NodeJS.LTS -``` - -Close and reopen your terminal after installation. - -## Step 2: Verify Node.js - -Open a **new** terminal (Command Prompt, PowerShell, or Windows Terminal) and run: - -```powershell -node --version -npm --version -``` - -Both commands should print version numbers. If you get "not recognized", restart your terminal or check that Node.js is in your PATH. - -## Step 3: Install Claude Code - -```powershell -npm install -g @anthropic-ai/claude-code -``` - -> If you get a permission error, open your terminal as **Administrator** (right-click > Run as administrator) and run the command again. - -## Step 4: Verify Claude Code - -```powershell -claude --version -``` - -You should see the Claude Code version printed. Now head back to [Day0.md](Day0.md) for authentication setup. +[Back to Day 0](README.md) --- -## Notes +**Node.js** +- Go to [nodejs.org](https://nodejs.org) +- Click the **"Download Node.js (LTS)"** button — this downloads the `.msi` installer +- Run the `.msi` file and click **Next** through the wizard +- Accept the defaults, click **Install**, wait for it to finish -- **Recommended terminal:** Windows Terminal or PowerShell. The classic Command Prompt works but has limited features. -- **WSL users:** If you prefer running Claude Code inside WSL (Windows Subsystem for Linux), follow the [Linux guide](linux.md) instead — WSL is a full Linux environment. -- **PATH issues:** If `claude` is not recognized after install, npm's global bin directory may not be in your PATH. Run `npm config get prefix` to find it, then add the resulting path to your system's PATH environment variable. +**Verify Node.js** +- Open a **new** terminal (PowerShell or Windows Terminal) and run: + ```powershell + node --version + npm --version + ``` + +**Claude Code** +- ```powershell + npm install -g @anthropic-ai/claude-code + ``` +- If you get a permission error, run your terminal as **Administrator** (right-click > Run as administrator) + +**Verify** +- ```powershell + claude --version + ``` + +--- + +Now head back to [README.md](README.md) for authentication setup.