Agent Adapters

When you create an agent in Paperclip, one of the first things you configure is its adapter. The adapter is the bridge between Paperclip and the AI system that actually runs your agent — it tells Pap…

Agent Adapters

Think of it like a power adapter for different countries. The electricity (Paperclip's task system and org chart) is the same everywhere, but the plug you need depends on the socket (the AI runtime you're connecting to). Claude Code needs one configuration, OpenAI Codex needs another, and a custom cloud-based agent needs a third.

Without an adapter, an agent is just a record in a database. With one, it's a working member of your team.

---

Adapter comparison

| Adapter | Best for | Requires | |---|---|---| | claudelocal | Most users — runs Claude on your Mac | Claude Code installed, Anthropic API key | | codexlocal | OpenAI users — runs Codex on your Mac | Codex CLI installed, OpenAI API key | | geminilocal | Gemini users — runs Gemini CLI on your Mac | Gemini CLI installed, Google credentials | | opencodelocal | Multi-provider flexibility, switchable models | OpenCode CLI installed, relevant API keys | | cursor | Users already working inside Cursor | Cursor installed and configured | | pilocal | Pi users wanting Pi's built-in tool set | Pi CLI installed, relevant API keys | | hermeslocal | Persistent memory, 30+ tools, 80+ skills | Hermes Agent installed (Python 3.10+) |

For most people getting started, claudelocal is the right choice. It runs directly on your Mac using the same Claude that powers Anthropic's Claude.ai, and it only needs Claude Code plus an API key wired through environment variables.

!Adapter type dropdown showing all available options (/uploads/content/2026/04/db663ff0-8e46-42cb-8aba-e9d0e76dec08.webp)

---