ReddRadar
Agent skill
codexforclaude
OpenAI Codex CLI configuration guide for Claude. Use when users ask about: codex config, ~/.codex/config.toml, codex sandbox policies, codex approval modes, creating codex skills, codex mcp servers, codex model settings, local LLM providers, or integrating tools with Codex.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/codexforclaude
SKILL.md
Codex CLI Configuration Guide
Configure and extend OpenAI Codex CLI for optimal development workflows.
Quick Reference
| Task | Command/Location |
|---|---|
| Config file | ~/.codex/config.toml |
| Add MCP server | codex mcp add <name> -- <command> |
| View MCP servers | /mcp in TUI |
| Skills location | ~/.codex/skills/ or .codex/skills/ |
| Create skill | Use $skill-creator in Codex |
Core Configuration
Edit ~/.codex/config.toml for all settings:
# Model settings
model = "gpt-5-codex"
model_reasoning_effort = "medium" # minimal|low|medium|high|xhigh
# Security
sandbox_mode = "workspace-write" # read-only|workspace-write|danger-full-access
approval_policy = "on-failure" # untrusted|on-failure|on-request|never
# Trust specific projects
[projects."/path/to/project"]
trust_level = "trusted"
For detailed config options: See references/config-toml.md
Sandbox and Approval Policies
Sandbox modes control file system access:
read-only- Can only read files, no writesworkspace-write- Write within project directory onlydanger-full-access- Full system access (use carefully)
Approval policies control command execution:
untrusted- Only trusted commands run without approvalon-failure- Auto-run, ask approval only on failureson-request- Model decides when to asknever- Never ask (dangerous)
For security deep dive: See references/sandbox-approval.md
Adding MCP Servers
Via CLI (Recommended)
codex mcp add context7 -- npx -y @upstash/context7-mcp
codex mcp add myserver --env API_KEY=xxx -- node server.js
Via config.toml
[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp"]
[mcp_servers.figma]
url = "https://mcp.figma.com/mcp"
bearer_token_env_var = "FIGMA_OAUTH_TOKEN"
For full MCP options: See references/mcp-servers.md
Creating Codex Skills
Skills extend Codex with specialized knowledge. Structure:
~/.codex/skills/my-skill/
├── SKILL.md # Required: instructions + metadata
├── scripts/ # Optional: executable code
├── references/ # Optional: detailed docs
└── assets/ # Optional: templates
Minimal SKILL.md:
---
name: my-skill
description: When to trigger this skill
---
Instructions for Codex when using this skill.
Quick start: Ask Codex to use $skill-creator to bootstrap a new skill.
For skill development guide: See references/creating-skills.md
Model and Provider Settings
# Use specific model
model = "gpt-5-codex"
# Reasoning effort (Responses API)
model_reasoning_effort = "high" # minimal|low|medium|high|xhigh
# Verbosity (GPT-5)
model_verbosity = "medium" # low|medium|high
# Use local provider (LM Studio/Ollama)
model_provider = "oss"
For local LLM setup: See references/model-providers.md
Feature Flags
Enable experimental features in [features]:
[features]
# Stable
shell_tool = true
parallel = true
view_image_tool = true
# Beta
unified_exec = true
shell_snapshot = true
# Experimental
skills = true
tui2 = true
Common Workflows
Full Autonomous Mode
codex --full-auto "implement feature X"
# Equivalent to: -a on-request --sandbox workspace-write
Dangerous Bypass (CI/sandboxed environments only)
codex --dangerously-bypass-approvals-and-sandbox "run tests"
Project-Specific Trust
[projects."/home/user/trusted-project"]
trust_level = "trusted"
Codex vs Claude Code
| Aspect | Codex | Claude Code |
|---|---|---|
| Provider | OpenAI | Anthropic |
| Config | ~/.codex/config.toml |
~/.claude/settings.json |
| Skills | ~/.codex/skills/ |
~/.claude/skills/ + plugins |
| MCP | config.toml sections |
.mcp.json or plugin |
| Agents | N/A | Plugin agents |
| Hooks | N/A | Plugin hooks |
Reference Files
references/config-toml.md- Complete config.toml referencereferences/sandbox-approval.md- Security policies deep divereferences/mcp-servers.md- MCP server configurationreferences/creating-skills.md- Skill development guidereferences/model-providers.md- Model and provider settings
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?