Claude Code & Codex 使用指南

Claude Code 内置命令

在终端直接输入，无需前缀。新手从 /help 开始。

全部

核心

会话

代码

配置

/help

核心

查看所有命令帮助，新手必看第一步

/help

/clear

会话

清空全部对话历史，重新开始，不影响文件

/clear

/compact

会话

压缩对话历史保留摘要，对话很长时节省 token

/compact

/commit

核心Git

自动分析改动，生成规范 Git commit

/commit

/init

配置

在当前项目生成 CLAUDE.md，告诉 Claude 项目规范

/init

/cost

会话

显示本次对话消耗的 token 数和费用估算

/cost

/memory

配置

编辑持久记忆，跨会话保留偏好和项目背景

/memory

/model

配置

切换 Opus / Sonnet / Haiku，复杂任务用 Opus

/model

/permissions

配置

管理工具权限，控制哪些操作需要确认

/permissions

/fast

速度

切换快速模式，加快响应（同等模型）

/fast

/review-pr

代码

审查 GitHub PR，分析代码质量和潜在问题

/review-pr 123

/loop

代码

按间隔重复执行任务，适合轮询构建状态

/loop 5m 检查构建状态

/simplify

代码

审查刚修改的代码，自动简化提升可读性

/simplify

/ui-ux-pro-max

核心设计

UI/UX 设计智能，67 种风格、96 种配色、多框架支持

/ui-ux-pro-max 设计一个登录页

/doctor

配置

检查 Claude Code 安装状态，排查环境问题

/doctor

/schedule

配置

创建定时执行的 agent 任务，支持 cron 表达式

/schedule

Oh-My-ClaudeCode Skills

前缀 /oh-my-claudecode: 调用，或直接说关键词触发

两种调用方式：完整命令 /oh-my-claudecode:autopilot，或直接说 autopilot 帮我…、ralph 修复直到通过

全部

执行引擎

代码质量

规划分析

设计

autopilot

执行

全自动：从想法到运行代码，一条命令搞定整个功能

autopilot 帮我实现用户登录功能

ralph

执行

自我循环直到完成 + 验证，适合不确定步骤数的任务

ralph 修复所有测试直到全部通过

ultrawork / ulw

执行

并行执行引擎，多任务同时跑，高吞吐量专用

ulw 同时重构这3个模块

architect

规划

战略架构顾问，只读分析，给出架构建议和 trade-off

/oh-my-claudecode:architect

ralplan

规划

执行前先规划访谈，把模糊需求变成精准方案再动手

ralplan 我要做一个股票追踪应用

code-reviewer

代码

SOLID 原则、逻辑缺陷、安全漏洞、性能，按严重性分级

/oh-my-claudecode:code-reviewer

debugger

代码

根因分析，堆栈追踪，找到真正错误原因不猜测

/oh-my-claudecode:debugger

executor

执行

专注实现，不聊天不规划，直接写代码。复杂任务加 opus

/oh-my-claudecode:executor

security-reviewer

代码

OWASP Top 10，SQL注入 / XSS / 硬编码密钥等漏洞检测

/oh-my-claudecode:security-reviewer

test-engineer

代码

测试策略、E2E 覆盖、TDD 工作流、修复不稳定测试

/oh-my-claudecode:test-engineer

code-simplifier

代码

消除 AI 生成冗余，简化代码，保留全部功能

/oh-my-claudecode:code-simplifier

designer

设计

UI/UX 设计开发，生成精美界面，适合网页和 App

/oh-my-claudecode:designer

deep-interview

规划

苏格拉底式深度访谈，把模糊想法问成精准规格

deep interview 我想做一个...

trace

代码

证据驱动的因果溯源，多假设竞争，不猜只看证据

/oh-my-claudecode:trace

verifier

规划

宣称完成前先验证，收集证据，防止假完成

/oh-my-claudecode:verifier

git-master

代码

Git 专家，atomic commit、rebase、历史管理

/oh-my-claudecode:git-master

Codex CLI & oh-my-codex

OpenAI Codex CLI 的独立使用，以及在 OMC 生态中的集成用法

Codex CLI 独立使用

安装：npm i -g @openai/codex　设置：export OPENAI_API_KEY=sk-...

