内容
# ej_claudecode_setup
一套便携工具包,帮助您将全新的 **Claude Code** 安装升级为真正的创意技术开发环境 — 包含提示、配置、MCP 服务器和 shell 卫生习惯,使构建变得快速且符合品牌。
这是完整设置过程的精炼结果:安全保护的秘密、运行在 `uv` 上的 Python、调优的全局 `CLAUDE.md`、自定义斜杠命令 + 代理、干净的四服务器 MCP 堆栈和安全的 git/秘密习惯。
## 工具包内容
```
claude/
CLAUDE.md.template # 全局上下文,Claude 每次会话都会读取 — 请用您的身份定制
commands/
transcode.md # /transcode — ffmpeg/ImageMagick 配方,带有合理的默认值
figma-to-code.md # /figma-to-code — 拉取 Figma 框架并在您的堆栈中构建
agents/
media-engineer.md # 批量媒体管道(转码/合成/格式考古学)
mcp/
mcp-servers.md # Figma + Playwright + Supabase + Vercel — 每个服务器的作用 + 如何添加
shell/
secrets.env.template # 将 API 密钥保持在您的 dotfiles 之外(chmod 600,由 .zshrc 加载)
gitignore-global # 永远不要再提交 .env / 机密 / node_modules / __pycache__
docs/
SETUP.md # 完整的逐步指南,按顺序排列
install.sh # 可选的引导程序(复制命令/代理,连接 gitignore + 机密)
```
## 快速开始
```bash
git clone git@github.com:ellemakesthings/ej_claudecode_setup.git
cd ej_claudecode_setup
./install.sh # 非破坏性;备份它将覆盖的任何内容
```
然后阅读 **`docs/SETUP.md`** 以获取需要您输入的部分(身份、令牌、MCP OAuth)。
## 理念
- **给我看实物。** 任何视觉内容都会被渲染/截图,而不仅仅是描述 — 这就是 Playwright + Figma MCP 对的作用。
- **秘密永远不会接触到 dotfile 或提交。** 一个 `chmod 600` 文件,只需加载一次;全局 gitignore 作为备份。
- **每个任务使用一个工具。** `uv` 用于 Python,`ffmpeg`/`magick` 用于媒体,`gh` 用于 GitHub — 使用已安装的工具,而不是定制代码。
- **精简、专注的配置。** 您实际会使用的四个 MCP 服务器。零技能混乱。
## 要求
macOS(假设为 Apple Silicon),[Homebrew](https://brew.sh),Node 18+,和 [Claude Code](https://claude.com/claude-code)。有关工具链安装,请参阅 `docs/SETUP.md`。
---
*生成的可共享快照,作为工作设置的快照。请自定义 `CLAUDE.md.template` — 这是最高效的文件。*