终端里的 AI 编程助手：OpenCode 使用指南
写代码时遇到过这种情况吗？
想问 AI 一个问题，得切到浏览器；让 AI 改代码，又要来回复制粘贴。编辑器、终端、浏览器反复切换，思路早断了。
OpenCode 解决的就是这个问题——直接在终端使用 AI 助手。
OpenCode 是什么
OpenCode 是一个开源 AI 编码工具，专为终端环境设计。装好后在命令行里直接和 AI 对话，让它帮你写代码、找 Bug、做重构。
主要特点：
- 原生终端界面，响应快，支持自定义主题
- 支持 Claude、GPT-4、Gemini 等多个 AI 模型
- 自动扫描项目文件，理解代码结构
- MIT 开源协议，GitHub 获 3 万+ 星标
安装配置步骤
第一步：安装
执行安装命令：
curl -fsSL https://opencode.ai/install | bash
也可以用包管理器：
# npm 安装
npm install -g opencode-ai
# Homebrew 安装（macOS/Linux）
brew install sst/tap/opencode
第二步：配置 AI 模型
运行配置命令：
opencode auth login
AI体系化课程，含：机器学习、深度学习、NLP、图像、大模型与推荐系统等
按提示选择 AI 提供商（Anthropic、OpenAI、Google 等），输入对应的 API Key。
推荐使用 Claude 3.5 Sonnet，代码能力较强。
第三步：初始化项目
进入项目目录：
cd your-project
opencode
在界面中输入初始化命令：
/init
OpenCode 会扫描项目，生成 AGENTS.md 文件记录项目信息，后续对话基于这个上下文进行。
实际使用场景
理解代码
输入：
这个 useAuth.ts 文件的作用是什么
OpenCode 会分析文件并给出说明：
useAuth.ts 是一个 React Hook，主要功能包括：
- 管理用户登录状态
- 提供 login/logout 方法
- 使用 Context API 共享认证信息
- 处理 JWT token 存储和刷新
修复问题
输入：
修复 api/users.ts 的类型错误
OpenCode 会定位错误位置，分析原因，给出修复方案，确认后自动修改文件。
添加功能
输入：
给 Express 项目加用户注册接口，需要邮箱验证和密码加密
OpenCode 会生成相关文件：
- 路由文件
routes/auth.ts - 控制器
controllers/authController.ts - 邮件服务
services/emailService.ts - 更新数据库模型
- TypeScript核心语法：https://yunpan.plus/t/376
同时提示需要安装的依赖包。
两种工作模式
Plan 模式（规划）
只分析不修改，适合代码审查、性能分析：
/plan 分析项目的性能瓶颈
Build 模式（构建）
实际修改代码，适合重构、添加功能：
/build 把 API 请求改用 axios 拦截器统一处理
常用功能
切换模型
/models
在不同 AI 模型间切换，比如用 Claude 写代码，用 GPT-4 做审查。
撤销修改
/undo
AI 改错了可以一键回滚。
分享会话
/share
生成公开链接，把对话记录分享给同事。
更换主题
/themes
或按 Ctrl+X 再按 T 切换终端主题。
适用人群
- 全栈开发者：支持前后端多种语言和框架
- 独立开发者：快速实现复杂功能
- 开源贡献者：理解陌生项目代码结构
- 终端用户：习惯命令行工作流程
技术实现
从技术角度看，OpenCode 有几个设计亮点：
- Client/Server 分离，支持远程控制
- SQLite 管理会话，持久化对话历史
- 插件化设计，方便扩展功能
- 统一接口适配多个 AI 提供商
使用注意事项
- 需要支持 TUI 的现代终端，推荐 WezTerm、Alacritty、Kitty
- 使用第三方 AI 模型需付费，Claude Pro 订阅相对划算
- AI 生成的代码建议审查后再提交，特别是安全相关部分
总结
OpenCode 把 AI 助手集成到终端环境，对习惯命令行工作的开发者来说更自然。它不会替代编程能力，但能让重复工作更高效。
理解需求、设计架构、解决复杂问题仍需要人来完成，AI 是辅助工具。
如果你是终端重度用户，或想尝试新的 AI 编码方式，可以试试 OpenCode。
项目信息
GitHub 地址：
sst/opencode官方文档：
opencode.ai/docsTypeScript Vue+React+Node全栈：
https://yunpan.plus/t/192
关注《云栈大前端》
分享前端工程、全栈开发、跨平台技术
每天推送实用开源项目和技术内容
原文：https://yunpan.plus/t/516-1-1
标签：#OpenCode #GitHub #AI编程 #终端工具 #开源项目 #全栈开发 #命令行
浙公网安备 33010602011771号