全部

启动

会话

权限模式

oh-my-codex

codex

核心

启动交互式 TUI，类似 Claude Code 的终端体验

codex

codex "任务"

核心

直接描述任务，跳过 TUI，最常用方式

codex "帮我写一个快速排序函数"

codex exec / codex e

核心

非交互模式，结果输出 stdout，适合脚本调用

codex e "列出所有 TODO 注释"

--approval-mode auto

权限

全自动，读写文件/运行命令不需确认，信任环境使用

codex --approval-mode auto "重构这个模块"

--approval-mode suggest

权限

建议模式，每步需确认，推荐新手使用

codex --approval-mode suggest "修改配置"

codex --resume

会话

继续上一次会话，保留完整上下文

codex --resume

codex --fork

会话

从历史会话分叉，开新线程，原会话保持不变

codex --fork abc123

/diff（TUI 内）

TUI内

在 TUI 中查看 Git diff，审查 Codex 所有改动

/diff

oh-my-codex — OMC 生态集成

什么是 oh-my-codex（OMX）？
OMX 是与 OMC 平级的独立系统：OMC 服务 Claude Code，OMX 服务 Codex CLI，两者通过 interop bridge（oh-my-claude-sisyphus）双向协作，任务可以从 omc → omx 或 omx → omc 双向流动，共享同一套 task queue 和 mailbox 机制。

在 OMC 里通过 ask_codex MCP 工具调用 Codex，是 OMC 主动发起的单次请求；而 omc team N:codex 则是把 Codex 作为并行 worker 纳入 OMC 的 team 流水线。

默认模型：gpt-5.3-codex（可用 OMC_CODEX_DEFAULT_MODEL 环境变量覆盖）

推理强度（reasoning_effort）

级别	适用场景	速度
minimal	简单问答、快速查找	最快
low	基础代码补全、简单任务	快
medium	默认值，日常开发任务	均衡
high	架构分析、复杂 Bug、代码审查	慢
xhigh	深度安全审计、复杂规划	最慢

Codex 最擅长的角色

Codex 在以下角色表现最佳（OMC 推荐）：
architect · planner · critic · analyst · code-reviewer · security-reviewer · test-engineer

常用集成命令

omc ask codex

oh-my-codex

向 Codex 提问，获得 GPT 视角的独立分析

omc ask codex "如何优化这个 SQL 查询"

omc team N:codex

oh-my-codex

用 N 个 Codex worker 并行处理任务

omc team 2:codex "分析这两个模块的差异"

ccg（三模型协作）

oh-my-codex核心

Claude + Codex + Gemini 各自分析，Claude 综合最优结论

ccg 这段代码有什么潜在问题

Codex + reasoning_effort

oh-my-codex

指定推理深度，架构审查用 high，快速任务用 low

# 通过 OMC 调用 Codex（高推理强度）
omc ask codex \
  --reasoning-effort high \
  "审查这个认证模块的安全性"

后台任务

oh-my-codex

Codex 在后台运行长任务，不阻塞当前对话，完成后通知

# 后台模式（background: true）
# 返回 job_id，可用 check_job_status 查询
omc ask codex --background \
  "全量扫描仓库安全漏洞"

环境变量配置

配置

通过环境变量全局调整 oh-my-codex 行为

# 修改默认模型
export OMC_CODEX_DEFAULT_MODEL=gpt-4.1

# 修改超时（默认1小时）
export OMC_CODEX_TIMEOUT=1800000

# 修改限速重试次数（默认3次）
export OMC_CODEX_RATE_LIMIT_RETRY_COUNT=5

Team 协作配置

根据你的角色选择最佳 Agent 组合，让 AI 团队各司其职

plan规划拆解

›

exec并行执行

›

review代码审查

›

verify验证结果

›

fix循环修复

产品经理 PM

强调需求澄清、设计质量，从想法到产品

需求澄清deep interview — 把模糊想法问清楚

规划方案ralplan / analyst — 分析可行性，拆解任务

UI 设计/ui-ux-pro-max 或 designer — 先出设计稿

并行开发/team 3:executor — 多 agent 同时实现各模块

验证交付verifier — 确认符合需求，不假完成

