OpenCode 本地 AI 编程助手：装好、登录，5 分钟上手

OpenCode 本地 AI 编程助手：装好、登录，5 分钟上手

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

如果你平时在终端里写代码，OpenCode 是一个值得试试的开源 AI 编程助手。它跑在你自己的机器上，读你的代码、改你的代码，模型由你自己选。

先把 OpenCode 跑起来

安装就一条命令：

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

也可以用包管理器，比如npm i -g opencode-ai@latest或brew install anomalyco/tap/opencode。装完后先运行opencode auth login配置 API 密钥，再在项目目录里直接输入opencode启动。

你会看到一个终端界面：左侧是项目文件树，中间是对话区，底部是输入框。按Tab键可以在两个内置角色之间切换——build（默认，能改文件）和plan（只读，只分析不动手）。

它具体能帮你做什么

你要修一个 bug → 它自己定位并改代码。用一句话描述问题，它会自动调用内置的 read、grep、edit 等工具翻查文件，找到位置后直接给出修改。改动的文件会以 diff 形式展示，你确认后才落盘。工具的实现都在 packages/opencode/src/tool/ 目录里，包括读写文件、跑 shell 命令、抓取网页。

你要接手一个陌生项目 → 切到 plan 角色先摸清结构。plan 角色默认拒绝文件编辑，执行 bash 命令前还会先问你。你让它"讲讲这个项目的模块划分"，它会读文件、梳理依赖，但不会动一行代码。

你要在脚本里批量跑任务 → 用非交互模式。opencode run "给所有导出函数补上注释"跑完即退，适合挂进自动化流程。如果任务里要用到 MCP 服务，可以先opencode serve起一个常驻服务，再用--attach挂上去，省掉每次冷启动的时间。

和同类工具相比

和 Claude Code、Copilot 这类闭源或半闭源工具比，OpenCode 有两个实打实的不同：代码完全开源，你可以逐行审查它读了哪些文件、传了哪些内容；模型不锁定，Anthropic、OpenAI、Google、OpenRouter 或者你自己的本地推理服务都能接。

但也要说清楚它的代价。主界面是终端 TUI，没有图形化操作（有桌面版，但还标着 BETA）；它不附带任何订阅，API 密钥、模型选择、额度都归你自己管；模型答得好不好，取决于你配的是哪家服务。如果你想要的是装进 IDE 就能用、不用碰 API 配置的东西，那别选它，直接用带内置助手的 IDE 更省事。

怎么按自己的需求改

日常定制改一个文件就够了：项目根目录的opencode.json，可以定义自己的 agent、指定默认模型、收紧或放宽权限。需要更深度的扩展时看插件系统，入口在 packages/core/src/plugin/，里面展示了如何挂接自定义 provider、技能（skill）和命令。它还支持 MCP，把外部工具服务接进来不用改 OpenCode 本身的代码。

常见疑问

API 密钥存在哪？opencode auth login登录后保存在~/.local/share/opencode/auth.json。配好后用opencode models查看当前可用的模型清单，加--refresh强制刷新。

能用本地模型吗？可以。只要你的本地推理服务提供 OpenAI 兼容接口，在配置里加一个自定义 provider 就能用，请求就不会出你的机器。

怕它乱改文件怎么办？默认按Tab切到 plan 角色就是只读；也可以留在 build 角色，在opencode.json的权限配置里限制它哪些目录可写、哪些命令要批准。

写在最后

如果你主要在终端里干活、在意代码不出本机、并且习惯自己管 API 开销，OpenCode 现在就可以试。打开终端，把上面那两条命令敲完，进入你的项目目录输入opencode，剩下的它自己会做。

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