Summary
After following the install instructions exactly, all /codex:* commands return Unknown skill: codex:setup (or similar). The root cause is that /plugin install codex@openai-codex installs the plugin files but does not write the entry to enabledPlugins in ~/.claude/settings.json, so Claude Code never loads the plugin.
Steps to Reproduce
/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex
/reload-plugins
/codex:setup
Expected: Codex setup check runs.
Actual: Unknown skill: codex:setup
Root Cause
~/.claude/settings.json contains an enabledPlugins map that controls which plugins Claude Code actually loads. After /plugin install, the plugin files are downloaded to the cache correctly, but the key codex@openai-codex: true is never written to enabledPlugins.
Inspecting the file after install:
{
"enabledPlugins": {
"gh-cli@robbyt-claude-skills": true,
"feature-dev@claude-code-plugins": true,
...
// codex@openai-codex is missing entirely
}
}
Workaround
Manually add the entry to ~/.claude/settings.json:
{
"enabledPlugins": {
...
"codex@openai-codex": true
}
}
Then run /reload-plugins. After this, all commands (/codex:setup, /codex:review, /codex:rescue, etc.) work correctly.
Environment
- Claude Code: 2.1.104
- Codex CLI: 0.120.0
- Plugin version: 1.0.2
- OS: macOS 15 (Apple Silicon)
- Node: v25.6.1
Summary
After following the install instructions exactly, all
/codex:*commands returnUnknown skill: codex:setup(or similar). The root cause is that/plugin install codex@openai-codexinstalls the plugin files but does not write the entry toenabledPluginsin~/.claude/settings.json, so Claude Code never loads the plugin.Steps to Reproduce
Expected: Codex setup check runs.
Actual:
Unknown skill: codex:setupRoot Cause
~/.claude/settings.jsoncontains anenabledPluginsmap that controls which plugins Claude Code actually loads. After/plugin install, the plugin files are downloaded to the cache correctly, but the keycodex@openai-codex: trueis never written toenabledPlugins.Inspecting the file after install:
{ "enabledPlugins": { "gh-cli@robbyt-claude-skills": true, "feature-dev@claude-code-plugins": true, ... // codex@openai-codex is missing entirely } }Workaround
Manually add the entry to
~/.claude/settings.json:{ "enabledPlugins": { ... "codex@openai-codex": true } }Then run
/reload-plugins. After this, all commands (/codex:setup,/codex:review,/codex:rescue, etc.) work correctly.Environment