Claude Code Setup

个人 Claude Code 配置框架 — 快速在任何环境部署 Claude Code 及自定义工作流。

快速开始

git clone https://github.com/OneBoxCream/claude-code-setup.git
cd claude-code-setup

# 修改 script/claude_init.sh 中的 CUSTOM_INSTALL_DIR 为你的安装目录
# 然后执行一键部署
bash setup.sh

项目结构

├── setup.sh                     # 一键部署脚本
├── script/
│   ├── claude_init.sh           # Claude Code 安装脚本
│   └── claude_uninstall.sh      # 卸载脚本
├── my-claude-plugin/            # 自定义 ML 工作流插件 (v0.3.0)
│   ├── .claude-plugin/          # 插件元数据
│   ├── agents/                  # 专业代理
│   │   ├── planner.md           # 规划专家
│   │   └── architect.md         # 架构师
│   ├── commands/                # 用户命令
│   │   ├── plan.md              # /plan 增强规划
│   │   ├── log.md               # /log 文档记录
│   │   ├── checkpoint.md        # /checkpoint 进度快照
│   │   └── orchestrate.md       # /orchestrate 代理链编排
│   ├── skills/                  # 自动触发技能
│   │   ├── gradio-mlp/          # Gradio MLP 平台开发
│   │   ├── plan-enhanced/       # Plan Mode 质量增强
│   │   ├── python-ml-patterns/  # Python ML 最佳实践
│   │   ├── verification-loop/   # 代码变更验证
│   │   ├── strategic-compact/   # 智能压缩管理
│   │   ├── iterative-retrieval/ # 渐进式检索
│   │   └── doc-system/          # 文档管理体系
│   ├── hooks/hooks.json         # 自动化钩子
│   └── rules/python-ml.md       # 编码规范
├── config/
│   ├── settings.json            # 启用的插件配置模板
│   └── skills/                  # 个人级 Skills
│       └── gradio-mlp/          # Gradio 开发技能
└── CLAUDE.md                    # 项目 Claude 配置

组件说明

安装脚本 (script/)

• claude_init.sh — 下载 Claude Code 二进制，创建 wrapper 脚本，配置 CLAUDE_CONFIG_DIR
• claude_uninstall.sh — 清理安装

自定义插件 (my-claude-plugin/)

类型	名称	说明
Command	/plan	增强版规划 — 深度探索 + 多方案对比 + 风险评估
Command	/log	文档记录 — 实验日志、调研笔记、开发日志、决策记录
Command	/checkpoint	工作进度快照 — 创建/对比/管理代码状态快照
Command	/orchestrate	ML 代理链编排 — 多阶段任务自动调度，支持自动工作流选择
Agent	planner	规划专家，分析需求设计实现方案
Agent	architect	架构师，系统设计和数据流分析
Skill	plan-enhanced	Plan Mode 质量增强（自动触发）
Skill	python-ml-patterns	PyTorch/ML 代码最佳实践（自动触发）
Skill	gradio-mlp	Shopee MLP 平台 Gradio 开发适配（自动触发）
Skill	verification-loop	代码变更后自动验证（自动触发）
Skill	strategic-compact	长会话中建议最佳压缩时机（自动触发）
Skill	iterative-retrieval	大代码库中渐进式精准检索（自动触发）
Skill	doc-system	完整文档管理体系（自动触发）
Hook	PostToolUse	编辑 Python 文件后自动语法检查
Hook	PreToolUse	写入敏感文件前警告
Hook	Stop	会话结束时记录状态
Rule	python-ml	Python 3.8 + ML 编码规范

推荐的官方插件

pyright-lsp       # Python 代码智能
commit-commands    # Git 提交工作流
code-review        # 代码审查
feature-dev        # 功能开发工作流
code-simplifier    # 代码简化
claude-code-setup  # 配置分析推荐

迁移到新环境

# 1. 克隆仓库
git clone https://github.com/OneBoxCream/claude-code-setup.git

# 2. 修改安装目录（可选）
vim script/claude_init.sh  # 编辑 CUSTOM_INSTALL_DIR

# 3. 一键部署
bash setup.sh

# 4. 在 Claude Code 中注册插件
/plugin local /path/to/claude-code-setup/my-claude-plugin

自定义

• 添加新 Skill → my-claude-plugin/skills/<name>/SKILL.md
• 添加新命令 → my-claude-plugin/commands/<name>.md
• 添加新代理 → my-claude-plugin/agents/<name>.md
• 修改编码规范 → my-claude-plugin/rules/
• 修改钩子 → my-claude-plugin/hooks/hooks.json

修改后 push 到 GitHub，其他环境 git pull 即可同步。