Supabase in Claude Code.
Claude Code can work on your Supabase databases, but any change to a live project needs your OK. This is for Claude Code on your own Mac or Linux computer.
passed Nov 16 · Supabase CLI
fieldtrip add supabaseNew to fieldtrip? Install it first: curl -fsSL fieldtrip.sh/install | sh
Claude Code can
- Read your data and your database setup.
- Write database changes and test them locally.
- Look things up in your live database.
Asks you first
- Change your live database.
- Deploy or delete functions.
- Change secrets or delete a project.
Try asking Claude Code
Paste one into Claude Code. Underneath: what it runs.
How many rows are in my polls table?
supabase db query --remote --read-only "select count(*) from polls"Write a migration that adds a votes table.
supabase migration new add_votes_tableMake TypeScript types from my live database.
supabase gen types --remote --lang typescriptAny security warnings on my database?
supabase db advisors --remoteDeploy the send-email function.
supabase functions deploy send-email --yesasks you first
How it’s set up for Claude Code
| the key | In Claude Code's own settings, ~/.claude/settings.json. Only the commands Claude Code runs can see it. Your Terminal can't. |
|---|---|
| the note | Saved as a Claude Code skill, ~/.claude/skills/supabase. Claude Code reads it when you ask about Supabase. It says how to use Supabase, and what to check with you about first. |
| after setup | Quit Claude Code fully and reopen it. It reads its settings when it starts. |
| two checks | Unless you've turned it off, Claude Code also asks before it runs a command. fieldtrip's note adds a second check, on top of that one. |
| check it | Ask Claude Code on your computer to run fieldtrip doctor. It should say “Running in Claude Code” and show a ✓ beside Supabase. |
Do this once.
- Make an access key on Supabase, for only the projects you want your AI to access. fieldtrip will give you the link and tell you which boxes to tick, and why.
- Paste your key when fieldtrip asks you to.
Your key goes into your Terminal when fieldtrip asks. It never goes through Claude Code’s chat.
Checked every night
Yes. Supabase 3.2.0 passed all five checks, Mon, Nov 16 · 11:09 AM CST.
Each square is one night.
Claude Code on the web
When you use Claude Code at claude.ai/code, it runs on a computer in the cloud, not yours. It can use Supabase’s tool there too, but fieldtrip can’t set it up for you yet: you’d store your key as a secret in the cloud environment’s settings and install the tool yourself. We’ve done it by hand with Linear; Supabase hasn’t been tested there yet.
← All of Supabase: every AI, every version · Supabase in Codex → · Supabase in Cursor → · What’s a CLI?