https://github.com/skills-directory/skill-codex
A claude code skill to delegate prompts to codex
https://github.com/skills-directory/skill-codex
claude claude-code codex
Last synced: 4 months ago
JSON representation
A claude code skill to delegate prompts to codex
- Host: GitHub
- URL: https://github.com/skills-directory/skill-codex
- Owner: skills-directory
- License: mit
- Created: 2025-10-21T19:28:43.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2026-02-07T13:18:30.000Z (5 months ago)
- Last Synced: 2026-02-07T22:05:33.076Z (5 months ago)
- Topics: claude, claude-code, codex
- Homepage:
- Size: 17.6 KB
- Stars: 541
- Watchers: 6
- Forks: 44
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-claude-code - **skill-codex**
- awesome-AI-driven-development - Codex Integration for Claude Code - Enable Claude Code to invoke the Codex CLI (codex exec and session resumes) for automated code analysis, refactoring, and editing workflows. (Skills / Copilot Extensions & Alternatives)
- awesome-openclaw-skills - skills-directory/skill-codex
- awesome-skills-zh - **skills-directory/skill-codex**
- awesome-codex-cli - Codex Skill - Enables users to prompt codex from claude code. Unlike the raw codex mcp server, this skill infers parameters such as model, reasoning effort, sandboxing from your prompt or asks you to specify them. It also simplifies continuing prior codex sessions so that codex can continue with the prior context. (Agent Skills / General)
- awesome-claude-code-cn - Codex Skill - 使用户能够从 claude code 提示 codex。与原始的 codex mcp 服务器不同，此技能从您的提示中推断模型、推理努力、沙箱等参数，或要求您指定它们。它还简化了继续先前的 codex 会话，以便 codex 可以继续先前的上下文。 (代理技能 🤖 / 通用)
- awesome-agent-skills - skill-codex - A claude code skill to delegate prompts to codex. (Workflow Automation Skills)
- claude-code-skills-zh - skill-codex
README
Leave a star ⭐ if you like it 😘
# Codex Integration for Claude Code
## Purpose
Enable Claude Code to invoke the Codex CLI (`codex exec` and session resumes) for automated code analysis, refactoring, and editing workflows.
## Prerequisites
- `codex` CLI installed and available on `PATH`.
- Codex configured with valid credentials and settings.
- Confirm the installation by running `codex --version`; resolve any errors before using the skill.
## Installation
This repository is structured as a [Claude Code Plugin](https://code.claude.com/docs/en/plugins) with a marketplace. You can install it as a **plugin** (recommended) or extract it as a **standalone skill**.
### Option 1: Plugin Installation (Recommended)
Install via Claude Code's plugin system for automatic updates:
```
/plugin marketplace add skills-directory/skill-codex
/plugin install skill-codex@skill-codex
```
### Option 2: Standalone Skill Installation
Extract the skill folder manually:
```
git clone --depth 1 git@github.com:skills-directory/skill-codex.git /tmp/skills-temp && \
mkdir -p ~/.claude/skills && \
cp -r /tmp/skills-temp/plugins/skill-codex/skills/codex ~/.claude/skills/codex && \
rm -rf /tmp/skills-temp
```
## Usage
### Important: Thinking Tokens
By default, this skill suppresses thinking tokens (stderr output) using `2>/dev/null` to avoid bloating Claude Code's context window. If you want to see the thinking tokens for debugging or insight into Codex's reasoning process, explicitly ask Claude to show them.
### Example Workflow
**User prompt:**
```
Use codex to analyze this repository and suggest improvements for my claude code skill.
```
**Claude Code response:**
Claude will activate the Codex skill and:
1. Ask which model to use (`gpt-5.3-codex` or `gpt-5.2`) unless already specified in your prompt.
2. Ask which reasoning effort level (`low`, `medium`, or `high`) unless already specified in your prompt.
3. Select appropriate sandbox mode (defaults to `read-only` for analysis)
4. Run a command like:
```bash
codex exec -m gpt-5.3-codex \
--config model_reasoning_effort="high" \
--sandbox read-only \
--full-auto \
--skip-git-repo-check \
"Analyze this Claude Code skill repository comprehensively..." 2>/dev/null
```
**Result:**
Claude will summarize the Codex analysis output, highlighting key suggestions and asking if you'd like to continue with follow-up actions.
### Detailed Instructions
See [`plugins/skill-codex/skills/codex/SKILL.md`](plugins/skill-codex/skills/codex/SKILL.md) for complete operational instructions, CLI options, and workflow guidance.
## License
MIT License - see [LICENSE](LICENSE) for details.