終端里的 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號