cofounder-computer-setup

计算机设置

这是一项健全性检查，不是主要安装途径。 新手引导会在 Agent 会话启动之前运行 install.sh 单行命令，该脚本已经安装了开发工具（以及联合创始人技能）。因此，会话启动时，包管理器、mise、podman 和 GH CLI 应该都已就绪。此技能会验证这些工具是否已安装；如果有工具缺失，则会引导用户再次运行同一条单行命令来修复安装。此操作具有幂等性，可安全重复运行。

1. 检测平台

uname -s 2>/dev/null || echo Windows

• Darwin → 按照 macOS / Linux（单行命令） 操作
• Linux → 按照 macOS / Linux（单行命令） 操作
• MINGW64_NT* / MSYS_NT* 或类似值 → 按照 Windows 操作

---

macOS / Linux（单行命令）

1. 检查工具是否已安装

command -v podman && command -v mise && command -v gh

在 macOS 上，还要检查 Homebrew：

command -v brew

如果所有工具都能正常解析，则跳到 阶段 2 — 验证。

2. 运行单行安装程序

如果上述工具中有任何缺失，请告诉用户打开一个新的 OS 终端（不是当前的 Claude 会话）并运行：

/bin/bash -c "$(curl -fsSL https://cofounder.locaweb.com.br/install.sh)"

为什么要使用单独的 OS 终端：安装程序的某些步骤需要使用 sudo（macOS 上安装 Homebrew，Linux/WSL 上安装软件包）。在 Claude 之外运行安装程序，用户就可以在出现提示时直接输入密码。

如何告诉用户打开新终端——措辞取决于用户的平台。使用以下命令在 Linux 上检测 WSL：

{ grep -qi microsoft /proc/version 2>/dev/null \
  || grep -qi microsoft /proc/sys/kernel/osrelease 2>/dev/null; } \
  && echo WSL

平台	告诉用户的内容（翻译成用户使用的语言）
macOS	打开 Spotlight（⌘+Space），输入 Terminal，然后按 Enter。
Linux（原生，无 WSL）	从应用程序菜单打开 Terminal 应用（例如，在 Ubuntu/GNOME 上按 Ctrl+Alt+T）。
Windows 上的 WSL	打开 开始菜单，输入 Ubuntu，然后按 Enter。必须打开一个全新的 Ubuntu shell，而不是 PowerShell 或命令提示符。

安装程序会：

• 检测 OS
• 在 macOS 上安装 Homebrew
• 安装 podman、mise、gh
• 在 macOS 上初始化并启动 podman machine
• 具有幂等性——已安装的任何工具都不会重复安装。

安装完成后，请让用户：

1. 再打开一个新的 OS 终端，以加载更新后的 PATH。使用上表中对应平台的措辞。
2. cd 回项目目录。
3. 再次运行 claude。

会话将从此处继续，联合创始人设置流程中的后续步骤也会接着进行。

---

Windows

注意： 在 Windows 上使用 bash 和 .bashrc 可能看起来有些奇怪—— Claude Code Desktop 使用 git bash 作为其 shell 环境。

1. 验证 WSL2

wsl --status

请解读完整输出，而不只是版本行。即使 WSL2 尚未正常运行，也可能显示 “Default Version: 2”——输出中仍可能包含提示缺少必需 Windows 功能的错误。请仔细阅读所有行，并留意任何有关配置不受支持、缺少可选组件或未启用虚拟化的消息。

例如，输出可能在显示 “Default Version: 2” 的同时，还包含如下错误：

WSL2 is not supported with your current machine configuration.
Please enable the "Virtual Machine Platform" optional component and ensure
virtualization is enabled in the BIOS.
Enable "Virtual Machine Platform" by running: wsl.exe --install --no-distribution

如果出现此类错误，请告诉用户：

1. 以管理员身份打开 PowerShell
2. 运行错误输出中指定的命令（在上面的示例中为 wsl.exe --install --no-distribution），并等待其完成
3. 重启计算机
4. 重启后返回 Claude Code

如果完全没有安装 WSL2，或者默认版本不是 2，请告诉用户：

1. 以管理员身份打开 PowerShell
2. 运行 wsl --install
3. 重启计算机
4. 重启后返回 Claude Code

重启后，重新运行 wsl --status 进行确认。在某些情况下，可能需要再次运行安装程序。

2. 安装 Podman

podman version

如果找不到该命令，请自行安装：

