🐮 Hermes

📦 简介

hermes-setup 是一个交互式命令行工具，帮助你快速完成 Claude Code 的完整配置：

• ✅ 自动检测环境依赖
• ✅ 安装 Claude Code（支持多种安装方式）
• ✅ 配置 API Key（支持 Anthropic 官方 / 302.AI / 自定义）
• ✅ 选择并安装 MCP Servers
• ✅ 选择并配置 Skills
• ✅ 生成项目配置文件

🚀 使用方式

方式 1：npx 直接运行（推荐）

npx hermes-setup

方式 2：全局安装后使用

# 全局安装
npm install -g hermes-setup

# 运行工具
hermes-setup

方式 3：从源码运行

# 克隆仓库
git clone https://github.com/yourname/hermes-setup.git
cd hermes-setup

# 安装依赖
npm install

# 运行
npm start

✨ 功能特性

1. 环境检测

自动检测以下依赖：

• Node.js (v18+)
• Git
• Claude Code

2. 多种安装方式

• 🍺 Homebrew (macOS)
• 🪟 winget (Windows)
• 📥 官方下载包
• 📦 npm 全局安装
• 🔧 手动指定路径

3. API Key 配置

支持多个 API 提供商：

• 🤖 Anthropic (官方)
• 🌐 302.AI (代理服务，国内访问更快)
• 🔧 自定义 OpenAI 兼容 API

4. MCP Servers

内置常用 MCP 服务器：

• 🌐 web-search - 网络搜索
• 🔗 fetch - HTTP 请求
• 📁 filesystem - 文件操作
• 🔀 git - Git 操作
• 🧠 memory - 长期记忆
• 🗄️ postgres - PostgreSQL
• 🐳 docker - Docker 管理
• 🐙 github - GitHub 集成
• ...更多

5. Skills

常用 Skills：

• 📝 commit - 自动生成提交信息
• 🔍 review - 代码审查
• 🧪 test - 测试生成
• 📚 docs - 文档生成
• 📋 plan - 任务规划
• ⚡ workflow - 工作流
• 🎨 frontend-design - 前端设计
• ...更多

💻 命令行选项

Usage: hermes-setup [options]

Options:
  -v, --version          显示版本号
  -s, --silent           静默模式，使用默认配置
  --api-key <key>        设置 API Key
  --install-path <path>  指定安装路径
  --skip-install         跳过安装步骤
  -h, --help            显示帮助信息

静默模式示例

# 使用默认配置安装
npx hermes-setup --silent

# 指定 API Key
npx hermes-setup --api-key=sk-ant-api03-xxxx

# 跳过安装，仅配置
npx hermes-setup --skip-install

📸 截图预览

欢迎界面

╔══════════════════════════════════════════════════════════════╗
║                                                              ║
║   🐮 Hermes  v1.0.0                                          ║
║                                                              ║
║   Claude Code 一键配置工具 - 帮你完成所有初始化配置              ║
║                                                              ║
╚══════════════════════════════════════════════════════════════╝

📋 环境检测结果:
   Node.js:     ✅ v20.10.0
   Git:         ✅ v2.45.0
   Claude Code: ❌ 未安装

安装方式选择

📦 安装配置
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚠️  Claude Code 未安装，请选择安装方式:

  1. 🍺 Homebrew (推荐 macOS)
  2. 🪟 winget (推荐 Windows)
  3. 📥 官方下载包
  4. 📦 npm 全局安装
  5. ⏭️ 跳过安装 (稍后手动安装)

API Key 配置

🔑 API Key 配置
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

选择 API 提供商:
  1. 🤖 Anthropic (官方)
  2. 🌐 302.AI (代理服务)
  3. 🔧 自定义 API

> 选择模型:
  1. Claude Sonnet 4 (推荐)
  2. Claude Opus 4.6
  3. Claude Haiku 3.5

📁 生成的文件

运行工具后会生成以下文件：

| 文件 | 说明 | |------|------| | .env | API keys 和环境变量 | | CLAUDE.md | 项目指导文件 | | .claude/settings.json | Claude Code 设置 | | .gitignore | Git 忽略规则 (追加) |

🔧 手动配置

如果你只想生成配置文件：

// 1. 引入模块
const { saveEnvFile, saveClaudeMd } = require('hermes-setup');

// 2. 配置
const config = {
  apiKey: 'your-api-key',
  model: 'claude-sonnet-4-20250514',
  mcpServers: ['filesystem', 'git'],
  skills: ['commit', 'review']
};

// 3. 生成配置
await saveEnvFile(config);
await saveClaudeMd();

📝 常见问题

Q: 提示 "node: command not found"

A: 请先安装 Node.js v18+，可以从 nodejs.org 下载。

Q: 权限错误 (EACCES)

A:

• Windows: 以管理员身份运行终端
• macOS/Linux: 使用 sudo 或修复 npm 权限

Q: 网络超时

A: 可以设置 npm 镜像源：

npm config set registry https://registry.npmmirror.com

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📄 许可证

MIT License