Welcome
This guide gets the FAR Expense Analyzer running on your own deployment in about 30 minutes.
Most of the technical work is done by an AI assistant called Claude Code. Your job is just to:
- Sign up for three accounts (GitHub, Vercel, Anthropic) in your browser
- Install Claude Code on your computer
- Tell Claude Code what you want, and click "Authorize" or "Approve" in the browser windows it opens
You won't write any code. You won't memorize commands. When something is unclear, you screenshot what you see and drop it into Claude — it reads the screen and tells you what to do.
What you'll need
Gather these now so nothing slows you down later.
- A computer with internet access
- An email address you can sign up with (work or personal)
- A phone, for the two-factor codes that GitHub and others may text you
- A credit card (only the AI vision API needs one — typical cost ~$3–4 per packet, with a spending cap you'll set)
- About 30 minutes of uninterrupted time
- A notepad app open to jot down passwords and the API key as you create them
If your work computer is locked down by IT (no installer permissions, no command line access), Claude Code might hit walls it can't get past on its own. If that happens, screenshot the blocker and email it to Brian — most can be worked around.
Sign up for GitHub
GitHub stores the source code. Free account, ~2 minutes.
- Go to github.com/signup
- Enter your email, pick a strong password
- Pick a username — your name or initials, lowercase, no spaces (e.g.
jhaggard). Write it down. - Verify your email when GitHub sends the link
- If GitHub asks you to set up two-factor authentication during signup, do it now — it'll be required later anyway, and getting it out of the way avoids a hiccup mid-setup.
Sign up for Vercel
Vercel is what makes the app live on a URL. Free tier, ~1 minute.
- Go to vercel.com/signup
- Click Continue with GitHub — this connects Vercel to the GitHub account you just made.
- GitHub will show an authorization screen. Click Authorize Vercel.
- Pick the Hobby plan (free). Skip the Pro upsell.
You'll land on your Vercel dashboard. GitHub and Vercel are now connected — that's all this step is doing.
Get an Anthropic API key
This pays for the AI vision calls that read your receipts. ~3 minutes.
- Go to console.anthropic.com (note: console, not claude.ai)
- Sign in or create an account.
- Left sidebar → Settings → Billing.
- Add a credit card. Put $20 of starter credit on the account.
- Set a monthly spending limit of $200 so you can never get a surprise bill. You can change this later.
- Left sidebar → API Keys.
- Click Create Key. Name it
far-expense-analyzer-delve. - Copy the key that appears. It looks like
sk-ant-api03-.... The full key is shown only once. Paste it into your notepad — Claude Code will ask you for it later.
Install Claude Code
This is your AI assistant for the rest of the setup.
- Go to claude.com/download
- Click Download for Mac. Open the downloaded
.dmgand drag Claude to your Applications folder. - Click Download for Windows. Run the installer, accept all defaults.
- Open Claude Code from your Applications folderStart menu.
- Sign in with your Anthropic account (same one as Step 5).
Tell Claude Code to set everything up
One prompt kicks off the whole technical setup. Claude does the rest, asking you for what it needs.
Open Claude Code. Paste this prompt (replacing BRIAN_REPO_URL with the link Brian sent you):
Hit send. Claude will start by checking what tools you have installed and offering to install anything missing.
When Claude asks: authorize GitHub
To clone and push code on your behalf, Claude needs you to log into GitHub once.
Claude will run a command called gh auth login. When it does:
- A browser tab opens to github.com/login/device
- It shows a one-time code (Claude also displays this code in the chat)
- Type or paste the code into the browser, click Continue
- GitHub asks you to confirm — review what permissions are being granted, click Authorize
- GitHub may ask for your two-factor code (from your phone's authenticator app or a text message). Enter it.
- Once you see "Congratulations, you're all set," go back to Claude Code. It'll continue automatically.
When Claude asks: paste your API key into Vercel
Vercel needs your Anthropic key + a site password. You add both yourself, in your browser.
This is the one step where Claude can't (and shouldn't) act for you — it never sees your API key, by design. Claude will tell you to:
- Open your Vercel project in the browser
- Go to Settings → Environment Variables
- Add two variables (each with both Production and Preview environments checked):
ANTHROPIC_API_KEY— paste the key you saved in Step 5 (starts withsk-ant-api03-...)FAR_SITE_PASSWORD— a password your team will type to log into the app. Pick something memorable likedelvefar2026. Write it down.
- Click Save after adding each one.
- Tell Claude when you're done — it'll trigger the first deploy.
When Claude asks: accept Upstash terms
Upstash is the free database for History + Feedback. You accept the terms in the browser, Claude does the rest.
Claude will install Upstash for Redis from the Vercel marketplace. When it does:
- A browser tab opens to vercel.com/.../accept-terms/upstash
- Read the terms. Click Accept.
- Tell Claude you've accepted — it'll continue setting up the database, connecting it to your project, and adding the new environment variables automatically.
Test it end to end
Verify the whole stack works with a real expense PDF.
Claude will give you a Vercel URL (like far-expense-analyzer-delve-xxx.vercel.app). Open it and add /far/login to the end.
- Type the
FAR_SITE_PASSWORDyou set in Step 9. You should see the app. - On the Review tab, drag any Vantagepoint expense PDF onto the drop zone.
- Wait ~60 seconds. The packet appears with a red/yellow/green status.
- Click into it. You should see line items, flags, and (where applicable) receipt thumbnails.
- Click History — your packet is listed there.
- Click Claude Feedback (top right). Type a test note. Send. Reload — it should still be there.
If all of those work, your deployment is fully functional.
You're live
Quick reference for going forward.
Daily use: open your Vercel URL, log in, drop a PDF on the Review tab, wait ~60 seconds, click into the packet, click "Export checklist" to download a printable HTML file with receipts inline.
Updating to new versions: when Brian commits a fix, your fork doesn't auto-update. Open Claude Code and say "sync my fork with Brian's repo" — it handles the rest. Vercel auto-redeploys within a minute.
If something breaks: screenshot the error, drop it in Claude Code, ask in plain English. It can read all the code and walk you through fixes.
If the API runs out of credit: go to console.anthropic.com → Billing → add more. The site works again immediately, no redeploy needed.
To share with your team: send them your Vercel URL plus the FAR_SITE_PASSWORD you set. Anyone with both can use the tool.