OpenCode：3分钟上手终端里的开源AI编程助手

OpenCode：3分钟上手终端里的开源AI编程助手

【免费下载链接】opencodeThe open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/openc/opencode

深夜构建挂了，报错日志翻了几屏，还得在文件和文档之间来回切着找原因。OpenCode 是一个跑在终端里的开源 AI 编程助手（coding agent）：装好之后用自然语言把需求说给它听，它会自己读代码、动手修改，再把改动讲给你听，全程不用离开命令行。

一条命令装好它，装完就能用

macOS、Linux 和 Windows 都用同一条安装命令：

curl -fsSL https://opencode.ai/install | bash

装完后进入你的项目目录，敲opencode就会进入全屏的终端界面（TUI），输入框立即可用。其余渠道也都支持：npm i -g opencode-ai、Homebrew、Windows 下的 Scoop，另有 Beta 版桌面客户端 🚀

它最拿手的三件事

一是直接读你的本地项目并动手改。不用解释目录结构，它会自己检索、读文件，你说“给登录函数加上输入校验”就行。二是内置两种模式，按 Tab 键就能切：build 是默认的完全访问模式，可以直接改代码；plan 是只读模式，只分析不动文件，接手陌生代码库时先切过去最安心。三是能嵌进脚本：opencode run "总结一下这个项目的结构"这类单条命令直接输出结果，方便接入 CI 或自动化流程。

一次真实任务演练：定位一次构建失败

假设你下班前构建挂了，卡在半道。

你说：进入项目根目录，运行opencode，按 Tab 切到 plan 模式，输入“构建失败了，帮我定位原因并给出修复建议”。它做：读取报错输出，检索相关源码和配置，给出一份只读分析，不会顺手把你的文件改了。你得到：一个清晰的根因结论和修复方案。如果认可，再按 Tab 切回 build 模式，说“按这个方案修”，它会直接改文件并展示改动对比。第二天接着聊同一件事时，用opencode -c继续上次会话即可。

上手之后：定制与进阶路径

• 模型与配置：全局配置在~/.config/opencode/opencode.jsonc，项目根目录的.opencode/下可以放项目级配置，方便按项目隔离模型和权限。
• 扩展能力：插件和 MCP 服务器可以接外部工具与数据源；opencode agent create能引导你创建一个自定义系统提示词和权限边界的 agent。
• 架构：OpenCode 是客户端/服务器设计，TUI 只是其中一个客户端，VS Code 扩展、Web 端乃至通过 SDK 自建集成都行，TUI 前端源码在 packages/tui/，完整文档在 packages/web/src/content/docs/。

常见坑：3个高频问题与解法

1. 装完提示opencode: command not found—— 脚本默认把可执行文件放在~/.opencode/bin或$HOME/bin，重开一个终端；或用OPENCODE_INSTALL_DIR指定一个已在 PATH 里的目录重装。
2. 升级后行为怪怪的 —— 官方建议先移除 0.1.x 之前的旧版本再装新版。
3. 桌面端启动卡住或闪退 —— 多由插件引起，先把配置文件里的plugin数组清空，恢复后逐个启用排查。

让终端接管“AI工程师”的活。先从你项目里今天卡住的那个真实任务试一次。

【免费下载链接】opencodeThe open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/openc/opencode