环境搭建指南

本文假设你从未使用过终端（也叫"命令行"），会从最基础的操作开始讲起。

什么是终端？ 终端是一个让你通过输入文字命令来操作电脑的程序。平时你用鼠标点击图标打开软件，而在终端里，你输入一行命令然后按回车，电脑就会执行对应的操作。

什么是"输入命令"？ 就是在终端窗口里用键盘打字，然后按 Enter（回车键）。本文中所有灰色代码块里的内容都是需要你输入的命令。

本文分为 macOS 篇和 Windows 篇，请根据你的操作系统选择对应章节，只需阅读其中一篇即可。

macOS 篇

本篇所有命令均适用于 Apple Silicon（M1/M2/M3/M4 芯片，arm64 架构）和 Intel 芯片的 Mac。

第 1 步：打开终端

macOS 自带一个叫 Terminal（终端）的程序，你需要先找到它。

方法一 -- 使用 Spotlight 搜索（推荐）：

同时按下键盘上的 Command + 空格键，屏幕中央会弹出一个搜索框
输入 Terminal 或 终端
在搜索结果中点击 Terminal.app

方法二 -- 从应用文件夹打开：

打开访达（Finder，Dock 栏最左边的笑脸图标）
点击左侧的 应用程序
打开 实用工具 文件夹
双击 Terminal.app

打开后你会看到一个黑色或白色的窗口，里面有一行文字和一个闪烁的光标，这就是终端。

常见问题：打开终端

Q: Spotlight 搜索没有反应？ 检查键盘快捷键：打开 系统设置 > 键盘 > 键盘快捷键 > 聚焦，确认 "显示聚焦搜索" 的快捷键是 Command + 空格。

Q: 终端打开后显示 "zsh" 或 "bash" 是什么意思？ 这是终端使用的 CLI 解释器名称，属于正常现象，不影响后续操作。

第 2 步：安装 Homebrew

Homebrew 是 macOS 上最常用的包管理器，后续安装 Git、Node.js、Go 等工具都要通过它。

在终端中输入以下命令，然后按回车：

bash

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装过程中会提示你输入电脑的登录密码（输入时屏幕上不会显示任何字符，这是正常的），输入完按回车即可。整个安装大约需要 2-10 分钟。

Apple Silicon Mac 额外步骤（重要）：

安装完成后，终端会显示 "Next steps" 提示，你需要执行它给出的两行命令。通常是：

bash

echo >> ~/.zprofile
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

验证安装：

bash

brew --version

你应该看到类似输出：

text

Homebrew 4.x.x

常见问题：安装 Homebrew

Q: 提示 "Command Line Tools" 需要安装？ 这是正常的。Homebrew 会自动安装 Apple 的命令行开发工具，可能需要额外 5-15 分钟，耐心等待即可。

Q: 输入 brew --version 提示 "command not found"？ 说明 Homebrew 的路径没有生效。请执行上面 "Apple Silicon Mac 额外步骤" 中的命令，然后关闭终端窗口，重新打开一个新的终端窗口再试。

第 3 步：安装 Git

Git 是代码版本管理工具，用来下载和管理项目代码。

bash

brew install git

验证安装：

bash

git --version

你应该看到类似输出：

text

git version 2.x.x

常见问题：安装 Git

Q: 提示 "Already installed"？ 说明你的 Mac 已经自带了 Git（macOS 的命令行工具包含 Git），可以直接使用，跳到下一步。

Q: 提示 "brew: command not found"？ 说明第 2 步的 Homebrew 没有安装成功，请回到第 2 步重新操作。

第 4 步：安装 Node.js

Node.js 是 JavaScript 的运行环境，安装后会同时获得 npm （Node.js 的包管理器），后续安装 Claude Code 等工具需要用到它。

bash

brew install node

验证安装：

bash

node --version

你应该看到类似输出：

text

v22.x.x

再验证 npm：

bash

npm --version

你应该看到类似输出：

text

10.x.x

常见问题：安装 Node.js

Q: node --version 显示的版本号很低（比如 v16）？ 可能是系统中存在旧版本。运行 brew upgrade node 来升级到最新版。

Q: npm --version 提示 "command not found"？ npm 随 Node.js 一起安装。如果 node 命令正常但 npm 找不到，尝试关闭终端重新打开，或运行 brew reinstall node。

第 5 步：安装 Go

