Stakpak Agent 新手教程：安全 AI DevOps 助手完整入门指南
Stakpak Agent 是一个开源的终端 AI DevOps 代理工具，用 Rust 编写而成。
它可以帮助你生成、调试和管理基础设施代码（如 Terraform、Kubernetes、CI/CD），最重要的是它有强大的安全机制：AI 不会直接看到你的真实密钥（秘密替换）、有守卫规则防止破坏性操作，还内置 DevOps 最佳实践（Rulebooks）。
简单来说，它是一个“不会意外泄露你 AWS 密钥的 AI 助手”。适合开发者、DevOps 工程师，尤其是担心 AI 工具安全性的新人。界面是终端图形界面（TUI），操作像聊天一样简单。这个教程从零开始，步骤超级详细，即使你没用过类似工具也能跟上。我们会覆盖安装、配置、基本使用和一些高级提示。
第一步：前提准备操作系统：支持 Linux、macOS、Windows（推荐 macOS 或 Linux，新手更容易）。
终端：macOS 用 Terminal，Linux 用内置终端，Windows 用 PowerShell 或 Windows Terminal。
API Key：需要一个 AI 模型的密钥。推荐：Anthropic（Claude）的 API Key（去 https://console.anthropic.com 获取）。
或者 OpenAI、Gemini 的 Key。
或者用 Stakpak 自己的免费 API Key（有限额，无需信用卡）。
如果用 Docker 方式，不需要安装其他东西。
第二步：安装 Stakpak Agent有几种安装方式，任选一种。新手推荐第一种（一键脚本）或 Homebrew。最简单：一键脚本安装（推荐新手）
打开终端，复制粘贴下面命令并回车：
curl -sSL https://stakpak.dev/install.sh | sh
这会自动下载并安装最新版本。
安装完后，输入 stakpak --version 检查是否成功（显示版本号就 OK）。
用 Homebrew 安装（macOS 或 Linux）
brew tap stakpak/stakpak
brew install stakpak
更新时用：brew update && brew upgrade stakpak
手动下载二进制文件去 GitHub Releases 页面：https://github.com/stakpak/agent/releases
下载适合你系统的文件（比如 macOS 是 stakpak-aarch64-apple-darwin.tar.gz）。
解压后，把可执行文件放到 PATH 路径下（比如 /usr/local/bin）。
用 Docker 运行（适合不想安装到本机的）
docker pull ghcr.io/stakpak/agent:latest
后面使用时会教怎么跑。
安装完后，重启终端或运行 source ~/.bashrc（或对应 shell 文件）让命令生效。第三步：配置 API Key（让 AI 能工作）Stakpak 支持多种方式，这里教两种最简单的。方式1：用 Stakpak 免费 API Key（最简单，无需自己的 Key）直接运行：
stakpak
第一次运行，它会引导你创建一个免费 Stakpak API Key（在浏览器打开页面，登录后复制 Key 粘贴回终端）。
或者手动设置环境变量：
export STAKPAK_API_KEY=你的key这里
要永久保存，加到 ~/.bashrc 或 ~/.zshrc 文件末尾。
方式2：用自己的 Anthropic/OpenAI Key（BYOK，推荐有预算的）创建配置文件：在家目录下创建文件夹和文件。
mkdir ~/.stakpak
nano ~/.stakpak/config.toml # 用 nano 或 vim 编辑，Windows 用 notepad
粘贴下面内容（选一个 provider）：
对于 Anthropic（Claude）：
[profiles.byok]
provider = "local"
smart_model = "claude-3-5-sonnet-20241022" # 或最新模型
eco_model = "claude-3-haiku-20240307"
[profiles.byok.anthropic]
api_key = "sk-ant-你的anthropic_key这里"
对于 OpenAI：
[profiles.byok.openai]
api_key = "sk-你的openai_key这里"
保存后，运行时加参数：
stakpak --profile byok
第四步：启动和基本使用启动 TUI 界面（图形聊天界面）：
stakpak
（如果用自己的 profile：stakpak --profile byok）
界面出现后，就像聊天一样输入问题：示例1： “帮我创建一个简单的 Terraform 文件来部署 AWS S3 桶”
示例2： “分析当前目录的 Kubernetes yaml 文件，有什么问题？”
示例3： “调试为什么我的 Docker build 失败了”
示例4： “帮我优化云成本，检查 AWS 资源”
AI 会思考、计划、执行工具（读文件、跑命令、编辑代码），并显示进度。
你可以批准或拒绝操作（安全机制）。
退出：按 Ctrl+C 或输入 exit。
恢复上次会话（如果中断）：
stakpak -c 上次的checkpoint-id
第五步：用 Docker 运行示例如果你用 Docker 安装，想操作本地项目：
docker run -it
-v "/var/run/docker.sock":"/var/run/docker.sock" \ # 如果需要 Docker 操作
-v "$(pwd)":"/agent/" \ # 挂载当前目录
--entrypoint stakpak ghcr.io/stakpak/agent:latest
第六步：高级功能小试（新手可选）启用子代理（更多专项帮助）：
stakpak --enable-subagents
隐私模式（隐藏 IP、账号 ID）：
加 --privacy-mode
MCP 服务器模式（高级，供其他工具连接）：
stakpak mcp start
常见问题解决命令 not found：检查安装路径，重启终端。
API Key 无效：重新生成或检查复制。
浏览器跳转失败：手动复制 Key 粘贴。
Windows 用户：推荐用 WSL2（Linux 子系统）运行，更稳定。
想卸载：Homebrew 用 brew uninstall stakpak，脚本安装手动删二进制文件。
额外提示项目官网：https://stakpak.dev/
详细文档：https://stakpak.gitbook.io/docs/
源码：https://github.com/stakpak/agent （可以 star 支持）
从简单任务开始练手，比如让它列出当前目录文件或生成一个 Dockerfile。
这个工具很强大，尤其安全方面领先其他 AI 代理。刚开始可能觉得终端操作陌生，多试几次就熟练了！