# PM 标准流程
deep interview 我想做[产品名称]
# 需求澄清后 →
ralplan [确认的需求]
# 规划完成后 →
/ui-ux-pro-max 按需求出设计稿
/team 3:executor "实现各功能模块"
/oh-my-claudecode:verifier

开发者 Dev

强调代码质量、架构设计和自动化测试

架构设计architect — 只读分析，给出系统设计建议

并行实现/team 3:executor — 多 agent 同时写各模块

代码审查code-reviewer + security-reviewer 双重检查

测试覆盖test-engineer — 补充测试，TDD 工作流

循环修复ralph — 自动修复直到测试全部通过

# Dev 标准流程
/oh-my-claudecode:architect
# 确认方案后 →
/team 3:executor "实现[功能列表]"
/oh-my-claudecode:code-reviewer
/oh-my-claudecode:security-reviewer
ralph 修复直到所有测试通过
/commit

常用 Team 命令

/team N:executor

Team

启动 N 个 executor 并行处理，N 建议 2–4

/team 3:executor "实现支付模块的3个接口"

ccg

Team

Claude + Codex + Gemini 三模型各自分析，综合最优结论

ccg 这段代码有什么潜在问题

ralph

Team

执行+验证循环，自动修复直到目标达成

ralph 修复所有报错直到构建通过

cancelomc

控制

终止正在运行的 autopilot / ralph / team 等模式

cancelomc

设计提示词

配合 /ui-ux-pro-max 和 designer skill 使用，直接复制修改关键词即可

最佳实践：先运行设计系统查询 python3 .claude/skills/ui-ux-pro-max/scripts/search.py "产品描述" --design-system，再用下面的提示词描述具体页面

App 风格（8 种）

FLAT DESIGN

Flat Design

当前站点风格极简高效

/ui-ux-pro-max

Flat Design 风格 [页面名称]。
主色：#DC2626，背景 #f9f9f9
字体：Newsreader（标题）+ Roboto（正文）
无阴影，无过度圆角，SVG 图标
导航：统一顶部 + 底部页脚
移动端优先，响应式布局

DARK TECH

Dark Tech / Developer

开发者工具深色高密度

/ui-ux-pro-max

Dark tech 开发者风格 [App名称]。
背景 #0a0a0a，主色 #DC2626
文字 #e5e5e5，代码块 #111
字体：JetBrains Mono（标题/代码）
     + IBM Plex Sans（正文）
卡片无阴影，hover 边框变色
代码块一键复制

GLASSMORPHISM

Glassmorphism

现代感渐变背景高级感

/ui-ux-pro-max

Glassmorphism 风格 [App名称]。
背景：深色渐变 #1a1a2e → #16213e
卡片：backdrop-filter: blur(20px)
     bg: rgba(255,255,255,0.07)
     border: rgba(255,255,255,0.12)
强调：#7c3aed 或 #3b82f6
字体：Inter 或 SF Pro
圆角 16px，亮色下提高不透明度

MATERIAL 3

Material Design 3

Android规范完整可访问性强

/ui-ux-pro-max

Material Design 3 风格 [App名称]。
Dynamic Color 色彩系统，主色自定义
组件：FAB、Navigation Bar、
     Card、Dialog、Chip（M3规范）
字体：Google Sans / Roboto Flex
圆角：超大（28px），柔和阴影
动效：150-300ms，共享元素过渡
适用栈：Jetpack Compose / Flutter

iOS MINIMAL

iOS Human Interface

iOS极简留白系统原生

/ui-ux-pro-max

iOS Human Interface 风格 [App名称]。
系统白 #FFFFFF，强调 #007AFF
字体：SF Pro Display / SF Pro Text
大量留白，内容为主
组件：Tab Bar、Navigation Bar、
     List、Sheet（iOS原生风格）
圆角 12-16px，细边框
适用栈：SwiftUI / React Native

NEUMORPHISM

Neumorphism / Soft UI

健康/wellness柔和立体感

/ui-ux-pro-max

Neumorphism soft UI 风格 [App名称]。
背景：#e0e5ec（浅灰蓝）
阴影：-5px -5px 15px #fff,
      5px 5px 15px rgba(0,0,0,.15)
