企业官网建设流程全解析

OpenCode 三步上手指南：让 AI 编程助手直接在终端里干活

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

你是不是也这样：把一大段需求丢进网页聊天框，AI 吐出一整段代码，然后你再手动拷进项目、补依赖、修报错，来回折腾半天。OpenCode 是一个跑在终端里的开源 AI 编程助手，你用自然语言描述要做什么，它直接读代码、改文件、跑命令，全程不用离开终端。

它和聊天框里的 AI 有什么不一样

聊天式 AI 只负责"说"，OpenCode 是会"动手"的 agent（智能体）：它有一双能读写文件、能执行命令的手。有三点值得你先弄明白：

• 它就在你的项目里工作。你 cd 进哪个目录，它就有哪个项目的上下文，说话时知道你的文件结构和依赖，不是隔空猜代码。
• 模型随便换。Anthropic、OpenAI 这类服务商都支持，换个密钥就能切换，你的使用习惯完全不用变。
• 自带两种模式。默认的 build 模式是全权限干活的；只读的 plan 模式只做分析、不改一个字，专门用来摸陌生项目，按 Tab 键来回切换。

最快上手路径：三步跑通

第一步，安装。macOS 和 Linux 上最简单的方式是在终端执行一行命令：

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

习惯用 npm、Homebrew 的读者也可以走包管理器，装完效果一样。

第二步，配密钥。以 Anthropic 为例，设置一次环境变量就行：

export ANTHROPIC_API_KEY=你的密钥

把这行写进 shell 的配置文件里，以后每次打开终端自动生效，省去重复输入。

第三步，跑起来。进入任意项目目录，敲opencode进入交互界面。想确认装没装好，运行opencode --version看一眼版本号即可。

一个你马上会用到的场景

接了一个刚写到一半的项目，代码厚、没人接手过，你不知道从哪看起。先开 plan 模式，问一句"这个项目的入口在哪，一条请求的数据流经过哪些文件"，它会按文件结构给你讲清楚，而且全程不碰代码。摸清脉络后，用 Tab 切回 build 模式，派第一个真活：修掉某个工具函数里的边界 bug。它会直接改文件并给你看改动，不满意再让它重改一遍。比起在聊天窗口和编辑器之间来回复制，这条路短了不少。

这几个坑，提前知道

⚠️提示命令找不到：安装目录没进终端的 PATH。把安装目录加进 PATH，或者干脆新开一个终端窗口再试。

密钥不生效：密钥只在某一个 shell 会话里导出过，换个会话就没了。把 export 那行放进 shell 配置文件，让它常驻。

升级后行为怪异：如果你装过 0.1.x 及更早的旧版本，先卸载干净再装新版，避免新旧版本混着用。

下一步

别只收藏：挑你手里最熟的一个项目，现在就把 OpenCode 开起来，用 plan 模式问它"讲讲这个项目的启动流程"。跑通之后，可以顺着 官方文档 看看配置文件怎么写、自定义 agent 怎么配。

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