Inkbox > # Documentation index > Fetch the complete documentation index at: https://inkbox.ai/sitemap.xml > Use this file to discover all available pages before exploring further. --- # Claude Code plugin description: Connect a Claude Code agent to Inkbox email, phone, iMessage, and tunnel capabilities --- # Claude Code plugin The [Inkbox Claude Code plugin](https://github.com/inkbox-ai/claude-code-plugin) is a standalone bridge for [Claude Code](https://claude.com/claude-code). It connects a Claude Code agent to an Inkbox identity and supports email, SMS/MMS and voice calls, iMessage, and an Inkbox tunnel when those channels are configured. This is a harness plugin, not an Inkbox SDK skill or marketplace bundle. It runs a persistent gateway that turns inbound messages and calls into real Claude Code sessions with access to the project directory you choose. [View plugin on GitHub](https://github.com/inkbox-ai/claude-code-plugin) ## Prerequisites - [Claude Code](https://claude.com/claude-code) installed and logged in - Python 3.11 or newer - macOS or Linux You do not need to create an Inkbox identity first. The setup wizard can sign up a new agent or connect an existing agent-scoped API key. ## Install Run the one-command installer: ```bash curl -fsSL https://raw.githubusercontent.com/inkbox-ai/claude-code-plugin/main/install.sh | bash ``` The installer creates an isolated environment, adds `inkbox-claude` to your path, and launches the setup wizard. The wizard: - creates or connects an Inkbox agent - offers to provision a phone number - offers to connect iMessage - configures signed inbound messaging - asks which project directory Claude Code should work in - offers to keep the gateway running in the background and after restarts Re-running the installer or `inkbox-claude setup` is safe when you need to change the configuration. ## Run the gateway Check the configuration, then start the gateway if the setup wizard did not already start it: ```bash inkbox-claude doctor inkbox-claude start inkbox-claude status ``` Use these commands to manage it later: ```bash inkbox-claude run # run in the foreground inkbox-claude restart # restart the background gateway inkbox-claude stop # stop the background gateway inkbox-claude status # show status and log location ``` Keep the gateway running. On startup it opens an Inkbox tunnel, configures the identity's inbound channels, and routes configured email, SMS/MMS, iMessage, and call channels into Claude Code sessions. ## Available capabilities Depending on your setup choices and account availability, your Claude Code agent can have: - **An email address** - send, receive, and reply from an Inkbox mailbox - **A phone number, when available** - SMS/MMS and voice calls, inbound and outbound - **iMessage, when connected** - continue the same agent conversation from an iMessage thread - **An Inkbox tunnel** - inbound messages and calls reach the local gateway without a public server - **Persistent Claude Code sessions** - each contact keeps one conversation across configured email, text, iMessage, and call channels - **Remote permission prompts** - approve or reject Claude Code tool requests from the channel you are using Claude Code also receives Inkbox tools for sending messages, placing calls, reading conversation history, managing contacts, and delegating work to other agents. ## What Inkbox adds | Capability | Claude Code alone | With Inkbox plugin | | --- | --- | --- | | Agent-owned mailbox | Bring your own integration | Built in | | SMS/MMS and voice calls | Bring your own integration | Available when configured | | iMessage | Bring your own integration | Available when configured | | Inbound webhook and call tunnel | Bring your own server | Built in | | Continue one session across channels | Terminal session only | Built in | | Approve tool requests remotely | At the terminal | Reply from the active channel | Claude Code itself stays upstream. The plugin adds the Inkbox identity, gateway, channel routing, session continuity, messaging tools, and setup commands without requiring a Claude Code fork. ## Permission prompts Read-only work can proceed without interrupting you. When Claude Code wants to run a command or change files, the plugin pauses the tool call and sends you a short approval prompt. Reply to allow it once, allow that kind of action for the current session, or reject it. Questions from Claude Code are delivered as numbered choices. Your next reply answers the pending question instead of starting a separate turn. ## After install Run a health check: ```bash inkbox-claude doctor inkbox-claude status ``` Use any channels you configured. If the agent has a phone number, text `START` to it from every phone the agent needs to text. You can also email the agent mailbox, connect over iMessage when enabled, or call the agent phone number when available. The gateway routes each configured channel into Claude Code and returns the response on the channel you most recently used. ## Related - [Inkbox Claude Code plugin on GitHub](https://github.com/inkbox-ai/claude-code-plugin) - [Claude Code](https://claude.com/claude-code) - [Manage reachability in the Inkbox Console](https://inkbox.ai/console)