找回密码
 立即注册

终端里的 AI 编程助手:OpenCode 使用指南

卓卞恻 2025-11-4 14:24

svgviewer-png-output (21)

写代码时遇到过这种情况吗?

想问 AI 一个问题,得切到浏览器;让 AI 改代码,又要来回复制粘贴。编辑器、终端、浏览器反复切换,思路早断了。

OpenCode 解决的就是这个问题——直接在终端使用 AI 助手。

OpenCode 是什么

OpenCode 是一个开源 AI 编码工具,专为终端环境设计。装好后在命令行里直接和 AI 对话,让它帮你写代码、找 Bug、做重构。

主要特点:

  • 原生终端界面,响应快,支持自定义主题
  • 支持 Claude、GPT-4、Gemini 等多个 AI 模型
  • 自动扫描项目文件,理解代码结构
  • MIT 开源协议,GitHub 获 3 万+ 星标

screenshot

安装配置步骤

第一步:安装

执行安装命令:

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

也可以用包管理器:

[code]# npm 安装 npm install -g opencode-ai # Homebrew 安装(macOS/Linux) brew install sst/tap/opencode [/code]

第二步:配置 AI 模型

运行配置命令:

[code]opencode auth login [/code]

AI体系化课程,含:机器学习、深度学习、NLP、图像、大模型与推荐系统等

按提示选择 AI 提供商(Anthropic、OpenAI、Google 等),输入对应的 API Key。

推荐使用 Claude 3.5 Sonnet,代码能力较强。

第三步:初始化项目

进入项目目录:

[code]cd your-project opencode [/code]

在界面中输入初始化命令:

[code]/init [/code]

OpenCode 会扫描项目,生成 AGENTS.md 文件记录项目信息,后续对话基于这个上下文进行。

实际使用场景

理解代码

输入:

[code]这个 useAuth.ts 文件的作用是什么 [/code]

OpenCode 会分析文件并给出说明:

[code]useAuth.ts 是一个 React Hook,主要功能包括: - 管理用户登录状态 - 提供 login/logout 方法 - 使用 Context API 共享认证信息 - 处理 JWT token 存储和刷新 [/code]

修复问题

输入:

[code]修复 api/users.ts 的类型错误 [/code]

OpenCode 会定位错误位置,分析原因,给出修复方案,确认后自动修改文件。

添加功能

输入:

[code]给 Express 项目加用户注册接口,需要邮箱验证和密码加密 [/code]

OpenCode 会生成相关文件:

  • 路由文件 routes/auth.ts
  • 控制器 controllers/authController.ts
  • 邮件服务 services/emailService.ts
  • 更新数据库模型
  • TypeScript核心语法:https://yunpan.plus/t/376

同时提示需要安装的依赖包。

两种工作模式

Plan 模式(规划)

只分析不修改,适合代码审查、性能分析:

[code]/plan 分析项目的性能瓶颈 [/code]

Build 模式(构建)

实际修改代码,适合重构、添加功能:

[code]/build 把 API 请求改用 axios 拦截器统一处理 [/code]

常用功能

切换模型

[code]/models [/code]

在不同 AI 模型间切换,比如用 Claude 写代码,用 GPT-4 做审查。

撤销修改

[code]/undo [/code]

AI 改错了可以一键回滚。

分享会话

[code]/share [/code]

生成公开链接,把对话记录分享给同事。

更换主题

[code]/themes [/code]

或按 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编程 #终端工具 #开源项目 #全栈开发 #命令行


来源:程序园用户自行投稿发布,如果侵权,请联系站长删除
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!

路过

雷人

握手

鲜花

鸡蛋
文章点评
学习中心
站长自定义文字内容,利用碎片时间,随时随地获取优质内容。