SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场cofounder-computer-setup

cofounder-computer-setup

部署与运维

查看项目

更新于 10-16 09:22

技能介绍

用途

本技能用于检查并修复 cofounder 开发环境所需的计算机工具链。它被定位为一次“健全性检查”，而非主要安装路径。在 agent 会话打开之前，初始化流程已经运行过 install.sh 一行命令，该脚本会安装开发工具以及 cofounder 技能。因此当会话存在时，包管理器、mise、podman 和 GH CLI 理应都已就位。本技能负责验证这一点，并在某个工具缺失时，指引用户回到同一行命令来修复安装。技能是幂等的，可以安全地重复运行。

主要能力

检测平台

使用 uname -s 2>/dev/null || echo Windows 判断平台。Darwin 和 Linux 走 macOS/Linux（一行命令）路径；MINGW64_NT*、MSYS_NT* 等走 Windows 路径。

检查工具是否已安装

运行 command -v podman && command -v mise && command -v gh；在 macOS 上还会检查 Homebrew：command -v brew。如果全部可解析，则跳到第二阶段“验证”。

运行一行命令安装器

如果上述工具有缺失，提示用户打开一个全新的操作系统终端（注意：不是当前 Claude 会话），并运行：

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

之所以需要独立的操作系统终端：安装器部分步骤需要 sudo（macOS 上的 Homebrew、Linux/WSL 上的包安装）。在 Claude 之外运行，用户可以亲自在提示时输入密码。

提示用户打开新终端的措辞取决于平台：

  • macOS：打开 Spotlight（⌘+Space），输入 Terminal，按回车。
  • Linux（原生，非 WSL）：从应用菜单打开终端应用（例如 Ubuntu/GNOME 上为 Ctrl+Alt+T）。
  • Windows 上的 WSL：打开开始菜单，输入 Ubuntu，按回车。必须是全新的 Ubuntu shell，而不是 PowerShell 或命令提示符。

安装器会：检测操作系统；在 macOS 上安装 Homebrew；安装 podman、mise、gh；在 macOS 上初始化并启动 podman 虚拟机；并且是幂等的——对已安装内容重复运行不会有副作用。

安装完成后，让用户：再打开一个全新的操作系统终端，以便加载更新后的 PATH（使用上表中对应平台的措辞）；cd 回项目目录；再次运行 claude。会话将从此处恢复，cofounder 设置序列的后续步骤会继续。

Windows 路径

注：在 Windows 上使用 bash 和 .bashrc 看似奇怪，因为 Claude Code Desktop 使用 git bash 作为其 shell 环境。

  1. 验证 WSL2：运行 wsl --status。需要解读整个输出，而不仅仅是版本行。“Default Version: 2”即使在 WSL2 尚未可用时也可能出现，输出中仍可能包含提示缺少所需 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

如果出现此类错误，告知用户：以管理员身份打开 PowerShell；运行错误输出中指明的命令（上例中为 wsl.exe --install --no-distribution）并等待完成；重启计算机；重启后回到 Claude Code。

如果 WSL2 完全未安装，或默认版本不是 2，告知用户：以管理员身份打开 PowerShell；运行 wsl --install；重启计算机；重启后回到 Claude Code。重启后再次运行 wsl --status 确认。某些情况下可能需要第二次安装。

  1. 安装 Podman：检查 podman version；如果命令未找到，自行安装：
winget install --exact --id RedHat.Podman --accept-source-agreements --accept-package-agreements

如果 Podman 已安装，此命令无副作用。

  1. 安装 mise：检查 mise version；如果命令未找到，自行安装：
winget install --exact --id jdx.mise --accept-source-agreements --accept-package-agreements

如果已有 mise，此命令无副作用。

  1. 安装 GH CLI：检查 gh version；如果命令未找到，自行安装：
winget install --exact --id GitHub.cli --accept-source-agreements --accept-package-agreements

如果已有 GH CLI，此命令无副作用。

  1. 重启 Claude，依据此前步骤情况选择：如果第 1 步要求用户安装或重装 WSL（即必须运行 wsl --install 或 wsl.exe --install --no-distribution），告知用户重启计算机并在重启完成后重新启动 Claude。如果第 2–4 步安装了 podman、mise 和/或 GH CLI（但 WSL 已正常），请用户重启 Claude，以便新 PATH 生效，会话以 cofounder agent 作为主线程重新开始。

桌面应用：选择左上角的 Arquivo (File) > Sair (Exit)。告知他们重启后回到同一个聊天会话——可以通过选择 Código (Code) 标签页，在侧边栏中查找过去的会话。

CLI（claude 命令）：输入 /exit 退出，然后关闭并重新打开终端（或 PowerShell），以便环境变量随更新后的 PATH 重新加载。之后，从同一项目目录再次运行 claude。

如果以上都不适用（所有工具均已安装）：无需重启，直接进入第二阶段。

第二阶段：验证与设置

验证 Podman：运行 podman version。如果输出同时显示客户端和服务器版本，podman 就绪。在 macOS 或 Windows 上，如果报错提示需要 Linux 虚拟机：运行 podman machine init，如果计算机内存小于 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 → 回车），而不是复用的标签页。
  • Podman 虚拟机无法启动（macOS/Windows）：检查虚拟化是否启用（macOS 上为 sysctl kern.hv_support）。确保没有冲突的虚拟机监控程序（例如 Docker Desktop）占用 VM socket。
  • 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）。