Setup - Documentation as Code

1

Open Terminal

Open PowerShell

The terminal is how you give direct commands to your computer. Press Command (⌘) + Space, type Terminal, and press Enter.

PowerShell is Windows' built-in terminal for running commands. Press the Windows key, type PowerShell, right-click the result, and choose Run as administrator. Click Yes when asked.

2

Install Homebrew

Homebrew is a package manager: it installs developer tools from the terminal so you don't need separate installers. We use it to install Git. Paste the line below and press Enter. It will ask for your Mac password.

Terminal

% /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

This takes 2-5 minutes. Press Enter if it asks for confirmation mid-install.

3

Install Git

Git tracks every change to the knowledge base and syncs it across the team. Each edit is recorded with who made it and when. Nothing gets lost or overwritten silently.

Terminal

% brew install git

PS

Administrator: Windows PowerShell

PS> winget install --id Git.Git -e

4

Install Claude Code

Claude Code is an AI you work with in the terminal. It reads files, writes content, and runs commands on your behalf.

Terminal

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

PS

Administrator: Windows PowerShell

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

5

Install Obsidian

Obsidian is where you read and write the knowledge base. It works with plain text files, which are also easy for Claude to read and edit directly.

Terminal

% brew install --cask obsidian

PS

Administrator: Windows PowerShell

PS> winget install --id Obsidian.Obsidian -e

✦

Start Claude and sign in

Type claude and press Enter. A browser window opens for sign-in. Once you're in, Claude is ready to use.

Terminal

% claude

PS

Administrator: Windows PowerShell

PS> claude

Sign in with the Claude account you set up at the start. Claude Code needs an active paid plan (Pro or Max) to run.