Impeccable 使用教程：在 Codex 和 Claude Code 里怎么用。

Impeccable 给编程 agent 一套设计词汇：bolder、quieter、critique、polish 这样的命令，再加上一个不调用大模型就能标出 AI 套路的检测器。它最擅长改进已有的界面。这篇教程讲怎么在 Codex 和 Claude Code 里安装、怎么为项目做初始设置、先学哪几个命令，以及全部打开之前要检查哪些设置。

更新于 2026年11月6日 · 阅读约 8 分钟

Impeccable 是什么

Impeccable 是 Paul Bakaus 开发的开源设计 skill（Apache 2.0 协议）。它最早基于 Anthropic 的 frontend-design，后来发展成两部分：24 个有名字的命令，从 bolder、quieter 这类设计调整，到 critique、audit 这类评审；以及一个规则固定的检测器，有 62 条规则，检查 AI 套路和质量问题。4.8 版支持 Codex、Claude Code、Cursor、GitHub Copilot、Gemini CLI 等很多 agent。

安装

在项目根目录运行：

npx impeccable install

安装程序会找到你用的编程工具，问你是只装在这个项目里还是装给所有项目，并提供一个设计 hook：agent 每改一个界面文件，都会自动检查一遍。装完后重新加载你的工具。

Codex： 打开 /hooks，批准这个项目的 hook，否则它不会运行。以后更新如果改动了 hook，需要再批准一次。在 Codex 里用 $impeccable（或者从 /skills 里）调用，而不是斜杠命令。
Claude Code： 同样可以用上面的安装程序；也可以用插件：先运行 /plugin marketplace add pbakaus/impeccable，再从 /plugin 里安装 Impeccable。

Node 只是用来运行 npx。skill 本身运行一个小引擎，第一次使用时下载到 ~/.impeccable/bin/。更新用 npx impeccable update。

为项目做初始设置

每个项目运行一次 init：

$impeccable init      # Codex
/impeccable init      # Claude Code 和大多数其他 agent

它会读你的代码，只问它推断不出来的问题（产品给谁用、必须做到什么、有哪些限制），然后写出 PRODUCT.md，之后每个命令都会读这个文件。如果你的 App 已经有自己的视觉风格，接着运行 document，把它记录进 DESIGN.md，之后的修改就不会偏离品牌。这两个文件都放进代码仓库。

从一个组件开始

Impeccable 在目标很具体时效果最好：仔细评审一个区块，胜过草草看一整页。写一个命令加一个目标：

/impeccable critique the pricing cards
/impeccable quieter the landing page hero
/impeccable typeset the settings page
/impeccable polish checkout

在 Codex 里，把 /impeccable 换成 $impeccable。也可以直接描述你想要什么，比如「重做这个首屏」。

先学这几个命令

类别	命令	用来
调整	`bolder`、`quieter`、`distill`、`colorize`、`typeset`、`layout`、`animate`、`delight`、`overdrive`	把设计的某一部分往明确的方向推
评审	`critique`、`audit`	得到打分的用户体验评审，或按 P0 到 P3 排序的技术报告
收尾	`polish`、`harden`、`clarify`、`adapt`、`optimize`、`onboard`	最后打磨、边界情况、文案、屏幕尺寸、性能、首次使用和空状态
迭代	`live`、`generate`	在浏览器里尝试某个元素的不同版本
准备	`shape`、`init`、`document`、`extract`	规划体验、写上下文文件、把重复的样式提取进设计系统

一个好用的入门循环：先 critique 一个界面，用 quieter、typeset 这类调整命令修最严重的那个问题，再 polish。在 agent 里单独输入 /impeccable 可以看到完整列表；常用的命令可以用 /impeccable pin audit 固定成快捷方式。

运行 AI 味检测器

检测器有 62 条规则，31 条查 AI 套路，31 条查质量，不需要大模型，也不需要 API key：

npx impeccable detect src/                   # 扫描源代码
npx impeccable detect http://localhost:5173  # 用 Chrome 或 Edge 扫描渲染后的页面
npx impeccable detect --github src/          # 输出 GitHub Actions 注释
npx impeccable detect --list-rules           # 列出所有规则

扫描源文件时只跑基于代码模式的规则；对比度太低、字太小这类需要渲染页面的规则，只有扫描网址时才会跑，所以也要对着开发服务器扫一遍。发现问题时它返回退出码 2，很容易接进 CI 让检查失败。如果你的品牌字体在它的「用烂了的字体」清单上，可以用 npx impeccable ignores add-value overused-font Inter --reason "Brand font" 放行。

先检查这几项设置

在 Claude Code 里，hook 不受模型审批控制。 即使你拒绝了模型的命令，已安装的 hook 仍会运行，所以第一次编辑就可能下载引擎。无人值守运行前先检查 hook。
live 模式可能在没有审批的情况下运行 agent。 在 live 模式里应用修改时，如果没有聊天会话在接收，它会启动 codex 或 claude 命令行，并关闭审批和沙箱。启动 live 模式前设置 IMPECCABLE_LIVE_COPY_AGENT=chat，让它留在聊天里；或者设成 off 关掉这个功能。
遥测。 新建设计时，它会从 impeccable.style 的目录拉取几个视觉方向。关闭遥测（npx impeccable telemetry off 或 DO_NOT_TRACK=1）只会停止匿名记录你选了哪个方向，不会停止这个请求。
出问题了？ /impeccable doctor 能找出过期的上下文文件和坏掉的 hook。

常见问题

Impeccable 收费吗？

不收费。它是 Apache 2.0 协议的开源项目。

Impeccable 能在 Codex 里用吗？

能。运行 npx impeccable install，在 /hooks 里批准项目 hook，然后用 $impeccable 调用。

Impeccable 能做手机 App 吗？

能。它除了网站也覆盖 App 界面，有 iOS 和 Android 的规范。想看其他选择的对比，见去 AI 味的设计 skill 横评。