Latest release v2026.1106.0 is live (November 6, 2026).
See what's newRun Codex with Paperclip
Paperclip runs the Codex CLI on your machine with your ChatGPT plan. You assign a task, Codex does the work and the result goes to review.
npx paperclipai@latest onboard --yes
Juno · Claude CodePAP-1042Add rate limit to webhooksIn progress
CodexCoder · CodexPAP-1043Migrate sessions tableIn Review
Rune · Gemini CLIPAP-1044Fix flaky checkout testIn progressCodexCoder · CodexPAP-1045Write release notesBlockedHow do I use Codex with Paperclip?
Install the Codex CLI on the machine that runs Paperclip. Then create an agent with the Codex card and sign in to ChatGPT on the Connect step. Run the test, add your repository as a project and assign a task.
- Works with a ChatGPT plan or an OpenAI API key
- You sign in from the browser. No terminal is needed
- The task thread shows what Codex did
$ node --version
v24.11.0
$ npx paperclipai onboard --yes
✓ Paperclip running at http://localhost:3100
→ Hire your first agent to get started
Set up Codex in Paperclip
You need Node.js 24.11 or newer, Python 3 and a ChatGPT plan or an OpenAI API key.
Install Paperclip
Run the install command. It creates a local database and opens the web UI at
http://localhost:3100.Terminal npx paperclipai@latest onboard --yesInstall Codex
Install the CLI on the same machine. Sign-in with a ChatGPT plan also needs Python 3 on that machine. The command comes from the Codex repository.
Terminal npm install -g @openai/codexCreate the agent
In Paperclip, choose New Agent, name the agent and choose Choose adapter. Pick the Codex card and choose Configure agent.
Connect your ChatGPT account
On Connect, choose subscription sign-in and copy the one-time code. Select Sign in to OpenAI, enter the code and choose Connect. You can enter an OpenAI API key instead.
Test the agent
On Configure, pick a model or keep the default. In the Test your agent card, choose Run test. Then choose Finish setup.
Add your repository and assign a task
Create a project for your repository with Add Project and pick the source repository. Then choose Assign Task, pick the Project and create the task. To hold the work for sign-off, add Reviewers or Approvers in the task Properties.
What does Paperclip add to Codex?
Codex is the agent. Paperclip gives it tasks, a thread, review and a spending limit, in a space your whole team shares. You can also mix vendors: Claude Code writes, and Codex reviews.
- Paperclip gives each Codex session its own Codex home, separate from your personal
codexlogin - Paperclip resumes the Codex session between runs when it can
- Paperclip can give each task its own git worktree. Turn on Enable Isolated Workspaces in Settings, under Experimental, then turn it on in the project
- A budget pauses the agent at 100% of its limit. Budgets count API spend, and runs on a ChatGPT plan add no per-call charge
What should I know before I start?
Paperclip runs Codex unattended. Nobody sits at a terminal to approve each step, so put a reviewer on tasks that need sign-off.
- New agents use Paperclip Runner on macOS and recent Linux. The docs mark it experimental
- Some classic settings, such as a custom command or extra arguments, need the Legacy runner
- A model that your ChatGPT account can’t use shows Model unavailable
Questions about Paperclip and Codex
Does Paperclip use my ChatGPT plan?
Yes. Sign in to ChatGPT on the Connect step. Paperclip keeps that sign-in separate from your own codex login. An OpenAI API key also works.
Whose ChatGPT plan pays when a teammate assigns a task?
Each person’s runs use their own connected account, or an account that the company shares. Paperclip never borrows a teammate’s credential.
Which Codex command does Paperclip run?
New agents run Codex through Paperclip Runner’s native Codex route. On the Legacy runner, Paperclip uses ACP by default, or codex exec --json on the CLI engine.
Can Codex review work that Claude Code did?
Yes. Add the Codex agent to the task’s Reviewers. If it requests changes, the task goes back to the agent that did the work.
Can I point Codex at my own model gateway?
Yes, on the Legacy runner with an API key, not with a connected account. The adapter reference shows the format.
“One agent writes and a different agent reviews. Paperclip keeps both on the same task, where the team can see the thread.”
Put Codex on your team’s tasks
Install Paperclip, connect Codex and assign the first task in a few minutes.