企业官网建设流程全解析

OpenCode 快速上手指南：三步在终端里跑起开源 AI 编程助手

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

OpenCode 是一个开源的 AI 编程 Agent（智能体）。它直接在终端里和你对话，能读懂代码、修改文件、执行命令，省去了在编辑器与 AI 工具之间来回切换的麻烦。

三步安装并启动

最短路径如下，任选其一安装：

npm i -g opencode-ai@latest

macOS 和 Linux 用户推荐用 Homebrew，版本更新更及时：

brew install anomalyco/tap/opencode

装好后，进入你的项目目录，直接运行opencode命令即可。它会以 TUI（Text User Interface，基于文本的交互界面）形式启动，出现输入框后直接输入需求，比如"帮我解释这个模块的入口文件"，Agent 会读取代码并给出回答，全程不需要离开终端。

核心功能

与两个内置 Agent 对话

OpenCode 内置两个 Agent，用Tab键随时切换：

• build：默认模式，拥有完整权限，可以改文件、跑命令，适合实际开发。
• plan：只读模式，默认拒绝修改文件、执行命令前会先征求同意，适合先探索陌生代码库、规划改动方案。

常见的用法是：先用 plan 模式搞清楚现状，再切回 build 模式动手改。

用 @ 精确引用文件与子任务

在输入框里用@可以引用项目中的文件，把讨论范围锁定到具体代码，而不是靠口头描述"那个组件"。另外还有一个general子 Agent，负责复杂搜索和多步任务，在消息里输入@general即可调用，适合"在整个仓库里找出所有调用这个函数的位置"这类跨文件任务。

三种形态任选

除了终端 TUI，OpenCode 还提供两种形态：

• 桌面应用（Beta）：brew install --cask opencode-desktop（macOS）或 Windows 下的 Scoop 安装。
• VSCode 插件：在扩展市场搜索 opencode 安装，也可以在仓库的sdks/vscode/目录下执行bun install && bun run package从源码构建。插件会在编辑器侧边栏内嵌终端并支持插入带行号的精确文件引用。

个性化与进阶用法

• 自定义快捷键：TUI 的按键绑定（如Ctrl+P打开命令列表、退出键Ctrl+C）都可以在配置里改写，默认还保留了Ctrl+X作为组合键前缀（leader key，用于组合出后续快捷键）。
• 切换主题：在 TUI 里按Ctrl+X再按t，从主题列表里选一个。
• Diff 视图：Agent 改动文件后可用 diff 查看器审阅，支持Enter接受/拒绝、[]在代码块间跳转，改错前可以先看全貌。
• 配置体系：更细的模型与行为配置见仓库内 packages/opencode/src/config/ 相关实现，或查阅官方文档站。

常见问题

Q：build 和 plan 模式有什么区别？build 可以改文件和执行命令；plan 是只读的，编辑默认被拒绝、命令需授权，适合分析阶段。

Q：怎么退出？按Ctrl+C或Ctrl+D，也可以用默认的Ctrl+X再按q。

Q：怎么让 Agent 只处理某个子任务？在消息里输入@general，交给内部子 Agent 处理复杂搜索和多步任务。

Q：旧版本升级要注意什么？安装前请先移除 0.1.x 之前的旧版本，避免命令冲突。

适合谁

如果你习惯在终端里工作，想要一个开源、可自托管、能直接读写代码的 AI 助手，OpenCode 值得试。它提供终端、桌面和 VSCode 插件三种入口，安装门槛低。项目地址：GitHub_Trending/openc/opencode，参与贡献请先读 CONTRIBUTING.md。

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