跳转至

Oh My Pi 安装指引（主推）

本课程主推 Oh My Pi（命令行工具名 omp），理由：

  • 开源（MIT），可读源码，学 Agent 原理不求人
  • 课堂全程使用 DeepSeek deepseek-v4-flash，omp 原生支持，配合 Agent 入门经济建议充值 100 元即可开练
  • 内置成本仪表盘（omp usage），帮你建立成本—质量—延迟意识
  • 跨平台：macOS / Linux / Windows（WSL 或 PowerShell）

前置要求

  • 一台能上网的电脑；如果网络受限（访问 GitHub/安装脚本卡住），请先配置代理（参考群内网络指引或 ~/.zsh/user.zsh 的代理函数）
  • 已按 Agent 入门经济建议 在 DeepSeek 开放平台充值并准备好 API Key（sk-...）

第一步：安装

根据你的系统选择一种方式：

macOS / Linux（推荐）

curl -fsSL https://omp.sh/install | sh

安装完成后，omp 命令即可使用。

Homebrew（macOS）

brew install can1357/tap/omp

Bun 全局安装（全平台通用）

先安装 Bun（要求 Bun ≥ 1.3.14）：

curl -fsSL https://bun.sh/install | bash

再全局安装 omp：

bun install -g @oh-my-pi/pi-coding-agent

Windows

  • PowerShell（原生）：
irm https://omp.sh/install.ps1 | iex
  • WSL：在 Ubuntu 里按上面的 macOS / Linux 方式安装，之后在 WSL 终端中使用。

第二步：启动

进入任意项目目录，运行：

mkdir -p ~/projects/vibecoding
cd ~/projects/vibecoding
omp

其他运行方式

  • omp "帮我查看当前目录结构" —— 带初始提示词启动
  • omp -p "这个报错怎么解决？" —— 非交互模式，处理完退出
  • omp --continue "刚才说到哪了？" —— 继续上一次会话

第三步：配置 DeepSeek

在 omp 会话中输入：

/login deepseek

按提示粘贴你在 platform.deepseek.com 创建的 API Key（sk-...）。

备选方式

也可以把 Key 写入环境变量：

export DEEPSEEK_API_KEY=sk-你的密钥

或者写入 ~/.omp/agent/models.yml 的自定义 provider 配置（详见 omp 文档的 Models 配置）。

第四步：选择课程模型

课程课堂全程使用 deepseek-v4-flash：

  • 启动时指定：omp --model deepseek/deepseek-v4-flash
  • 会话内切换：输入 /models 选择；或按 Ctrl+L 打开模型选择器
  • 查看有哪些模型：omp --model v4-flash（支持模糊匹配）或 omp models

验收安装

让 omp 打个招呼：在会话里输入"你好，介绍一下你自己"，能正常回复即安装成功。

成本意识

输入 /usage（或运行 omp usage）查看用量与成本，感受一下 token 是怎么烧的——"亲自使用，才能形成成本—质量—延迟意识"。

常见问题

1. 安装脚本卡住 / 网络错误

大概率是访问 omp.sh 或 GitHub 受限。先配置代理再重试，或改用 Homebrew / Bun 方式安装。

2. 提示模型不可用（没有凭证）

未登录或 Key 不对。在会话里运行 /login deepseek，确认 Key 已正确粘贴；也可以检查环境变量是否已导出。

3. omp 命令找不到

  • 如果是 curl 脚本安装：重新打开终端，或把 ~/.local/bin 加入 PATH
  • 如果是 Bun 全局安装：确认 bun --version ≥ 1.3.14，并检查 ~/.bun/bin 是否在 PATH 中

参考引用