从零开始学习 opencode 命令行工具,释放 AI 编程的无限潜能
开源 AI 编程代理,让代码编写变得更智能
用日常语言描述需求,AI 自动生成代码
自动理解项目结构和代码逻辑
无需手动复制粘贴,直接应用代码变更
支持撤销、重做和版本控制集成
5 分钟完成环境搭建
从 GitHub Releases 下载最新版本
opencode-windows-x64.zip
将 opencode.exe 添加到系统 Path 中
setx PATH "%PATH%;C:\path\to\opencode"
opencode --version
setx OPENAI_API_KEY "your-api-key"
opencode auth login
3 步开始你的 AI 编程之旅
cd your-project && opencode
进入项目目录并启动 opencode
/init
让 AI 熟悉你的项目结构
用自然语言描述你的需求
掌握所有 / 命令,提升工作效率
初始化项目,扫描文件结构
/commit
提交所有更改到 Git
/undo
撤销上一步操作
/exit
退出 opencode 会话
/models
切换不同的 AI 模型
/themes
更改界面主题
/add <文件>
添加文件到上下文中
/remove <文件>
从上下文中移除文件
/files
查看当前上下文文件
/help
显示帮助信息
/history
查看操作历史
基于原文档深度扩展的实用指南
当你这样请求时,AI 很难理解你的具体需求:
AI 需要猜测你想要什么,这往往导致不准确的结果。
具体描述问题和期望的解决方案:
AI 能准确理解并提供针对性的解决方案。
总是指定具体的文件路径,让 AI 知道操作的目标:
这样 AI 就能直接定位到正确的文件并进行修改。
详细说明你希望实现的功能和行为:
AI 会据此生成完整的功能代码。
一次性要求太多功能会导致质量下降:
AI 难以一次性处理如此复杂的请求。
将复杂功能分解成可管理的步骤:
每个步骤都专注于一个具体的功能点。
按照逻辑顺序逐步构建功能:
确保每个步骤都建立在之前步骤的基础上。
每个步骤完成后都要验证结果:
及时发现并修正问题,避免积累错误。
使用 opencode 前先确保工作区状态:
git status
git diff
查看是否有未提交的更改,避免冲突。
使用 /commit 命令保存有效的修改:
或者使用 git commit 手动提交,并写明修改内容。
为每个功能创建独立的分支:
git checkout -b feature/user-auth
git checkout -b feature/product-api
保持主分支的整洁,便于代码审查和回滚。
定期推送到远程仓库:
git push origin feature-branch
避免本地代码丢失,方便团队协作。
使用 /files 命令了解 AI 当前可见的文件:
确保 AI 看到了所有相关的文件。
手动添加 AI 需要了解的文件:
/add src/config/database.js
/add src/models/User.js
让 AI 理解项目的核心配置和数据结构。
排除不相关的文件减少干扰:
/remove dist/bundle.js
/remove node_modules/
专注于当前任务相关的代码文件。
对于大型项目,只包含当前模块的文件:
提高 AI 响应的准确性和速度。
正确设置 API 密钥到系统环境变量:
setx OPENAI_API_KEY "your-key-here"
export OPENAI_API_KEY="your-key-here"
重启终端后生效,确保密钥安全。
/init 命令的详细作用:
帮助 AI 更好地理解项目背景。
根据需求选择合适的 AI 模型:
不同模型在速度、质量、成本间做权衡。
使用 /themes 命令切换界面配色:
改善长时间使用的视觉体验。
提高终端操作效率:
熟练使用可以大大提升工作效率。
使用 /undo 命令撤销最近的修改:
如果对 AI 生成的代码不满意,立即撤销重试。
使用 /history 查看当前会话的所有操作:
回顾之前的请求和 AI 的响应,总结经验教训。
使用 /help 命令查看所有可用命令:
随时了解新的功能和命令选项。
无缝开发体验
在 VS Code 扩展市场搜索 "opencode" 并安装
Ctrl+Shift+P → "Extensions: Install Extension" → "opencode"