Auto-Claude Setup 是 Auto-Claude 自主编码框架的完整安装与环境配置指南，覆盖 Windows、WSL、Linux 与 macOS 平台。以下内容依据资料整理。
【用途】 该技能用于在本地环境安装并配置 Auto-Claude 自主编码框架，完成从依赖准备、安装、认证、环境变量配置到验证运行的全流程。
【前置条件】 资料列出的要求包括：Python 3.12+（后端与 Memory Layer 需要）、Node.js 24+（前端需要）、npm 10+（包管理器）、Git（版本控制）、Claude Pro/Max 有效订阅、Claude Code CLI（可通过 npm install -g @anthropic-ai/claude-code 安装）。
【安装方式】 方式一：预构建发行包（推荐）。从 GitHub Releases 下载对应平台的安装文件，资料列出的版本为 2.7.2：Windows 为 Auto-Claude-2.7.2.exe；macOS（Apple Silicon）为 Auto-Claude-2.7.2-arm64.dmg；macOS（Intel）为 Auto-Claude-2.7.2-x64.dmg；Linux（通用）为 Auto-Claude-2.7.2.AppImage；Linux（Debian）为 Auto-Claude-2.7.2.deb。 方式二：从源码安装（开发用途）。依次执行：git clone https://github.com/AndyMik90/Auto-Claude.git；cd Auto-Claude；npm run install:all 安装全部依赖；npm run dev 以开发模式运行，或 npm start 构建并运行。
【各平台安装步骤】 WSL2：执行 wsl --update 更新；通过 sudo apt update && sudo apt install -y python3.12 python3.12-venv python3.12-dev 安装 Python 3.12；使用 nvm 脚本安装并切换到 Node.js 24；克隆仓库并运行 npm run install:all；最后执行 claude setup-token 配置 OAuth 令牌。 Windows（原生）：使用 winget install Python.Python.3.12 安装 Python 3.12；winget install OpenJS.NodeJS.LTS 安装 Node.js；npm install -g @anthropic-ai/claude-code 安装 Claude Code CLI；克隆仓库并运行 npm run install:all。 Linux（Ubuntu/Debian）：通过 apt 安装 python3.12 及相关包；通过 NodeSource 脚本安装 Node.js 24；sudo npm install -g @anthropic-ai/claude-code 安装 CLI；克隆仓库并运行 npm run install:all。 macOS：如未安装先安装 Homebrew；brew install python@3.12 node@24；安装 Claude Code CLI；克隆仓库并运行 npm run install:all。
【认证设置】 执行 claude setup-token 生成 OAuth 令牌（会打开浏览器认证）。令牌保存位置：macOS 为 Keychain，Windows 为 Credential Manager，Linux 为 ~/.config/claude/credentials。
【环境配置】 进入 apps/backend 目录，执行 cp .env.example .env 创建配置文件。必需配置项为 CLAUDE_CODE_OAUTH_TOKEN（若未使用钥匙串）。可选配置项包括：AUTO_BUILD_MODEL（模型覆盖，默认 claude-opus-4-5-20251101）、DEFAULT_BRANCH（默认 git 分支）、DEBUG 与 DEBUG_LEVEL（调试模式）、LINEAR_API_KEY（Linear 集成）、GRAPHITI_ENABLED、GRAPHITI_LLM_PROVIDER、OPENAI_API_KEY（记忆系统 Graphiti）。
【验证安装】 通过 python3 --version 确认 Python 为 3.12+，node --version 确认 Node.js 为 24+，claude --version 确认 CLI。后端测试：进入 apps/backend，激活虚拟环境（Linux/macOS 为 source .venv/bin/activate，Windows 为 .venv\Scripts\activate），执行 python run.py --help。前端测试：进入 apps/frontend 执行 npm run dev。
【运行首个任务】 进入 apps/backend 并激活虚拟环境后，可使用 python spec_runner.py --interactive 交互式创建 spec，或使用 python spec_runner.py --task "Add a hello world endpoint" 指定任务描述。
【项目结构】 Auto-Claude/ 包含 apps/backend（Python CLI 与 agents，含 agents、core、prompts、spec 目录及 run.py 入口和 .env 配置）、apps/frontend（Electron 桌面 UI）、guides（文档）、tests（测试套件）、scripts（构建工具）。
【常见问题】 Windows 下 node-gyp 报错：安装 Visual Studio Build Tools 2022，勾选「Desktop development with C++」工作负载，添加「MSVC v143 - VS 2022 C++ x64/x86 Spectre-mitigated libs」，重启终端后重新执行 npm install。Python 版本不匹配：用 which python3 和 python3 --version 检查当前版本，使用 python3.12 -m venv .venv 创建指定版本虚拟环境。OAuth 令牌问题：重新运行 claude setup-token，用 echo $CLAUDE_CODE_OAUTH_TOKEN 验证，用 claude --version 检查 CLI 是否正常。
【相关技能】 资料列出 auto-claude-cli（核心 CLI 操作）、auto-claude-spec（spec 创建工作流）、auto-claude-memory（记忆系统配置）、auto-claude-troubleshooting（调试指南）。
【限制】 资料未提供收费、价格、性能指标或具体效果说明等信息。