UPGPTs

中文

English

中文

English

Appearance

OMP（Oh My Pi）中文教程：安装、设置中文和常用命令 ​

作者：UPGPTs 团队首次发布：2026-10-25最后更新：2026-10-25

一句话结论： omp 是终端里的开源 AI 编程 Agent。装好只要一条命令，登录用 /login 或 /model；它没有中文界面语言包，但可以要求它全程用中文回答。

📌 更新于 2026-10-25。omp 更新较快，命令和配置以当前版本 /help 与 官方文档为准。

📚 本文目录（点击跳转） ​

安装 ​

Linux（一键脚本） ​

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

脚本会检测 Bun：有 Bun（≥ 1.3.14）就用 Bun 安装，否则下载预构建二进制。

Linux 一键安装脚本执行过程

macOS / Linux（Homebrew） ​

bash
brew install can1357/tap/omp

Bun（获取最新版） ​

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

Windows（PowerShell） ​

powershell
irm https://omp.sh/install.ps1 | iex

Windows 支持原生运行，不需要 WSL。

验证安装 ​

bash
omp --version

验证 omp --version 输出

中文设置：让它用中文回答 ​

先说明：omp 目前没有独立的中文界面语言包，终端 UI 以英文为主。所谓“设置中文”，实际是让模型用中文回答。

方法一：会话里直接要求（最快） ​

开始对话时说一句：

text
之后所有回答都用简体中文。代码、命令、报错原文、文件路径保持原样，不要翻译。

模型会在当前会话里按这个规则回答。新开会话要再说一次。

方法二：写进项目说明（长期） ​

在项目根目录维护一份中文规范，把要求写清楚，例如：

text
# 项目约定
- 所有解释、总结、计划用简体中文。
- 代码、命令、日志、报错原文保持原样。
- 提交信息用中文，代码注释按项目现有风格。

每次在这个项目里启动 omp，先让它读这份文件，再开始任务。这样不用每次重复交代。

方法三：固定提问模板 ​

把常用要求存成一段模板，每次粘贴：

text
请用简体中文回答。先给结论，再给步骤；命令用代码块；不确定的地方直接说不确定。

如果后续版本增加了语言开关，以 /help 里显示的命令为准；没有就不要猜。

常用命令速查表 ​

终端命令 ​

命令作用
omp启动交互式界面
omp --version查看版本
curl -fsSL https://omp.sh/install | shLinux / macOS 一键安装
brew install can1357/tap/ompHomebrew 安装
irm https://omp.sh/install.ps1 | iexWindows 安装
export PATH="$HOME/.local/bin:$PATH"临时修复 command not found

会话内命令 ​

命令作用
/login打开提供商选择器，走 OAuth 登录模型
/model打开模型选择器，配置 API Key 或切换模型

其他斜杠命令以当前版本的 /help 为准。不同版本可能有差异，本文只列已实测的两个。

第一次使用 ​

登录模型 ​

首次运行 omp 后：

  1. 输入 /login，选择 Anthropic、OpenAI、Gemini、Cursor、GitHub Copilot 等支持 OAuth 的提供商。
  2. 或者输入 /model，选择 provider 后粘贴 API Key。
  3. 配置完成后直接输入任务。

首次运行 omp 的 /login 登录方式选择界面

跑一个小任务 ​

text
请用中文，帮我写一个介绍 omp 的 HTML 页面，保存为 index.html

omp 会读取项目、生成文件并告诉你改了什么。想先了解它的完整能力，见 Oh My Pi 入门教程。

常见报错 ​

omp: command not found ​

安装目录没进 PATH。先临时加：

bash
export PATH="$HOME/.local/bin:$PATH"

永久生效追加到 ~/.bashrc 或 ~/.zshrc，然后重开终端。注意冒号后不要加空格。

安装后运行 omp 提示 command not found 的报错

登录后模型列表是空的 ​

  • OAuth 登录只解锁对应提供商的模型：登录 Anthropic 不等于登录 OpenAI。
  • 用 /login 重新选择提供商，或用 /model 直接配 API Key。
  • 确认账号本身有可用订阅或余额。

中文变成乱码 / 终端显示异常 ​

  • 确认终端使用 UTF-8。
  • Windows Terminal 不要用旧版控制台；PowerShell 里可先执行 chcp 65001。
  • 字体换成支持中文的等宽字体。

回答还是英文 ​

  • 在当前会话里明确说“请用简体中文回答”，不要只在心里默认。
  • 新会话重新说一次，或按上面的项目说明方式固定下来。

常见问题 ​

omp 有中文界面吗？
目前没有独立的中文界面语言包，终端界面以英文为主。可以要求模型用中文回答，代码、命令和报错原文保持原样。
怎么让 omp 一直用中文回答？
每次新会话先说一句“请用简体中文回答”；或者在项目里维护一份中文规范文件，让 omp 每次先读。没有找到永久语言开关时，这两种方式最稳。
安装后提示 omp: command not found 怎么办？
安装目录没进 PATH。临时执行 export PATH="$HOME/.local/bin:$PATH"，永久生效就追加到 ~/.bashrc 或 ~/.zshrc，然后重开终端。
omp 需要 API Key 吗？
需要模型凭据。可以用 /login 走 OAuth（Anthropic、OpenAI、Gemini、Cursor 等），也可以用 /model 粘贴各家的 API Key。
Windows 能用 omp 吗？
能。PowerShell 执行 irm https://omp.sh/install.ps1 | iex，原生运行，不需要 WSL。
omp 和 Pi 是什么关系？
omp 是 Oh My Pi 的简称，fork 自 Pi 并扩展了 LSP、DAP 调试器、Hashline 编辑和跨会话记忆。Pi 更极简，omp 更开箱即用。

相关教程 ​

相关阅读

先看教程