Cc2codex

cc2codex

Bring a Claude Code setup into Codex with a safe preview first.

`cc2codex` is a migration assistant for people moving from Claude Code to Codex. The most reliable way to use it today is through the Codex CLI plugin flow, with the Codex app UI as a secondary path if local plugins appear there on your machine.

What Imports Well

• reusable Claude instructions and CLAUDE.md guidance
• skills that map cleanly into Codex skill directories
• agent workflows that can be simplified into Codex skills
• high-confidence hooks
• MCP server structure and local command configuration

What Still Needs Review

• MCP tokens, API keys, and other secrets still need to be re-entered
• Claude-only hook events may need cleanup or removal
• team-style Claude agent workflows may need redesign
• large or very Claude-specific instruction sets may need trimming after import

Quick Start

If you only copy one section, copy this one.

Recommended: Codex CLI Plugin Flow

1. Clone the repo and install dependencies:

git clone https://github.com/ussumant/cc2codex.git
cd cc2codex
npm install

1. Install the Codex plugin:

node bin/cc2codex.js install-plugin --force

1. Check that the install is healthy:

node bin/cc2codex.js verify-plugin-install

1. Start Codex in Terminal:

codex

1. Inside Codex, open the plugin manager:

/plugins

1. If you don't see the plugin in /plugins, add your personal marketplace root (one-time) and restart Codex:

codex plugin marketplace add ~

1. Enable Claude to Codex Migration Assistant.
2. Start a new thread and paste this:

Help me bring my Claude Code setup into Codex.

That starts the non-technical flow:

• Codex finds your old Claude setup automatically
• Codex creates a safe preview in /tmp/cc2codex-trial/.codex
• Codex explains what was imported and what still needs attention
• Codex only updates your real ~/.codex after you approve it

Reco