ZeptapDocs

Use your own AI account

Connect Zeptap's chat to a Claude subscription, a ChatGPT subscription (via Codex) or an OpenRouter API key - setup steps, where credentials are stored, and status fixes.

Zeptap's chat runs on an AI account you already have, and you pay that provider directly: nothing extra when a subscription covers it. Set up any or all of the three in Settings (⌘,) › Agents (also a step of first-run setup), then switch between them from the model picker under the message box.

OptionNeedsPays withModels
ClaudeA Claude plan that includes Claude Code, such as Pro or MaxThe subscriptionThose Claude Code offers on the plan
ChatGPT (Codex)A ChatGPT plan that includes Codex, such as Plus or ProThe subscriptionThose Codex offers on the plan
OpenRouterAn OpenRouter API key with creditPay per useEvery OpenRouter model that calls tools and reads images: Claude, GPT, Gemini and more

Setup

Each option is done when its card in Settings › Agents shows Connected.

Runs Anthropic's official Claude Code CLI on the Mac, signed in to your Claude account. If claude is already signed in on this Mac, the card shows Connected straight away.

  1. Open Settings › Agents › Claude Code.
  2. On Not installed, click Install Claude Code (Anthropic's installer).
  3. Click Sign In; the browser opens Claude's sign-in page.
  4. Sign in, paste the code the browser shows into Paste the code from your browser, and click Submit.

Switch Account signs in with a different account.

Where credentials live

OptionStored byWhere
ClaudeClaude CodeIts own sign-in, shared with the claude command
ChatGPTCodexIts own sign-in, shared with the codex command
OpenRouterZeptapThe Mac's login keychain, this Mac only (not synced to iCloud)

Zeptap sends the OpenRouter key only to OpenRouter; agents and the MCP server never see it. Screenshots and messages go only to the provider in use, under its terms.

Status and fixes

Card showsMeaningFix
ConnectedReady
Not installedThe CLI isn't on this MacInstall
Not signed inThe CLI is signed outSign In
No API keyNo OpenRouter key, or OpenRouter rejected itPaste a working key, Save
UnverifiedThe status check failed; the agent may still workThe card's refresh button; check the network

Same account, from the terminal

The Claude Code and Codex tabs also offer Use Zeptap from Claude Code sessions (or Codex sessions), which adds Zeptap's MCP server to that CLI so terminal sessions can drive the iPhone too. Connect an agent covers this and other agents such as Cursor and Claude Desktop.

On this page