fieldtrip
tools / databases / supabase / claude code

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 supabase

New 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 it’s set up for Claude Code

the keyIn Claude Code's own settings, ~/.claude/settings.json. Only the commands Claude Code runs can see it. Your Terminal can't.
the noteSaved 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 setupQuit Claude Code fully and reopen it. It reads its settings when it starts.
two checksUnless 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 itAsk Claude Code on your computer to run fieldtrip doctor. It should say “Running in Claude Code” and show a ✓ beside Supabase.

Do this once.

  1. 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.
  2. 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?