Claude Skill MartBrowse skillsQuick linesLearn by videoTerminal guideWhat is a Skill?
 
← Back to list

Add Codex Agent Provider (NanoClaw)

An installer skill that wires OpenAI's Codex app-server into NanoClaw as a first-class agent provider, switchable per group.

Dev & CodingAdvanced★ 30,840⑂ 12,826AI score 8/10Last updated: Sep 23, 2026

What it does

Automates the full install of Codex as an agent backend for a NanoClaw instance, alongside or instead of Claude.

  • Copies the Codex payload from the providers branch into host, container and setup trees
  • Appends import './codex.js'; to five provider/contract barrels (idempotent)
  • Adds a pinned @openai/codex entry to container/cli-tools.json and rebuilds the image
  • Validates wiring with provider-contract-verifier
  • Runs the vault auth walk-through (ChatGPT subscription login or OpenAI API key)

Credentials are vault-only: the container sees a sentinel auth.json while the gateway swaps the real token on the wire — nothing lands in .env.

Who it's for

  • Operators already running NanoClaw who want different model backends per group
  • Teams wanting Codex's server-side conversation history and MCP tool orchestration
  • Anyone who likes deterministic, machine-appliable install docs (nc: directive fences)

Note: it is useless outside the NanoClaw repository.

Examples

  1. One-shot install: pnpm exec tsx setup/index.ts --step provider-auth codex performs copy, wiring, rebuild and auth in a single command.
  2. Per-group switch: ncl groups config update --id <group-id> --provider codex then ncl groups restart --id <group-id>.
  3. Debugging: a silent channel plus Unknown provider: codex. Registered: claude in logs/nanoclaw.error.log means the barrels aren't wired into the running build.

· · · Install guide · · ·

Try it now, no install

Paste this into Claude to use the skill without installing anything.

Read the instructions in this file and follow them to help me:
https://raw.githubusercontent.com/nanocoai/nanoclaw/HEAD/.claude/skills/add-codex/SKILL.md

What I want: (describe your task here)

If Claude can't open the link, open it yourself and paste the contents instead.

↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.

Install in the Claude app (no terminal)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
↓ Download ZIP
Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on Claude Skill Mart.
Copy the .claude/skills/add-codex folder from the GitHub repo nanocoai/nanoclaw into my ~/.claude/skills/add-codex/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/nanocoai/nanoclaw.git && mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-codex ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

  1. Open a terminal in your working directory.
  2. Clone the repository: git clone https://github.com/nanocoai/nanoclaw.git
  3. To keep the skill available to Claude Code: mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-codex ~/.claude/skills/
  4. Enter the repo with cd nanoclaw and confirm src/project-doc-compose.ts exists. If it is missing, run /update-nanoclaw first.
  5. Start Claude Code and ask it to "install the Codex provider using the add-codex skill", or run pnpm exec tsx setup/index.ts --step provider-auth codex yourself.
  6. Follow the prompts to log in with a ChatGPT subscription or paste an OpenAI API key; it is stored in the gateway vault.
  7. Enable it for a group: ncl groups config update --id <group-id> --provider codex, then ncl groups restart --id <group-id>.
View source on GitHub ↗License: MIT