SillySpec

Appearance

环境准备 ​

在开始使用 SillySpec 之前，你需要配置好基础的开发环境。本指南覆盖 macOS、Linux 和 Windows 三大平台。

系统要求 ​

工具最低版本推荐版本说明
Node.jsv18.0+v20+运行 SillySpec 脚本和 Claude Code
Gitv2.30+最新稳定版版本控制
Claude Codev2.0+最新版AI 编码助手（需 npm 安装）

提示

不确定版本？打开终端运行以下命令检查：

bash
node --version
git --version
claude --version

安装 Node.js ​

Node.js 是一切的基础。推荐使用 nvm（Node Version Manager）进行安装和版本管理。

macOS ​

方法一：使用 nvm（推荐）

bash
# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

# 重新加载 shell 配置
source ~/.zshrc  # 或 ~/.bashrc

# 安装最新 LTS 版本
nvm install --lts

# 验证
node --version

方法二：使用 Homebrew

bash
brew install node

# 验证
node --version

Linux（Ubuntu/Debian） ​

bash
# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

# 重新加载 shell 配置
source ~/.bashrc

# 安装最新 LTS 版本
nvm install --lts

# 验证
node --version

Windows ​

方法一：使用 nvm-windows（推荐）

  1. 前往 nvm-windows Releases 下载安装包 nvm-setup.exe
  2. 运行安装程序，按默认选项完成安装
  3. 打开 PowerShell，执行：
powershell
# 安装 LTS 版本
nvm install lts

# 使用该版本
nvm use lts

# 验证
node --version

方法二：官网安装包

前往 Node.js 官网 下载 Windows 安装包，双击安装即可。

安装 Git ​

macOS ​

bash
# 使用 Homebrew
brew install git

# 验证
git --version

注意

macOS 已内置 Git，但版本可能较旧。推荐通过 Homebrew 安装最新版。

Linux（Ubuntu/Debian） ​

bash
sudo apt update
sudo apt install git -y

# 验证
git --version

Windows ​

  1. 前往 Git 官网 下载安装包
  2. 运行安装程序，推荐选择 "Git from the command line and also from 3rd-party software"
  3. 打开 Git Bash 或 PowerShell 验证：
powershell
git --version

安装 Claude Code ​

Claude Code 是 Anthropic 推出的终端 AI 编码助手，SillySpec 的核心运行环境。

bash
npm install -g @anthropic-ai/claude-code

安装完成后，运行 claude 启动交互式会话，按提示完成 Anthropic 账号登录。

提示

如果你在国内网络环境下安装遇到网络问题，可以设置 npm 镜像：

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

安装完成后记得恢复默认镜像（Claude Code 自身的网络请求需要直连）。

配置智谱 GLM（可选） ​

如果你没有 Anthropic Claude 的 API 额度，可以使用智谱 AI 的 GLM 系列模型作为替代。GLM 模型兼容 Anthropic API 格式，可以直接接入 Claude Code。

获取 API Key ​

  1. 前往 智谱 AI 开放平台
  2. 注册/登录账号
  3. 进入控制台 → API Keys → 创建新的 API Key
  4. 复制生成的 Key（仅显示一次，请妥善保存）

配置 Claude Code ​

编辑 ~/.claude/settings.json 文件，添加以下配置：

json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的智谱API Key",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic"
  }
}

可用模型 ​

模型名特点适用场景
GLM-4.5-Air轻量快速，成本低日常编码、简单任务
GLM-4.7均衡型，性价比高中等复杂度项目
GLM-5旗舰模型，能力最强复杂架构、大型项目

在 Claude Code 中通过 /model 命令切换模型。

注意

智谱 GLM 的 API 调用需要消耗 Token 额度。建议先注册获取免费体验额度，再根据使用量选择付费方案。

下一步 ​

环境准备就绪！接下来进入 五分钟上手 快速体验 SillySpec。