> ## Documentation Index
> Fetch the complete documentation index at: https://oc-guide.openclaw-korea.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex (OpenAI)

> OpenAI Codex 에이전트와의 통합

OpenClaw는 **OpenAI의 Codex CLI**와도 통합할 수 있습니다.
스킬을 통해 Codex를 호출하거나, 모델을 교체하여 사용합니다.

## Codex CLI란?

OpenAI의 코딩 에이전트 CLI입니다.
코드 생성, 리팩토링, 디버깅을 수행합니다.

```bash theme={null}
# Codex CLI 설치
npm install -g @openai/codex
```

## OpenClaw에서 Codex 사용

### 모델 오버라이드

특정 작업에서 OpenAI 모델을 사용:

```bash theme={null}
# 크론잡에서 GPT 모델 사용
openclaw cron add --name "code-review" \
  --cron "0 18 * * 5" --tz "Asia/Seoul" \
  --message "이번 주 커밋 리뷰해줘" \
  --model "openai/o3" \
  --session isolated
```

### Codex 스킬

```markdown theme={null}
# skills/codex-quota/SKILL.md

Codex CLI 사용량을 추적하고 관리하는 스킬입니다.
일일/월별 사용량 제한을 모니터링합니다.
```

## Claude Code vs Codex

| 기능 | Claude Code | Codex |
| - | - | - |
| 파일 시스템 접근 | ✅ 네이티브 | ✅ 네이티브 |
| 셸 실행 | ✅ | ✅ |
| 긴 컨텍스트 | ✅ (200K) | 제한적 |
| 추론 능력 | 강함 | 보통 |
| 비용 | 중\~높 | 중 |
| OpenClaw 통합 | 네이티브 | 스킬/외부 |

> [!NOTE]
>
> OpenClaw는 Claude를 기본 모델로 사용하지만,
> 작업에 따라 다른 모델을 선택할 수 있습니다.

## 하이브리드 전략

**Claude 중심**

대부분의 작업을 Claude로 처리하고,
특정 케이스에서만 Codex를 보조로 사용:

```markdown theme={null}
# 용도 분류
- 아키텍처 설계 → Claude Opus
- 일반 코딩 → Claude Sonnet
- 간단한 코드 생성 → Codex
```

**용도별 분리**

작업 유형에 따라 모델을 완전 분리:

```bash theme={null}
# 코드 리뷰는 Claude
openclaw cron add --name "review" \
  --model "anthropic/claude-opus-4-20250514" ...

# 코드 생성은 GPT
openclaw cron add --name "generate" \
  --model "openai/o3" ...
```

> [!TIP]
>
> 하나의 모델에 집중하는 것이 워크플로우 관리에 효율적입니다.
> 모델을 섞으면 일관성이 떨어질 수 있습니다.
> 특별한 이유가 없다면 Claude 중심으로 운영하세요.

## 사용량 관리

```bash theme={null}
# Codex 사용량 확인 (스킬이 설치된 경우)
# AI에게 "codex 사용량 확인해줘"라고 요청

# OpenAI API 대시보드에서 직접 확인
# https://platform.openai.com/usage
```

> [!WARNING]
>
> 여러 모델을 동시에 사용하면 API 비용이 분산되어 추적이 어렵습니다.
> 월 예산을 설정하고, 각 모델별 사용량을 모니터링하세요.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.