Skip to main content
reopt Handbook
reopt Handbook
Codex Command MasterLabels and command selectionHow to read a detail guideComplete command listTerminal CLI Commands and Options

Task guides

Core Command GroupSession Command GroupCustom Command GuideMCP Command and Integration GuideDesign Workflows

Conversation and context

Cmd. /archiveCmd. /copyCmd. /importCmd. /cd

Planning and execution

Cmd. /goalCmd. /app

Models and settings

Cmd. /model

Permissions and integrations

Cmd. /pluginsCmd. /hooksCmd. /mcp

Display and input

Cmd. /statuslineCmd. /tuiCmd. /worktreeCmd. /voice

Account and usage

Cmd. /usage

Verification and history

Current verification scopeHandbook updatesRelease coverage historyEarlier verification recordsCommand change history
Handbook›Codex Command Master›Cmd. /import
한국어KOEnglishEN

Cmd. /import

Import Claude Code or Cursor setup, project files, and recent chats into Codex.

Written and reviewed by Eric Han · Co-founder & CTO, reopt

Key takeaways

  • Import Claude Code or Cursor setup, project files, and recent chats into Codex.
  • It can bring in settings, MCP servers, plugins, sessions, commands, and project memories; check changed files and config with /diff and /debug-config afterward.

Purpose

Import Claude Code or Cursor setup, project files, and recent chats into Codex.

/import

Availability

FieldValue
Input surfaceRunning CLI prompt
KindBuilt-in
StatusConditional
Aliases—
Documented minimumNot specified
Reviewed against2026-10-23 · Codex CLI 0.163.0

Run it from a local TUI when no task is running. Release 0.157.0 enabled it in remote and local background-server sessions, while the official command page still lists those as unavailable.

Examples

/import

When to use it

  1. Inspect Claude Code project instructions before moving them into Codex AGENTS.md and config.
  2. Select recent Claude Code chats that should continue in Codex.
  3. After import, run /diff, /status, and /debug-config before committing any changed files.

Choosing related commands

CommandDifferenceChoose It When
/importMigrates supported external-agent artifactsYou are moving Claude Code workflow into Codex
/initCreates a new AGENTS.md scaffoldYou are starting Codex instructions from scratch
/debug-configExplains active config layersYou need to inspect imported settings

Effects and persistence

Imports supported external configuration into Codex. Inspect the configuration before and after applying it.

/import is an official slash command for importing supported Cursor and Claude Code configuration, MCP servers, plugins, sessions, commands, and project memories into Codex.

Changes

  • /import was added to the official slash command table.
  • The import picker can bring supported Claude Code setup, project files, and recent chats into Codex.
  • The command is limited to local TUI sessions and is unavailable during running tasks, remote sessions, or local app-server daemon connections.

Cautions

Before applying, check for conflicts with AGENTS.md, .codex/config.toml, and skill or plugin rules; inspect the resulting diff.

In 0.145.0 the picker expanded across Cursor and Claude Code artifacts. After import, inspect not only the file diff but /plugins, /mcp, /skills, and thread history metadata.

  • Always inspect /diff and /debug-config after import.
  • Imported instructions, hooks, MCP servers, plugins, or skills may conflict with team policy.
  • From 0.157.0, /import also works in remote sessions and local background-server sessions. The official command page still lists those sessions as unavailable; if the command is blocked, import from a local TUI and review the diff.
  • /import is unavailable while a task is running. Session discovery covers up to 50 chats from the last 30 days.

Official sources

  • Developer Commands
  • Changelog
  • Rust V0.157.0

Complete command list · Verification scope · History for this command

Related docs

Terminal CLI Commands and Options

All 29 official Codex CLI command entries, global and command-specific option tables, and release additions

Cmd. /import

Claude Code Command Master · Import Codex, Gemini CLI, and Cursor configuration into Claude Code

Complete command list

Every Codex CLI slash command on one page: syntax, kind, and availability for all 57 official rows, plus examples, effects, and cautions by category.

Slash Commands

Advanced Codex Usage · Use Codex slash commands as an operating surface for sessions, review, models, and status.

Project Rule Documents

Agentic Documentation · Design AGENTS.md, CLAUDE.md, and path-scoped rules without conflicts or drift.

Cmd. /copy

Pick a whole Codex response, code block, or blockquote and copy it as Markdown.

Cmd. /cd

Track the 0.149.0 working-directory commands and verify their live behavior in the installed slash-command help.

On this page

PurposeAvailabilityExamplesWhen to use itChoosing related commandsEffects and persistenceChangesCautionsOfficial sources