Go 是 Presto 后端和模板开发使用的编程语言。

bash

brew install go

验证安装：

bash

go version

你应该看到类似输出：

text

go version go1.23.x darwin/arm64

注意输出中的 darwin/arm64 表示你正在使用 Apple Silicon 版本，这是正确的。如果你使用 Intel Mac，会显示 darwin/amd64。

常见问题：安装 Go

Q: 显示 darwin/amd64 但我的 Mac 是 M1/M2/M3/M4？ 说明你安装了 Intel 版本的 Homebrew（可能通过 Rosetta 运行）。建议卸载后重新安装原生 arm64 版本的 Homebrew。

Q: 安装后 go version 提示 "command not found"？ 关闭终端重新打开再试。如果仍然不行，运行 brew link go。

第 6 步：安装 VS Code

VS Code（Visual Studio Code）是一个代码编辑器，用来编写和查看代码文件。

bash

brew install --cask visual-studio-code

验证安装：

安装完成后，你可以通过以下方式验证：

在 Spotlight 中搜索 Visual Studio Code 并打开
或者在终端中输入：

bash

code --version

你应该看到类似输出：

text

1.9x.x
<一串字母数字>
arm64

常见问题：安装 VS Code

Q: code --version 提示 "command not found"？ 打开 VS Code，按 Command + Shift + P，输入 shell command，选择 Shell Command: Install 'code' command in PATH，然后重新打开终端再试。

Q: 提示 "已损坏，无法打开"或被 Gatekeeper 阻止？ 在终端中运行 xattr -cr /Applications/Visual\ Studio\ Code.app，然后重新打开。

第 7 步：安装 Claude Code

Claude Code 是 Anthropic 推出的 AI 编程助手 CLI 工具， Presto 项目用它辅助开发。

bash

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

验证安装：

bash

claude --version

你应该看到类似输出：

text

1.x.x

常见问题：安装 Claude Code

Q: 提示 "permission denied" 或 "EACCES"？ 这是 npm 全局安装的权限问题。运行以下命令修复：

bash

sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}

输入电脑密码后重新执行安装命令。

Q: 安装成功但 claude 命令找不到？ 运行 npm config get prefix 查看 npm 全局安装路径，确认该路径下的 bin 目录在你的终端搜索路径中。通常关闭终端重新打开即可解决。

第 8 步：安装 cc-switch

cc-switch 是 Claude Code 的模型和配置切换工具，方便你在不同的 AI 模型之间快速切换。

bash

npm install -g cc-switch

验证安装：

bash

cc-switch --help

你应该看到类似输出：

text

Usage: cc-switch [options] [command]
...

常见问题：安装 cc-switch

Q: 提示 "permission denied"？ 解决方法同第 7 步的权限问题，参考上方的 sudo chown 命令。

Q: 安装成功但命令找不到？ 关闭终端重新打开再试。如果仍然不行，运行 npm list -g 确认包已安装，然后检查 npm config get prefix 输出的路径下是否有 bin/cc-switch 文件。

第 9 步：安装 get-shit-done

get-shit-done（GSD）是项目使用的工作流管理工具，用于规划和执行开发任务。

bash

npm install -g get-shit-done

验证安装：

bash

gsd --version

你应该看到类似输出：

text

x.x.x

常见问题：安装 get-shit-done

Q: 提示 "permission denied"？ 解决方法同第 7 步的权限问题，参考上方的 sudo chown 命令。

Q: gsd 命令找不到？ 关闭终端重新打开再试。也可以尝试用完整路径运行： $(npm config get prefix)/bin/gsd --version。

macOS 篇完成

恭喜！你已经完成了所有工具的安装。运行以下命令做最终确认：

bash

brew --version && git --version && node --version && npm --version \
  && go version && claude --version \
  && cc-switch --help | head -1 && gsd --version

如果每行都有正常输出且没有报错，说明环境搭建成功。

Windows 篇

本篇适用于 Windows 10（版本 1809 及以上）和 Windows 11。

第 1 步：打开 PowerShell

PowerShell 是 Windows 上的终端程序，你需要用它来输入命令。

方法一 -- 使用搜索（推荐）：

点击任务栏上的 搜索图标（放大镜），或按 Windows 键
输入 PowerShell
在搜索结果中右键点击 Windows PowerShell，选择 以管理员身份运行

