夜雨聆风OpenCode 到底是什么
简单说，它是一个跑在终端里的 AI 编程助手。和 Cursor、Windsurf 这些图形界面工具不同，OpenCode 没有窗口、没有按钮、没有鼠标操作——你打开它就是一个黑色屏，用键盘输入指令，AI 直接帮你读写文件、执行命令、搜索代码。
听起来很硬核，但实际用下来我发现：对于写代码这件事，文字界面的效率反而比鼠标点来点去高很多。尤其当你需要让 AI 批量修改十几个文件的时候，在终端里一个命令就搞定了。
安装前的准备工作
你需要什么
关于 API Key
OpenCode 支持很多种 AI 服务商，新手建议选最简单的：
新手最推荐用 GitHub Copilot，原因很简单：如果你有 GitHub 账号，Copilot 本身就自带免费额度，而且在国内不需要代理就能用。配置方法后面会说。
安装步骤（三种方式选一个）
方式一：一键脚本安装（最简单）
打开终端，粘贴这一行：
curl -fsSL https://raw.githubusercontent.com/opencode-ai/opencode/refs/heads/main/install | bash等进度条走完就装好了。
方式二：Homebrew 安装（macOS / Linux 用户）
brew install opencode-ai/tap/opencode方式三：Go 安装
如果你装了 Go 语言环境：
go install github.com/opencode-ai/opencode@latest安装完成后，输入 opencode --version 验证：
opencode version 0.x.x看到版本号就说明装好了。
配置 API Key
方案一：用 GitHub Copilot（推荐，国内可用）
如果你用 GitHub Copilot 是最省事的：
export GITHUB_TOKEN=”你的GitHub个人访问令牌”或者创建一个配置文件 ~/.opencode.json：
{”providers”: {”copilot”: {”disabled”: false}},”agents”: {”coder”: {”model”: ”claude-sonnet-4”}}}
Copilot 的模型选择很丰富，包括 Claude Sonnet 4、GPT-4.1、Gemini 2.5 Pro 等。
方案二：用 OpenAI
export OPENAI_API_KEY=”sk-your-key-here”方案三：用 Google Gemini（有免费额度）
export GEMINI_API_KEY=”your-gemini-key”第一次启动
配置好之后，在你想要 AI 帮忙的项目目录里输入：
opencode你会看到终端变为一个分屏界面：
┌──────────────────────────────────────┐│ 对话区域 ││ （AI 的回复会显示在这里） ││ ││ ││ │├──────────────────────────────────────┤│ 输入区域 [按 i 开始输入] Ctrl+S 发送 │└──────────────────────────────────────┘
看起来很简单，但记住这几个快捷键就够了：
实际使用场景
场景一：让 AI 帮你写代码
进入项目目录，启动 opencode，按 i 进入编辑模式，然后输入：
帮我写一个 Python 脚本，批量把当前目录下的所有 .jpg 文件转换为 .png 格式按 Ctrl+S 发送，AI 会开始思考并生成代码。它可能会先询问你更多细节，也可能直接写好了让你审阅。
场景二：让 AI 修改现有代码
在这个文件里加一个函数，检查用户输入的邮箱格式是否合法AI 会读取文件内容，理解结构，然后生成修改方案。在终端里你可以看到它想改哪些行，确认后按回车接受。
场景三：让 AI 帮你调试
运行这个 Python 文件报错了，帮我看一下原因AI 会自动执行命令，查看报错信息，分析原因，然后给出修复方案。
场景四：批量搜索和替换
把项目中所有的 ”old_function_name” 替换为 ”new_function_name”，但要跳过 node_modules 目录AI 会通过 grep 工具找到所有匹配的位置，然后逐个文件修改。不需要担心漏掉某个文件。
进阶技巧
1. 非交互模式
不想进入 TUI 界面，直接一句话让 AI 干活：
opencode -p ”解释一下这个项目是做什么的”输出结果会直接打印到终端，然后退出。适合写脚本自动化。
2. 自定义命令
在 ~/.config/opencode/commands/ 目录下创建 .md 文件，可以定义你自己的快捷命令。
比如创建 ~/.config/opencode/commands/git/status.md：
RUN git statusRUN git log --oneline -5
然后在 OpenCode 里按 Ctrl+K，选择 user:git:status，它会自动执行这两个 git 命令并把结果交给 AI 分析。
3. LSP 支持
如果你装了对应语言的 LSP 服务器（比如 gopls、typescript-language-server），AI 可以获取代码的编译错误、类型信息等，改代码更准确。
4. MCP 扩展
OpenCode 支持 MCP 协议，可以连接外部工具。比如连上数据库 MCP 服务器，AI 就能直接查询数据库并帮你写 SQL。
常见问题
Q: 启动后界面是空白的？A: 检查 API Key 是否配置正确。运行 echo $ANTHROPIC_API_KEY 看看环境变量有没有生效。
Q: AI 生成的内容乱码？A: 终端编码问题。确保你的终端使用 UTF-8 编码。
Q: 安装脚本报错？A: 试试用 Homebrew 安装，或者从 GitHub Releases 页面下载二进制文件手动安装。
Q: OpenCode 和 Crush 是什么关系？A: OpenCode 是原项目，已经归档。Crush 是由 Charm 团队（Bubble Tea、Lip Gloss 等项目的作者）接手继续开发的新项目。目前 Crush 更活跃，功能也在持续更新中。
简单总结
OpenCode 适合这类人用：
习惯用终端工作，不想在 IDE 和终端之间来回切换 喜欢用键盘操作，对鼠标操作无感 需要在服务器（SSH 环境）里写代码 想试试命令行 AI 编程助手但不知道从哪开始
如果你觉得自己命令行操作不太熟，我的建议是：先装好，然后在你的个人项目上试着跑一跑。最开始可能有点不适应，但用几次就会发现，文字界面的效率确实比图形界面高出一截。
你装了之后记得回来评论区说说体验。有什么问题也直接留言，我尽量回。