Prime Agent 新手教程

安装与登录

一条 curl 装好原生二进制，一条 /login 选提供商。本章顺带给出 Apple Silicon 本机的适配核对清单。

1环境要求：你的机器够格吗

官方安装脚本支持 macOS 与 Linux 两大平台，安装前会自动探测平台并校验 SHA-256。

项目要求说明
操作系统macOS 13（Ventura）+ / LinuxLinux 需 glibc ≥ 2.17 或 musl（Alpine 需补 libstdc++）
CPU 架构arm64 或 x86_64Apple Silicon 走 darwin-arm64 原生构建；老 x86 无 AVX2 也有 baseline 构建
系统工具curl、shasum/sha256sum、tar、mktempmacOS 自带，无需额外安装
GPU不需要模型推理全部在云端，本机只是客户端 + 内核
Python 运行时可由安装器引导安装交互安装时会问「Prepare Python runtime now?」，装 uv + Python 3.11 + prime-agent 运行时
Node.js仅源码运行需要 ≥ 22.8.0原生二进制安装不依赖本机 Node
本机适配结论（M1 Max / macOS 26.6.2）

完全适合。arm64 命中原生 darwin-arm64 构建（无需 Rosetta）；安装器自带 uv + Python 3.11 引导，与机器上已有的 Python 3.13 互不干扰；32 GB 内存对「客户端 + 持久内核」绰绰有余；若想从源码跑，本机 Node 22.22.2 也满足 ≥ 22.8 的要求。唯一的前置条件是准备一个模型提供商账号（见第 3 节）。

2一键安装

安装脚本会从官方发布源下载 tar.gz 产物、校验 SHA-256、装出 prime-agent 命令。

# 稳定版（macOS / Linux）
curl --proto '=https' --proto-redir '=https' -fsSL \
  https://app.primeintellect.ai/prime-agent/install.sh | sh

# 想尝鲜从 main 构建的 beta 版，追加参数
curl --proto '=https' --proto-redir '=https' -fsSL \
  https://app.primeintellect.ai/prime-agent/install.sh | sh -s -- beta

安装过程中会依次发生：

  • 探测平台（macOS 13+ / arm64 → darwin-arm64），下载对应压缩包并用 SHA256SUMS 校验；
  • 交互模式下询问是否「Prepare Python runtime now?」——默认 Yes，自动安装 uv、Python 3.11 和 prime-agent 运行时；
  • 产物落到 ~/.local/share/prime-agent/（可用 PRIME_AGENT_INSTALL_DIR 覆盖），命令软链到 ~/.local/bin/prime-agent。
如果 ~/.local/bin 不在 PATH 里，安装后请按脚本提示把它加进 shell 配置，否则终端找不到 prime-agent 命令。国内网络环境访问发布源不畅时，先配好代理再执行安装。

可选：从源码运行（适合想跟进开发的用户）：

git clone https://github.com/PrimeIntellect-ai/prime-agent
cd prime-agent
npm ci          # 需要 Node.js ≥ 22.8.0
./prime-agent.sh  # 也可在任意项目目录里调用绝对路径

3登录认证：订阅制或 API Key

Prime Agent 是「客户端 + 云端模型」架构，得先给它接上一个模型提供商。

方式一：订阅登录（推荐有订阅的用户）。启动后输入 /login，从列表选择提供商完成浏览器授权：

  • ChatGPT Plus / Pro（Codex，官方认可的 OSS 用法）
  • Claude Pro / Max（第三方外壳用量按 token 计费，走 extra usage）
  • GitHub Copilot（若提示 model not supported，先在 VS Code 里启用对应模型）
  • xAI Grok（需符合条件的订阅）

方式二：API Key。启动前设置环境变量，或在 /login 里选 API-key 提供商存入 ~/.prime/agent/auth.json：

export ANTHROPIC_API_KEY=sk-ant-...
prime-agent

常见提供商对应的环境变量（完整列表见官方 providers 文档）：

提供商环境变量备注
AnthropicANTHROPIC_API_KEYClaude 系列
OpenAIOPENAI_API_KEYGPT 系列
DeepSeekDEEPSEEK_API_KEY国内可直连
Google GeminiGEMINI_API_KEYGemini 系列
Kimi For CodingKIMI_API_KEY月之暗面
MiniMax / MiniMax (China)MINIMAX_API_KEY / MINIMAX_CN_API_KEY国内版走 CN 入口
小米 MiMoXIAOMI_API_KEY 等另设国内 / 新加坡 / 阿姆斯特丹 Token Plan 变量
OpenRouterOPENROUTER_API_KEY一个 Key 聚合多家模型
Prime InferencePRIME_API_KEYPrime Intellect 自家推理服务

凭据统一存在 ~/.prime/agent/auth.json（0600 权限），key 字段支持三种写法——字面量、环境变量名、甚至 "!command" 让 shell 命令输出作为密钥：

{
  "anthropic": { "type": "api_key", "key": "sk-ant-..." },
  "deepseek": { "type": "api_key", "key": "DEEPSEEK_API_KEY" },
  "openai": { "type": "api_key", "key": "!security find-generic-password -ws 'openai'" }
}
解析优先级：CLI --api-key > auth.json > 环境变量 > models.json 自定义提供商（Prime Inference 例外：PRIME_API_KEY 优先于 auth.json）。/logout 清除已存凭据，但不会 unset 你导出的环境变量。

4装完先认识这几条命令

这些是日常最高频的 CLI 子命令，第三章会实际用起来。

prime-agent agents             # 浏览运行中、空闲与已保存的会话
prime-agent attach <agent>     # 重新接入一个运行中的会话
prime-agent --resume [path|id] # 浏览会话列表，或直接恢复某个会话
prime-agent status             # 查看后台服务状态
prime-agent doctor [--fix]     # 检查或修复后台服务
prime-agent update [--force]   # 更新 Prime Agent
prime-agent shutdown [--force] # 停掉所有代理、worker 与后台服务
下一步

装好、登录完成，就可以进第三章跑第一次会话了。

Prime Agent 新手教程