方法二 -- 从开始菜单打开：

右键点击屏幕左下角的 开始按钮（Windows 图标）
选择 Windows PowerShell（管理员） 或 终端（管理员）

打开后你会看到一个蓝色背景的窗口，里面有一行路径文字和一个闪烁的光标。

后续步骤中，部分安装命令需要管理员权限，建议始终以管理员身份运行 PowerShell。

常见问题：打开 PowerShell

Q: 找不到 PowerShell？ Windows 10/11 都自带 PowerShell。如果搜索不到，尝试按 Windows + R，输入 powershell，按回车。

Q: 弹出"是否允许此应用对你的设备进行更改"？ 点击是。这是以管理员身份运行时的正常提示。

第 2 步：确认 winget 可用

winget 是 Windows 的包管理器，用来安装各种开发工具。

Windows 11 已自带 winget，直接验证即可。

Windows 10 需要先安装"应用安装程序"：打开 Microsoft Store，搜索 应用安装程序（App Installer），点击安装或更新。

验证 winget 可用：

powershell

winget --version

你应该看到类似输出：

text

v1.x.xxxxx

常见问题：winget 不可用

Q: 提示 "winget: 无法将'winget'识别为命令"？

打开 Microsoft Store，搜索 应用安装程序 并安装/更新
安装完成后关闭 PowerShell，重新以管理员身份打开再试

Q: Microsoft Store 打不开或无法安装？ 可以从 GitHub 手动下载安装：访问 https://github.com/microsoft/winget-cli/releases，下载最新的 .msixbundle 文件，双击安装。

第 3 步：安装 Git

Git 是代码版本管理工具，用来下载和管理项目代码。

powershell

winget install Git.Git

安装过程中如果弹出确认提示，输入 Y 并按回车。

安装完成后，关闭 PowerShell 并重新打开（这样新安装的命令才能被识别）。

验证安装：

powershell

git --version

你应该看到类似输出：

text

git version 2.x.x.windows.x

常见问题：安装 Git

Q: git --version 提示无法识别命令？ 关闭 PowerShell 重新打开再试。如果仍然不行，手动将 Git 添加到系统路径：在搜索栏搜索 环境变量，打开 编辑系统环境变量，在 Path 中添加 C:\Program Files\Git\cmd。

Q: winget 安装时提示"已安装更高版本"？ 说明 Git 已经安装过了，可以直接使用。

第 4 步：安装 Node.js

Node.js 是 JavaScript 的运行环境，安装后会同时获得 npm （Node.js 的包管理器），后续安装 Claude Code 等工具需要用到它。

powershell

winget install OpenJS.NodeJS.LTS

安装完成后，关闭 PowerShell 并重新打开。

验证安装：

powershell

node --version

你应该看到类似输出：

text

v22.x.x

再验证 npm：

powershell

npm --version

你应该看到类似输出：

text

10.x.x

常见问题：安装 Node.js

Q: node --version 提示无法识别命令？ 关闭 PowerShell 重新打开。如果仍然不行，检查 C:\Program Files\nodejs 是否存在，并将该路径添加到系统环境变量的 Path 中。

Q: npm 命令找不到但 node 正常？ 运行 where.exe npm 查看 npm 是否在路径中。如果不在，尝试重新安装：winget install OpenJS.NodeJS.LTS --force。

第 5 步：安装 Go

Go 是 Presto 后端和模板开发使用的编程语言。

powershell

winget install GoLang.Go

安装完成后，关闭 PowerShell 并重新打开。

验证安装：

powershell

go version

你应该看到类似输出：

text

go version go1.23.x windows/amd64

输出中的 windows/amd64 表示 Windows 64 位版本，这是正确的。

常见问题：安装 Go

Q: go version 提示无法识别命令？ 关闭 PowerShell 重新打开。如果仍然不行，检查 C:\Program Files\Go\bin 是否在系统环境变量 Path 中。

Q: 安装时提示需要重启？ 按提示重启电脑，重启后打开 PowerShell 验证即可。

第 6 步：安装 VS Code

VS Code（Visual Studio Code）是一个代码编辑器，用来编写和查看代码文件。

powershell

winget install Microsoft.VisualStudioCode

验证安装：

安装完成后，关闭 PowerShell 并重新打开，然后输入：

powershell

code --version

你应该看到类似输出：

text

1.9x.x
<一串字母数字>
x64

