终端里的 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 有几个设计亮点：

1. Client/Server 分离，支持远程控制
2. SQLite 管理会话，持久化对话历史
3. 插件化设计，方便扩展功能
4. 统一接口适配多个 AI 提供商

使用注意事项

1. 需要支持 TUI 的现代终端，推荐 WezTerm、Alacritty、Kitty
2. 使用第三方 AI 模型需付费，Claude Pro 订阅相对划算
3. AI 生成的代码建议审查后再提交，特别是安全相关部分

总结

OpenCode 把 AI 助手集成到终端环境，对习惯命令行工作的开发者来说更自然。它不会替代编程能力，但能让重复工作更高效。

理解需求、设计架构、解决复杂问题仍需要人来完成，AI 是辅助工具。

如果你是终端重度用户，或想尝试新的 AI 编码方式，可以试试 OpenCode。

项目信息

GitHub 地址：sst/opencode

官方文档：opencode.ai/docs

TypeScript Vue+React+Node全栈：https://yunpan.plus/t/192

关注《云栈大前端》

分享前端工程、全栈开发、跨平台技术
每天推送实用开源项目和技术内容

原文：https://yunpan.plus/t/516-1-1
标签：#OpenCode #GitHub #AI编程 #终端工具 #开源项目 #全栈开发 #命令行