winget install --exact --id RedHat.Podman --accept-source-agreements --accept-package-agreements

如果 Podman 已安装，则不会执行任何操作。

3. 安装 mise

mise version

如果找不到该命令，请自行安装：

winget install --exact --id jdx.mise --accept-source-agreements --accept-package-agreements

如果 mise 已安装，则不会执行任何操作。

4. 安装 GH CLI

gh version

如果找不到该命令，请自行安装：

winget install --exact --id GitHub.cli --accept-source-agreements --accept-package-agreements

如果已安装 GH CLI，则此操作不会执行任何操作。

5. 重启 Claude

根据前面步骤的情况，选择一项：

1. 如果步骤 1 要求用户安装或重新安装 WSL（即用户必须运行 wsl --install 或 wsl.exe --install --no-distribution）：告知用户 重启电脑，并在重启完成后重新启动 Claude。

2. 如果步骤 2–4 安装了 podman、mise 和/或 GH CLI（但 WSL 已正常运行）：请用户重启 Claude，让新的 PATH 生效，并让会话以 cofounder agent 作为主线程重新启动。

   • 桌面应用： 在左上角选择 Arquivo（File）> Sair（Exit）。 告知用户重启后返回同一个聊天会话——他们可以选择 Código（Code） 选项卡，并在侧边栏中查找过往会话。
   • CLI（claude 命令）： 输入 /exit 退出，然后关闭并重新打开终端（或 PowerShell），以便使用更新后的 PATH 重新加载环境变量。之后，在同一项目目录中再次运行 claude。

3. 如果以上情况都不适用（所有工具均已安装）：无需重启——直接进入第 2 阶段。

---

第 2 阶段 — 验证并设置

验证 Podman

podman version

如果输出同时显示客户端和服务端版本，则 podman 已就绪。 在 macOS 或 Windows 上，如果出现需要 Linux VM 的错误：

podman machine init

如果电脑的 RAM 小于 16 GB，请添加 --memory 1024。

重要提示 — Rosetta 对话框（macOS）： podman machine start 可能会触发 macOS 对话框，提示安装 Rosetta，该对话框可能被其他窗口遮挡。Claude 无法与其交互。运行命令前，请让用户留意该对话框并点击 Install。安装 Rosetta 前，该命令会一直挂起。

podman machine start

macOS 上的单行安装程序已运行 init 和 start。仅在安装失败或用户使用 Windows 时，才需要执行这些步骤。

Podman 连接测试

podman run -d --name podman-setup-test-nginx -p 18080:80 docker.io/library/nginx:alpine

等待几秒，然后：

curl -s -o /dev/null -w '%{http_code}' http://localhost:18080/

预期结果为 200。清理：

podman rm -f podman-setup-test-nginx

验证 mise 和 GH CLI

mise x node@24 -- node --version

gh version

---

故障排除

• 运行单行命令后找不到工具：打开全新的操作系统终端，以重新加载 PATH，然后再次运行 claude。在 Linux/WSL 上，shell rc 文件只会在新 shell 中重新加载。尤其是在 WSL 上，新终端必须是全新的 Ubuntu 终端（开始菜单 → 输入 Ubuntu → 按 Enter），不能使用已打开的选项卡。
• Podman machine 无法启动（macOS/Windows）：检查是否已启用虚拟化（macOS 上运行 sysctl kern.hv_support）。确保没有冲突的虚拟机监控程序（例如 Docker Desktop）占用 VM 套接字。
• Windows 上的 WSL 问题：显示“Default Version: 2”并不代表 WSL2 一定正常运行——之后可能会出现缺少组件的错误。如果输出提到“Virtual Machine Platform”或类似内容，请让用户以管理员身份在 PowerShell 中运行 wsl.exe --install --no-distribution，然后重启。否则，请使用 wsl --install。
• 连接测试失败：nginx 容器可能还需要多一秒钟。重新运行 curl 检查。如果问题仍然存在，请检查防火墙规则，并确认端口 18080 未被占用。
• 安装程序无法识别 Linux 发行版：使用发行版的包管理器手动安装 podman 和 gh，然后重新运行单行命令——它会检测已存在的工具并跳过安装。

捆绑资源

• scripts/install.sh — 适用于 macOS 和 Linux 的单行安装程序。通过重定向地址 https://cofounder.locaweb.com.br/install.sh 提供（参见项目 CLAUDE.md）。