圆角：12-16px，单色系
无硬边框，embossed/debossed 效果
动效：press 150ms inner shadow
适用：健康、冥想、轻量工具类 App

CYBERPUNK

Cyberpunk / Neon

游戏科技感记忆点强

/ui-ux-pro-max

Cyberpunk neon 风格 [App名称]。
背景 #0d0d0d，neon 绿 #00ff88
或 neon 蓝 #00cfff / 品红 #ff2d78
字体：等宽字体，terminal 质感
效果：text-shadow neon glow，
     scanlines 背景叠层
交互：glitch hover 动效（subtle）
适用：游戏平台、加密 App、创意工具

BENTO GRID

Bento Grid

现代 SaaS信息层次感Apple 风

/ui-ux-pro-max

Bento grid 风格 [App名称]，
参考 Apple Intelligence 展示页。
布局：不等宽网格，大小卡片混排
背景：白色或极浅灰 #f8f9fa
卡片：圆角 20-28px，轻微阴影
内容：每格聚焦单一信息，图标大
字体：SF Pro / Inter，粗细对比强
配色：克制，主色用于 CTA 卡片

Web 风格（8 种）

SAAS DASHBOARD

SaaS Dashboard

数据可视化企业级深色

/ui-ux-pro-max

SaaS 数据仪表盘 [产品名]。
布局：左侧 240px 导航，顶部栏，
     主内容卡片网格
配色：#0f172a 背景，#1e293b 卡片，
     #6366f1 强调，#22c55e 成功
图表：折线+柱状+环形组合
字体：Inter 正文，Roboto Mono 数字
组件：KPI 卡、迷你图、数据表、
     状态 badge

EDITORIAL

Editorial / Magazine

内容型排版优先高级感

/ui-ux-pro-max

Editorial 杂志风格 [网站名]。
背景：米白 #FDFBF7 或纯白
字体：Playfair Display（大标题）
     + Source Serif 4（正文）
排版：栅格系统，1.7 行距
强调：单色或双色，大字号标题
元素：引用块、分隔线、图片全幅
参考：《纽约时报》/ Medium 质感

BRUTALISM

Brutalism Web

创意机构记忆点强打破规则

/ui-ux-pro-max

Brutalism 风格 [网站名]。
背景：高饱和纯色（黄#f5f500/白/黑）
字体：Arial Black / Impact，超大字号
边框：2-4px 实线黑色
布局：刻意非对称，错位网格
无阴影，无圆角，无渐变
交互：hover 背景反转（黑白互换）
颜色：最多3色，强烈对比
参考：Figma 早期 / 创意机构官网

E-COMMERCE

E-Commerce Minimal

电商转化率优先干净

/ui-ux-pro-max

极简电商风格 [店铺名]。
背景纯白，大图优先，留白充足
CTA：#16a34a 主色（购买/加购）
字体：Inter 或 DM Sans
商品卡：图片占比 70%，hover 缩略图
价格：大字号，原价删除线
信任元素：评分、评价数、库存
布局：4 列网格，筛选侧边栏

LANDING PAGE

Landing Page Hero

产品宣传转化漏斗吸引眼球

/ui-ux-pro-max

高转化 Landing Page [产品名]。
结构：Hero → 痛点 → 功能特性
    → 社会证明 → 定价 → CTA
Hero：全屏渐变背景，大标题，
     副标题 + 主 CTA 按钮
字体：粗黑标题（800weight）+ 轻正文
CTA：强对比色，悬浮有动效
社会证明：Logo 墙 + 用户评价卡

CORPORATE

Corporate / Finance

金融企业专业可信

/ui-ux-pro-max

Corporate / 金融风格 [公司名]。
配色：深蓝 #1d4ed8 + 白 + 浅灰
字体：Inter 或 Source Sans Pro
布局：严谨网格，适当留白
图表：蜡烛图、折线图（Recharts）
数字：等宽字体，千分位格式化
信任：证书 badge、数据来源标注
无过度装饰，内容密度高

PORTFOLIO

Portfolio / Creative

设计师作品集个性化

/ui-ux-pro-max

