AI 编码助手配置中心

让 Claude Code 和 Gemini CLI 开箱即用的配置模板

按费力度从低到高，用最少操作获得最大帮助

📑 目录导航

项目定位
快速部署
Part 1: Claude Code
Part 2: Gemini CLI
- 快速开始
- 前端场景速查
社区与支持
许可声明

项目定位

使用架构

本项目                      用户目录                    其他项目
├── .claude/  ──覆盖──>    ~/.claude/  <──读取──      .claude/ (空)
└── .gemini/  ──覆盖──>    ~/.gemini/  <──读取──      .gemini/ (空)

本项目：配置开发/维护环境，不参与实际业务开发
用户目录：实际生效的配置
其他项目：配置目录为空，自动使用用户目录配置

两套配置的关系

目录	服务对象	说明
`.claude/`	Claude Code	Anthropic 的 CLI 工具
`.gemini/`	Gemini CLI	Google 的 CLI 工具

两者完全独立：

Claude Code 只读取 ~/.claude/，不读取 ~/.gemini/
Gemini CLI 只读取 ~/.gemini/，不读取 ~/.claude/
配置内容可能相似（如禁止行为、技术栈偏好），但这不是重复，而是各自需要的独立配置

配置能力差异

特性	Claude Code	Gemini CLI
主配置文件	`.claude/CLAUDE.md`	`.gemini/GEMINI.md`
规则目录	`.claude/rules/` ✅	不支持 ❌
技能目录	`.claude/skills/` ✅	不支持 ❌
命令目录	`.claude/commands/` (.md)	`.gemini/commands/` (.toml)
命令格式	Markdown	TOML

规则同步方式：

Claude Code：规则拆分到 rules/ 目录，按文件组织
Gemini CLI：所有规则必须写在 GEMINI.md 一个文件中

如需在两个工具间同步规则（如禁止行尾注释），需分别在 .claude/rules/bash-style.md 和 .gemini/GEMINI.md 中维护。

支持的工具

工具	配置目录	部署位置	状态
Claude Code	`.claude/`	`~/.claude/`	✅ 完整支持
Gemini CLI	`.gemini/`	`~/.gemini/`	✅ 基础支持

快速部署

一键同步（推荐）

macOS/Linux：

./sync-config.sh

Windows：

sync-config.bat

脚本会自动将 .claude/ 和 .gemini/ 同步到用户根目录（~/.claude/ 和 ~/.gemini/），文件冲突时提供以下选项：

选项	按键	说明
覆盖当前文件	`y`	仅覆盖这一个
跳过当前文件	`N` 或回车	默认，仅跳过这一个
全部覆盖	`a`	后续所有文件都覆盖
全部跳过	`s`	后续所有文件都跳过

手动部署

Claude Code

# 只覆盖配置目录，保留历史记录
rm -rf ~/.claude/rules ~/.claude/skills ~/.claude/commands ~/.claude/templates ~/.claude/tasks
cp -r .claude/rules ~/.claude/
cp -r .claude/skills ~/.claude/
cp -r .claude/commands ~/.claude/
cp -r .claude/templates ~/.claude/
cp -r .claude/tasks ~/.claude/
cp .claude/CLAUDE.md ~/.claude/

Gemini CLI

# 只覆盖配置，保留认证信息
rm -rf ~/.gemini/commands
cp -r .gemini/commands ~/.gemini/
cp .gemini/GEMINI.md ~/.gemini/
cp .gemini/settings.json ~/.gemini/

注意：Claude Code 的 ~/.claude/ 包含历史记录（history.jsonl、projects/ 等），不能整体删除，只覆盖配置目录。Gemini CLI 的 ~/.gemini/ 包含认证信息（oauth_creds.json、google_accounts.json），同样只覆盖配置。

Part 1: Claude Code 配置

1. 快速开始

1.1 零费力（自动生效）- Rules

你需要做什么：什么都不用做

这些规则始终自动加载，在后台默默保护你：

规则	作用	触发场景
`claude-code-defensive.md`	防止测试篡改、过度工程化、中途放弃	始终生效
`ops-safety.md`	危险命令确认、回滚方案、风险提示	始终生效（详细规范见 skills）
`doc-sync.md`	配置/结构变更时提醒更新文档	修改配置时
`bash-style.md`	Bash 核心规范：禁止行尾注释	始终生效（详细规范见 skills）

效果示例：

Claude 不会修改测试来适配错误代码
执行 sysctl 等危险命令前会提示风险和回滚方案
新增命令后会提醒你更新 README

1.2 低费力（自动触发）- Skills

你需要做什么：正常写代码

操作相关文件时自动加载对应的开发规范：

技能	触发条件	提供的帮助
`go-dev`	操作 `.go` 文件	命名约定、错误处理、并发编程、测试规范
`java-dev`	操作 `.java` 文件	命名约定、异常处理、Spring 规范、不可变集合、线程池、代码模式
`frontend-dev`	操作 `.vue/.tsx/.css` 等	UI 风格约束、Vue/React 规范、TypeScript
`python-dev`	操作 `.py` 文件	类型注解、Pydantic、pytest、uv 工具链
`bash-style`	操作 `.sh/Dockerfile/Makefile/.md` 等	注释规范、tee 写入、heredoc、脚本规范
`ops-safety`	执行系统命令、服务器运维	风险说明、回滚方案、问题排查原则

效果示例：

写 Go 代码时，自动遵循 Effective Go 规范
写 Vue 组件时，自动使用 Composition API + TypeScript
不操作这些文件时，不消耗额外 token

1.3 中费力（显式调用）- Commands

你需要做什么：输入 /命令名

高频命令（日常使用）

命令	用途	使用示例
`/fix`	快速修复 Bug	`/fix 登录接口返回 500`
`/quick-review`	快速审查（git diff + 简要意见）	`/quick-review`
`/code-review`	正式代码审查	`/code-review`
`/debug`	复杂问题排查（复现→假设→验证→修复）	`/debug 定时任务不执行`
`/commit-msg`	生成 git commit message	`/commit-msg` 或 `/commit-msg all`

中频命令（按需使用）

| 命令 | 用途 | 使用示例 | |------|------

...

doccker/cc-use-exp

README