如何把AI编程助手从玩具变成生产力工具：claude-codex-settings新手安装教程-开发者社区

【免费下载链接】claude-codex-settings

Battle-tested Claude Code, OpenAI Codex, Cursor configs, plugins, hooks and agents with Kimi, MiniMax and GLM API support.

项目地址：https://gitcode.com/gh_mirrors/cl/claude-codex-settings

点击查看免费下载

claude-codex-settings是一个经过实战检验的 AI 编程助手配置仓库，为 Claude Code、OpenAI Codex、Cursor 等工具提供即装即用的插件（plugins）、钩子（hooks）、子代理（agents）和技能（skills），并支持 Kimi、MiniMax、GLM 等 API。对新手来说，它相当于给 AI 编程助手装上一套"职业化装备"：代码评审、Git 工作流、办公文档处理、Python/React 最佳实践……全部开箱即用。

💡 为什么需要它？很多开发者抱怨 AI 助手"自作主张、过度设计、堆砌抽象"。这个仓库的配置正是针对这些坑设计的：先删再写、不造轮子、改动前必须先搜索确认。

一、项目全景：仓库里有什么

仓库整体结构一目了然：根目录放共享指导文件，plugins/目录下的每个插件都可以独立安装到 Claude Code、Codex CLI、Cursor 和 Gemini CLI。关键文件可以按需查看：

README.md：完整安装指南与插件列表
INSTALL.md：各工具的前置依赖与配置步骤
CLAUDE.md：仓库结构说明与跨工具插件格式参考
plugins/：所有插件的存放目录

精选插件速览

插件	作用	适合谁
`simplify`	从复用、冗余、过度设计等 4 个角度评审并清理你改动的代码	所有开发者 ⭐ 推荐首选
`humanize`	用 hook 拦截 53 个 AI 腔词汇（如 "seamlessly"），让 AI 写出人话	常让 AI 写文档的人
`codex-advisor`/`fable-advisor`	重大决策前让另一个模型"唱反调"，交叉审查方案	做架构决策时
`intelligent-compact`	会话自动压缩时保留文件路径、根因等关键信息	长会话重度用户
`anthropic-office-skills`	官方 PDF、Word、PPT、Excel 文档处理技能	办公自动化
`python-skills`/`react-skills`	基于 PEP 8、Zen of Python、Vercel 工程实践的代码规范	对应技术栈
`github-dev`	智能 commit、PR 创建与评审代理，带提交前确认 hook	团队协作

更多插件（MongoDB、Supabase、Stripe、Cloudflare、LiveKit 等）完整清单见 README.md。

二、一键安装步骤（以最常用的 Claude Code 为例）

前置条件

先确保已安装 Claude Code 本体，然后验证版本：

claude --version

Windows 用户在 PowerShell 中运行irm https://claude.ai/install.ps1 | iex即可安装，详细方式参考 INSTALL.md。

两步装好第一个插件

# 1. 添加插件市场（只需执行一次） claude plugin marketplace add fcakyon/claude-codex-settings # 2. 按名字安装任意插件 claude plugin install simplify@claude-settings

就这么简单。其他工具的对应命令：

工具	添加市场	安装插件示例
Codex CLI	`codex plugin marketplace add fcakyon/claude-codex-settings`	`codex plugin add simplify@claude-settings`
Cursor	运行`cursor-agent`后输入`/plugin`，在市场里选择安装	用户级或项目级安装
Gemini CLI	无需市场，本地克隆后安装（见下文）	`gemini extensions install --path ./plugins/simplify`

每个插件都独立可选，建议新手按"少装、精用"的原则，先装simplify和python-skills（或react-skills），用顺了再按需扩展。

三、Gemini CLI 用户：克隆仓库安装

Gemini CLI 走本地路径安装，需要先克隆仓库到本地：

git clone https://gitcode.com/gh_mirrors/cl/claude-codex-settings cd claude-codex-settings gemini extensions install --path ./plugins/simplify

四、让所有工具共享同一份 AI 行为准则

仓库最核心的资产是那份写给项目用的全局指导文件。用claude-tools插件的命令把它同步到~/.claude/CLAUDE.md，或在单个项目里直接保存为CLAUDE.md，再用软链接让其他工具复用：

ln -sfn CLAUDE.md AGENTS.md # Codex CLI、Cursor、Copilot 读取 ln -sfn CLAUDE.md GEMINI.md # Gemini CLI 读取

这一步完成后，你在任何一个 AI 工具里打开项目，得到的都是同一套"资深工程师"行为规范——这正是"把玩具变成生产力工具"的关键一笔。

五、5 分钟上手体验

试试代码评审命令

提交前在 Claude Code 中运行/simplify，它会对你的 staged 改动做复用、简化、效率、抽象层级四个角度的并行评审，然后直接应用清理结果。规则源码见 plugins/simplify/skills/simplify/SKILL.md。

试试"说人话"护栏

安装humanize后，AI 每次写文件时，leverage、seamlessly这类 AI 味词汇会被 hook 直接拦截并给出更朴素的替换词，清单逻辑见 plugins/humanize/skills/humanize/SKILL.md。

六、在 Claude 或 ChatGPT 里安装单个技能

不想装整套插件？仓库里的每个技能都提供 ZIP 包和网页端安装方式，适合快速尝鲜。

在 ChatGPT 中：进入 Skills 页面，打开 Open Skills，把下载的 ZIP 放进去即可。

在 Claude 中：打开 Customize 面板，选择右上角的 Add → Upload skill，上传技能文件。

七、国内模型友好：Kimi、MiniMax、GLM 支持

这是很多同类配置仓库没有的能力。仓库内置了多份现成的切换配置：

.claude/settings-kimi.json：用 Kimi K3（1M 上下文）驱动 Claude Code
.claude/settings-minimax.json：MiniMax M3 方案
.claude/settings-zai.json：GLM 模型，主打低成本

Codex CLI 侧则对应 .codex/config-kimi.toml 等配方文件，配置说明在 README.md 的 Configuration 章节。对于预算有限的用户，这是把 AI 编程助手真正用在日常项目里的重要一步。

八、常见问题排查

hook 不生效？部分 hook 依赖jq，而 Python/JS 格式化 hook 依赖ruff和prettier，缺失时会静默跳过。用ruff --version && npx prettier --version验证，依赖安装方法见 INSTALL.md。
插件装不上？先确认市场是否已添加（marketplace add只需执行一次），再检查工具版本是否足够新。
想要更完整的权限与模型配置？参考仓库自带的 .claude/settings.json（模型、权限白名单、自动模式一应俱全）。

总结

claude-codex-settings 的入门路径可以概括为三步：装市场 → 装插件 → 同步 CLAUDE.md。整个过程对新手非常友好，不需要理解 hooks 和 agents 的底层细节。建议从simplify开始，体验一次"AI 替你清理代码"的闭环，再根据自己的技术栈逐步加装react-skills、supabase-skills、github-dev等插件。配置好之后，你的 AI 编程助手才算真正从"聊天玩具"升级为团队里的生产力工具 🚀