Claude Code Scripts

为 Claude Code 扩展视觉识别、图片生成、视频生成能力的脚手架脚本。

能做什么

脚本	能力	用法
vision.js	🔍 视觉识别	node vision.js <图片路径> [问题]
image-generate.js	🎨 图片生成	node image-generate.js "提示词" [--size 1024x1024]
video-generate.js	🎬 视频生成	node video-generate.js "提示词" [--size 1024x1024]

两种安装方式

方式一：AI 辅助安装（推荐 ✨）

如果你是 Claude Code 用户，直接把 SETUP.md 里的提示词发给你的 AI，它会一步步带你完成安装——包括获取 API Key、配置环境变量、验证运行。

方式二：手动安装

1. 放置文件

# 将 scripts 放到 Claude Code 配置目录
cp -r scripts ~/.claude/scripts/

# CLAUDE.md 可选，放 ~/.claude/ 下（如已有则自行合并）
cp CLAUDE.md ~/.claude/CLAUDE.md

2. 安装依赖

cd ~/.claude/scripts
npm install

3. 配置 API Key

# 复制配置模板到上层目录（注意：模板叫 env.example，没有前面的点）
cp env.example ../.env
# 编辑 .env，填入你的 API Key

支持两种模型后端：

• 千问（DashScope） — 视觉识别。👉 获取 Key
• Agnes AI — 图片/视频生成。👉 获取 Key

也兼容任意 OpenAI 格式的接口，在 .env 中按同样格式注册即可。

4. 验证

# 用一张测试图片验证视觉识别
node ~/.claude/scripts/vision.js "测试图片.png"

模型注册机制

.env 采用前缀层级注册，每类能力独立声明：

{厂商}_BASE=...            # API 地址
{厂商}_KEY=...             # API Key
{厂商}_{某某}_MODEL=...      # 模型名
{厂商}_{某某}_CAPABILITIES=vision,image-gen,video-gen  # 能力标签

脚本通过 _CAPABILITIES 后缀自动发现具备对应能力的模型，无需修改脚本代码。

文件结构

~/.claude/
├── .env               # 你的 API Key（不提交到 Git）
├── CLAUDE.md          # Claude Code 行为准则（可选）
└── scripts/
    ├── env.example    # 配置模板（可见文件，方便发现）
    ├── vision.js
    ├── image-generate.js
    ├── video-generate.js
    └── package.json