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个高频问题与解法
- 装完提示
opencode: command not found—— 脚本默认把可执行文件放在~/.opencode/bin或$HOME/bin，重开一个终端；或用OPENCODE_INSTALL_DIR指定一个已在 PATH 里的目录重装。 - 升级后行为怪怪的 —— 官方建议先移除 0.1.x 之前的旧版本再装新版。
- 桌面端启动卡住或闪退 —— 多由插件引起，先把配置文件里的
plugin数组清空，恢复后逐个启用排查。
让终端接管“AI工程师”的活。先从你项目里今天卡住的那个真实任务试一次。
【免费下载链接】opencodeThe open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/openc/opencode
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