创意作品集风格 [姓名/品牌]。
背景：极深色 #111 或纯白（二选一）
字体：衬线大标题 + 无衬线正文
作品展示：全宽图片，hover 遮罩
布局：Masonry 瀑布流或全屏切换
动效：页面过渡（GSAP/Framer），
     scroll-triggered 出现
光标：自定义 cursor
About：个人照片 + 简洁介绍

DOCUMENTATION

Documentation Site

技术文档可读性开发者

/ui-ux-pro-max

技术文档站风格 [产品名 Docs]。
布局：左侧目录树（固定），
     中间内容（max-width 720px），
     右侧大纲（固定）
配色：白底，代码块浅灰 #f3f4f6
字体：系统字体栈，代码等宽字体
代码高亮：Prism / Shiki
组件：Note/Warning/Tip 提示框，
     API 参数表，代码复制按钮

设计系统查询命令

获取完整设计系统

在项目目录运行，输出配色/字体/风格完整建议

# 完整设计系统（推荐先跑）
python3 .claude/skills/ui-ux-pro-max/scripts/search.py \
  "产品描述 风格关键词" \
  --design-system -f markdown -p "项目名"

# 示例
python3 .claude/skills/ui-ux-pro-max/scripts/search.py \
  "fintech dashboard dark professional" \
  --design-system -p "FinApp"

查询风格 / 字体 / 颜色

精准搜索特定设计元素，按 domain 分类检索

# 风格（67种可选）
python3 ... "glassmorphism dark" --domain style

# 字体搭配（57种）
python3 ... "elegant serif luxury" --domain typography

# 颜色方案（96种）
python3 ... "fintech blue calm" --domain color

# UX 规范
python3 ... "animation accessibility" --domain ux

提示词模板

直接复制使用，替换 [ ] 内容即可

ultrathink — 超深度推理

触发最长推理链，架构决策和复杂 Bug 专用

ultrathink 这个[架构/方案/问题]有什么潜在问题，
从[维度1]、[维度2]、[维度3]三个角度分析，
给出有证据支撑的结论和具体建议

关键词 ultrathink 触发最深推理，用在真正复杂的问题上

全自动功能实现

从分析到实现，一条命令完成整个功能

autopilot

帮我实现[功能名称]，要求：
1. 先分析现有代码结构（不修改）
2. 给出实现方案（等我确认）
3. 完整实现，包含错误处理
4. 写基础测试用例
5. 运行测试验证通过后结束

Bug 根因分析

不猜，找证据，系统性定位

[粘贴报错信息或描述问题]

分析这个 Bug：
1. 列出 3 个可能假设（从最可能到最少）
2. 每个假设给出验证方法
3. 不要直接给结论，先找证据
4. 证据确认后给出修复方案

代码审查

高级工程师视角，按严重性分级输出

以高级工程师视角审查：

[粘贴代码]

检查：逻辑缺陷和边界情况、
     安全漏洞（注入/溢出/泄露）、
     性能问题（N+1/内存泄露）、
     可读性和可维护性
按 Critical / Major / Minor 分级

需求澄清访谈（PM）

把模糊想法问成精准规格再动手

deep interview

我想做[产品/功能简述]。
开始实现前，先向我提问，搞清楚：
- 核心用户和使用场景
- 必须有 vs 可以没有的功能
- 技术约束和偏好
- 什么叫"做完了"（成功标准）

每次只问一个问题。

安全重构

改结构不改行为，有改必有据

重构 [文件/模块名]，规则：
1. 不改变任何外部行为
2. 不添加新功能
3. 只做：命名优化、消除重复、提升可读性
4. 每次改动说明理由
5. 最后运行测试确认全部通过

代码解释（新手友好）

说清楚"为什么"，不只是"做什么"

解释这段代码：
[粘贴代码]

背景：懂基础编程，但不熟悉这个技术栈
要求：
- 说清楚"为什么这么写"
- 遇到专业术语请解释
- 用中文，简洁直接

三模型交叉验证

重要决策用三个 AI 独立分析，再综合

ccg

[描述你的问题或方案]

请 Claude、Codex、Gemini 分别从各自
角度独立分析，最后给出：
1. 三方共同认可的结论
2. 存在分歧的点及原因