1. 基础环境

• Git（--worktree 依赖 Git worktree）
• pinable 可执行文件
• 至少一个后端 CLI：codex / claude / gemini / opencode
• 对应后端 API Key

2. 后端与密钥

后端	命令	常见密钥环境变量
codex	codex	OPENAI_API_KEY
claude	claude	ANTHROPIC_API_KEY
gemini	gemini	GEMINI_API_KEY
opencode	opencode	依实现环境配置

只要安装并配置了其中一个后端，就可以开始使用。

3. 最小可用性检查

# pinable 可用
pinable version

# Git 可用（用于 --worktree）
git --version

# 后端至少一个可用（示例）
claude --version

4. 运行前建议

• 在目标仓库根目录执行任务
• 高风险任务开启 --worktree
• 团队场景统一 ~/.pinable/models.json 里的 agent/后端命名

5. 快速试跑

pinable --backend claude "分析当前项目的游戏活动模块结构并给出改造计划"

6. 当前命令面（用于环境校验）

pinable [flags] <task>
pinable resume <session_id> <task> [workdir]
pinable --parallel < tasks.txt
pinable version
pinable cleanup

本文仅保留当前可执行命令与环境准备步骤。