企业官网建设流程全解析

OpenCode 安装教程：3 分钟跑通开源终端 AI 编程助手的完整指南

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

OpenCode 是一款完全跑在终端里的开源 AI 编程代理（coding agent，即会自己读代码、按你的指令改文件、跑命令的程序）。它不自带模型，可以接 Anthropic、OpenAI、Google 等任意服务商，再往项目里丢一份配置文件就能把它调成你想要的样子。本文覆盖安装、首次对话、定制配置和报错自救四步。

一句话说清 OpenCode 是什么

它是住在你终端里的编程代理：你丢一个任务给它，它读代码、改文件、执行命令。默认带两个内置 agent，用 Tab 键随时切换——build 是默认的"全权限"模式，负责实际动手写代码；plan 是只读模式，不碰文件，适合先摸清一个陌生代码库或者让 agent 只出方案。它执行命令、改文件前都会先征求你同意，不会闷头乱动。

3 分钟安装：macOS、Linux、Windows（WSL）一条命令

🔧 先跑官方安装脚本，它会自动识别系统架构、下载二进制并写入 PATH：

# 官方一键安装脚本 curl -fsSL https://opencode.ai/install | bash

如果你更习惯包管理器，就换成npm i -g opencode-ai@latest（bun、pnpm 同理），macOS 上也可以brew install anomalyco/tap/opencode，效果一样。装完新开一个终端敲opencode --version，✅ 看到版本号就成了；默认安装目录是~/.opencode/bin，如果提示找不到命令，直接跳到文末排查一节。

上图就是启动 OpenCode 后看到的 TUI（终端用户界面）：版本号、内置命令列表，底部一行是当前使用的模型。

首次对话：先登录模型，再进项目

OpenCode 本身不含模型额度，得先登录一次：

# 交互式登录：选择服务商并粘贴你的 API key（接口密钥） opencode auth login

登录流程走完就算配好了密钥。接着进入你的项目目录直接敲opencode。第一次进新项目，建议先输入/init——它会扫描项目结构并生成一份 AGENTS.md 文件，作为 agent 每次干活前读取的背景说明，省得你反复解释"项目用的是什么语言、规范是什么"。之后在输入框直接描述任务就行，比如"给这个函数补一组单元测试"。

按需定制：只靠一个 opencode.json

💡 所有定制都写在一个 JSON 文件里，不用碰源码。全局配置放在~/.config/opencode/opencode.json，对所有项目生效；在项目根目录（或.opencode/目录）放一份opencode.json，则只在该仓库生效，方便随代码一起提交。

{ "$schema": "https://opencode.ai/config.json", "model": "anthropic/claude-sonnet-4", "agent": { "build": { "temperature": 0.3 } } }

最常改的是默认模型和各 agent 的生成参数：想要输出更稳，temperature 调低一点；想发散一点就调高。⚠️ 改完配置如果当前会话没生效，退出重进一次即可。

两个实战场景：纯终端和 VS Code

🛠 纯终端玩法：/models切换模型，/sessions翻历史对话，ctrl+x e唤起外部编辑器写长提示词，会话太长时用/compact压缩上下文。如果你习惯在编辑器里干活，仓库的sdks/vscode目录自带 VS Code 扩展源码，构建安装后效果类似下图：左边写代码，右边跟 agent 对话，改动直接以 diff 形式落在代码里。

翻车自救：三种报错的处理办法

提示opencode: command not found？PATH 没带上，重开终端，或手动把~/.opencode/bin加进 PATH。报 API key 无效？重跑opencode auth login重新粘贴密钥，并确认登录时选对了服务商。提示模型不存在？检查 opencode.json 里的模型名，最常见的坑是漏掉服务商前缀，应写anthropic/claude-sonnet-4而不是只写claude-sonnet-4。

就到这里。接下来可以试试：在现有项目里跑一次/init生成 AGENTS.md，或者用 Tab 切到 plan 模式，先让 OpenCode 只读地过一遍你的代码库。

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