常见问题：安装 VS Code

Q: code --version 提示无法识别命令？ 关闭 PowerShell 重新打开。如果仍然不行，在搜索栏搜索 Visual Studio Code 确认已安装，然后手动将 C:\Users\<你的用户名>\AppData\Local\Programs\Microsoft VS Code\bin 添加到系统环境变量 Path 中。

Q: 安装后桌面没有快捷方式？ 在搜索栏搜索 Visual Studio Code 即可找到并打开。

第 7 步：安装 Claude Code

Claude Code 是 Anthropic 推出的 AI 编程助手 CLI 工具， Presto 项目用它辅助开发。

powershell

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

验证安装：

powershell

claude --version

你应该看到类似输出：

text

1.x.x

常见问题：安装 Claude Code

Q: 提示 "EACCES" 或权限错误？ 确保你是以管理员身份运行 PowerShell。如果仍然报错，尝试运行：

powershell

npm config set prefix "$env:APPDATA\npm"

然后重新执行安装命令。

Q: 安装成功但 claude 命令找不到？ 运行 npm config get prefix 查看 npm 全局安装路径，确认该路径在系统环境变量 Path 中。通常关闭 PowerShell 重新打开即可。

第 8 步：安装 cc-switch

cc-switch 是 Claude Code 的模型和配置切换工具，方便你在不同的 AI 模型之间快速切换。

powershell

npm install -g cc-switch

验证安装：

powershell

cc-switch --help

你应该看到类似输出：

text

Usage: cc-switch [options] [command]
...

常见问题：安装 cc-switch

Q: 提示权限错误？ 解决方法同第 7 步，确保以管理员身份运行 PowerShell。

Q: 安装成功但命令找不到？ 关闭 PowerShell 重新打开再试。

第 9 步：安装 get-shit-done

get-shit-done（GSD）是项目使用的工作流管理工具，用于规划和执行开发任务。

powershell

npm install -g get-shit-done

验证安装：

powershell

gsd --version

你应该看到类似输出：

text

x.x.x

常见问题：安装 get-shit-done

Q: 提示权限错误？ 解决方法同第 7 步，确保以管理员身份运行 PowerShell。

Q: gsd 命令找不到？ 关闭 PowerShell 重新打开再试。也可以尝试运行：

powershell

npx get-shit-done --version

如果这条命令有输出，说明安装成功但路径未生效，将 npm config get prefix 输出的路径添加到系统环境变量 Path 中即可。

Windows 篇完成

恭喜！你已经完成了所有工具的安装。运行以下命令做最终确认：

powershell

git --version; node --version; npm --version
go version; claude --version
cc-switch --help | Select-Object -First 1; gsd --version

如果每行都有正常输出且没有报错，说明环境搭建成功。

环境搭建指南 ​

macOS 篇 ​

第 1 步：打开终端 ​

第 2 步：安装 Homebrew ​

第 3 步：安装 Git ​

第 4 步：安装 Node.js ​

第 5 步：安装 Go ​

第 6 步：安装 VS Code ​

第 7 步：安装 Claude Code ​

第 8 步：安装 cc-switch ​

第 9 步：安装 get-shit-done ​

macOS 篇完成 ​

Windows 篇 ​

第 1 步：打开 PowerShell ​

第 2 步：确认 winget 可用 ​

第 3 步：安装 Git ​

第 4 步：安装 Node.js ​

第 5 步：安装 Go ​

第 6 步：安装 VS Code ​

第 7 步：安装 Claude Code ​

第 8 步：安装 cc-switch ​

第 9 步：安装 get-shit-done ​

Windows 篇完成 ​

环境搭建指南

macOS 篇

第 1 步：打开终端

第 2 步：安装 Homebrew

第 3 步：安装 Git

第 4 步：安装 Node.js

第 5 步：安装 Go

第 6 步：安装 VS Code

第 7 步：安装 Claude Code

第 8 步：安装 cc-switch

第 9 步：安装 get-shit-done

macOS 篇完成

Windows 篇

第 1 步：打开 PowerShell

第 2 步：确认 winget 可用

第 3 步：安装 Git

第 4 步：安装 Node.js

第 5 步：安装 Go

第 6 步：安装 VS Code

第 7 步：安装 Claude Code

第 8 步：安装 cc-switch

第 9 步：安装 get-shit-done

Windows 篇完成