# Usecli Codex

> Use Codex as an external CLI worker inside a Claude Code or LikeCode-centered workflow. Good for implementation-oriented feedback, code-aware review, and execution-heavy coding tasks.

- Skill: `harzva/usecli-codex` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add harzva/usecli-codex`
- Raw SKILL.md: https://api.skillmd.com/api/skills/harzva/usecli-codex/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: harzva (https://skillmd.com/u/harzva)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/harzva/usecli-codex

---


# usecli-codex

## Overview

Use OpenAI Codex CLI as an external worker inside a Claude Code workflow.

Best for:
- implementation-oriented feedback
- code-aware review
- execution-heavy coding tasks

## Install

This sub-skill can be installed independently:

```bash
skill install https://github.com/Harzva/usecli-codex
```

Or manually:

```bash
git clone https://github.com/Harzva/usecli-codex.git
mkdir -p ~/.claude/skills
ln -s $(pwd) ~/.claude/skills/usecli-codex
```

## Command

```bash
bash ~/.claude/skills/usecli-codex/scripts/usecli-codex.sh --prompt "<prompt>"
```

Or with a prompt file:

```bash
bash ~/.claude/skills/usecli-codex/scripts/usecli-codex.sh --prompt-file <path>
```

## Verification

Run the local smoke test:

```bash
bash ~/.claude/skills/usecli-codex/tests/test_wrapper.sh
```

## Environment Variables

| Variable | Purpose | Default |
| --- | --- | --- |
| `USECLI_CODEX_BIN` | Codex executable | `codex` |
| `USECLI_CODEX_MODEL` | Model override | (none) |
| `USECLI_CODEX_OUTPUT_FILE` | Last message output | (none) |
| `USECLI_CODEX_TIMEOUT` | Timeout seconds | (none) |

## Good Fits

- When you need OpenAI-family reasoning in a specific task
- When the control plane stays in Claude Code but you want Codex for code execution
- When you want implementation-oriented review of a design or plan

## Notes

- Uses `codex exec --skip-git-repo-check` in non-interactive mode
- Requires local Codex CLI installation and authentication
- For first-time setup, see the official Codex documentation

## Resources

### `bin/usecli-codex.sh`

The wrapper script. Sources `bin/usecli-lib.sh` for shared functionality.

### `examples/workflows/gemini-codex-review.sh`

Demonstrates Gemini + Codex review workflow.