Codex Assistant
- 77 installs
- 29 repo stars
- Updated January 24, 2026
- joeseesun/codex-assistant
Execute code refactoring, bug fixes, testing, and documentation tasks via OpenAI Codex natural language CLI integration.
About
Skill that bridges Claude and OpenAI Codex CLI for automated code transformation tasks. Developers use it to refactor, debug, generate tests, and document code through natural language prompts.
- Supports refactoring, bug fixes, test generation, documentation, and cross-language migration
- Parses natural language requests into Codex-compatible instructions
Codex Assistant by the numbers
- 77 all-time installs (skills.sh)
- Ranked #497 of 1,352 Code Review & Quality skills by installs in the Skillselion catalog
- Data as of Aug 2, 2026 (Skillselion catalog sync)
npx skills add https://github.com/joeseesun/codex-assistant --skill codex-assistantAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 77 |
|---|---|
| repo stars | ★ 29 |
| Last updated | January 24, 2026 |
| Repository | joeseesun/codex-assistant ↗ |
What it does
Execute code refactoring, bug fixes, testing, and documentation tasks via OpenAI Codex natural language CLI integration.
Files
Codex Assistant
通过 OpenAI Codex CLI 执行代码任务。使用前请确保： 1. Codex 已安装并配置 (codex 命令可用) 2. 工作目录在信任列表中
触发词
/codex-assistant- 显式调用用 Codex/codex 帮我- 自然语言调用
---
核心原则
当用户用 `/codex` 或 `用 Codex` 发起请求时：
1. 提取用户需求 - 从自然语言中提取 Codex 需要完成的任务 2. 构建 Codex Prompt - 将需求转化为 Codex 能理解的指令 3. 执行命令 - 使用 Bash 调用 codex exec 4. 返回结果 - 直接展示 Codex 的输出
---
Codex 最佳场景
| 场景 | Codex 擅长 | 提示词模板 |
|---|---|---|
| 代码重构 | 优化结构、提升可读性 | "重构这段代码，让它更简洁" |
| Bug 修复 | 定位问题、给出修复 | "找出并修复这个 bug" |
| 测试生成 | 编写单元测试 | "给这个函数写测试" |
| 代码解释 | 逐行解释逻辑 | "解释这段代码在做什么" |
| 跨语言迁移 | 语言/框架转换 | "转成 TypeScript" |
| 代码审查 | 找出问题、改进建议 | "审查这段代码" |
| 文档生成 | 添加注释/文档 | "给这个函数写文档" |
| 样板代码 | 生成模板/脚手架 | "写一个 React 组件模板" |
| 代码清理 | 移除技术债务 | "清理这段代码" |
---
执行流程
步骤 1: 解析用户输入
识别任务类型（重构/修复/测试/解释/迁移/审查/文档/生成）
步骤 2: 构建 Codex Prompt
echo "你的任务描述" | codex exec -m gpt-5.2-codex步骤 3: 展示结果
直接返回 Codex 的输出，不做额外加工
---
注意事项
- Codex 是研究预览版，功能可能不稳定
- 生成的代码建议 review 后使用
- 复杂任务可能需要多次交互
- 确保在受信任目录中执行
# Codex CLI
codex
# OS
.DS_Store
Thumbs.db
# Editor
.vscode
.idea
*.swp
*.swo
# Logs
*.log
MIT License
Copyright (c) 2026 Qiaomu (乔木)
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
{
"name": "codex-assistant",
"version": "1.0.0",
"description": "Call OpenAI Codex CLI through natural language for code tasks: refactoring, bug fixing, testing, explanation, migration, review, and documentation.",
"author": "Qiaomu (乔木)",
"dependencies": {
"codex_cli": {
"version": ">=0.89.0",
"description": "OpenAI Codex CLI must be installed and configured"
}
},
"platforms": ["macOS", "Linux"],
"tags": ["codex", "openai", "code-generation", "refactoring", "testing", "code-review", "automation"],
"triggers": [
"/codex",
"用 Codex",
"codex 帮我",
"codex assistant"
]
}
Codex Assistant
通过自然语言调用 OpenAI Codex CLI 执行代码任务
---
为什么需要这个工具？
OpenAI Codex 是一个强大的 AI 编程助手，但直接使用命令行不够直观：
- ❌ 需要记住复杂的命令参数
- ❌ 难以与 Claude Code 等工具集成
- ❌ 缺少最佳场景指引
这个 Skill 解决了这些痛点：
- ✅ 自然语言触发，无需记忆命令
- ✅ 内置最佳场景提示词模板
- ✅ 一键执行，返回结果
- ✅ 与 Claude Code 无缝协作
---
核心功能
| 场景 | Codex 擅长 | 触发示例 |
|---|---|---|
| 代码重构 | 优化结构、提升可读性 | /codex-assistant 重构这段代码 |
| Bug 修复 | 定位问题、给出修复 | /codex-assistant 找出并修复 bug |
| 测试生成 | 编写单元测试 | /codex-assistant 给这个函数写测试 |
| 代码解释 | 逐行解释逻辑 | /codex-assistant 解释这段代码 |
| 跨语言迁移 | 语言/框架转换 | /codex-assistant 转成 TypeScript |
| 代码审查 | 找出问题、改进建议 | /codex-assistant 审查这段代码 |
| 文档生成 | 添加注释/文档 | /codex-assistant 给这个函数写文档 |
| 样板代码 | 生成模板/脚手架 | /codex-assistant 写一个组件模板 |
| 代码清理 | 移除技术债务 | /codex-assistant 清理这段代码 |
---
安装
方式一：npx skills add（推荐）
使用 Vercel 的 skills 生态系统一键安装：
npx skills add joeseesun/codex-assistant支持 Claude Code、OpenManus 等兼容 skills 标准的 AI Agent方式二：Claude Code 一键安装
直接告诉 Claude Code：
安装这个 skill：https://github.com/joeseesun/codex-assistantClaude Code 会自动完成所有安装步骤！
方式三：手动安装
1. 安装 Codex CLI
macOS:
# 使用 Homebrew 安装
brew install codex-cli/codex/codex
# 或通过 npm
npm install -g @openai/codex验证安装：
codex --version
# 应该显示类似: OpenAI Codex v0.89.02. 配置 Codex
# 登录 Codex（需要 OpenAI 账户）
codex login
# 添加信任目录（可选，但推荐）
codex config set projects."$(pwd)" trust_level=trusted3. 克隆 Skill
# 克隆到 Claude Code skills 目录
git clone https://github.com/joeseesun/codex-assistant.git \
~/.claude/skills/codex-assistant---
使用方法
方式一：通过 Claude Code 对话
你：/codex-assistant 重构这段代码，让它更简洁
Codex：[自动执行并返回结果]
你：用 Codex 帮我写一个快速排序
Codex：[生成代码]方式二：直接使用 Codex CLI
# 进入信任目录
cd /path/to/your/project
# 执行任务
echo "写一个快速排序算法" | codex exec---
使用示例
示例 1：代码重构
你：/codex-assistant 重构这段代码，消除重复逻辑
Codex：[分析代码并提供重构方案]示例 2：Bug 修复
你：/codex-assistant 帮我找出并修复这个 bug
[粘贴有问题的代码]
Codex：[定位问题并给出修复]示例 3：测试生成
你：/codex-assistant 给这个函数写单元测试
[粘贴函数代码]
Codex：[生成测试用例]示例 4：跨语言迁移
你：/codex-assistant 把这段 Python 转成 TypeScript
[粘贴 Python 代码]
Codex：[生成等价的 TypeScript 代码]---
最佳实践
Codex 适合的场景
- ✅ 小到中型代码任务 - 函数重构、单文件修改
- ✅ 明确的任务描述 - 知道要什么，但不确定怎么实现
- ✅ 快速原型 - 快速生成样板代码
- ✅ 代码解释 - 理解不熟悉的代码
Codex 不太适合的场景
- ❌ 大型重构 - 跨多文件的复杂改动
- ❌ 模糊需求 - 不确定要什么
- ❌ 生产代码 - 建议 review 后使用
提升效果的建议
1. 提供上下文 - 告诉 Codex 你在做什么项目 2. 明确约束 - 说明语言、风格、要求 3. 迭代优化 - 基于结果多次调整
---
系统要求
- 平台: macOS / Linux
- Codex CLI: >= 0.89.0
- 工作目录: 建议在 git 仓库或信任目录中
---
常见问题
Q: Codex 返回空结果怎么办？
A: 确保工作目录在 Codex 信任列表中：
codex config set projects."$(pwd)" trust_level=trustedQ: 如何切换模型？
A: 使用 -m 参数指定模型：
echo "任务" | codex exec -m gpt-4oQ: Codex 是免费的吗？
A: Codex CLI 本身免费，但调用 OpenAI API 消耗配额。
Q: 支持 Windows 吗？
A: 支持，但需要在 WSL 或 Git Bash 中运行。
---
更新日志
v1.0.0 (2026-01-24) - 首次发布
- 自然语言触发
- 9 种最佳场景模板
- 与 Claude Code 集成
- 详细文档
---
贡献
欢迎贡献！请提交 Issue 或 Pull Request。
---
许可证
MIT License
---
联系方式
- 作者: Qiaomu (乔木)
- GitHub: @joeseesun
- Email: vista8@gmail.com
- 个人网站: qiaomu.ai
---
⭐ 如果这个工具对你有帮助，请给个 Star！
_让 AI 编程助手触手可及_
Related skills
Improve Codebase ArchitectureSafely deepen clusters of shallow modules into cohesive, testable units while respecting their external dependencies.566k196k
Caveman ReviewGet ultra-compressed, one-line code review comments that cut noise while keeping every actionable fix.270k94.7kCodebase DesignShared vocabulary for designing deep modules: improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable.266k196kCavecrewDelegate coding tasks to specialized subagents that return compressed output, keeping the main context window usable for much longer sessions.220k94.7kCode ReviewReviews a branch or PR diff on two axes at once: conformance to coding standards plus a code-smell baseline, and whether it actually implements the original spec.201k196k
Requesting Code ReviewDispatch a consistent, high-signal code reviewer subagent that catches plan deviations and quality issues before merging or continuing development.183k264k