##你的第一次会话
安装 OpenCode 后，让我们开始你的第一次编程会话。
###启动 OpenCode
打开终端并导航到你的项目目录：
bash
cd ~/projects/my-app
opencode
你将看到 OpenCode 提示符：
bash
OpenCode v0.1.0
Working directory: ~/projects/my-app
> How can I help you today?
###基本命令
OpenCode 理解自然语言。以下是一些你可以询问的内容：
bash
> 解释这个代码库的功能
> 查找项目中所有的 TODO 注释
> 帮我修复 auth.ts 中的 bug
> 编写一个验证邮箱地址的函数
###快捷键
| 快捷键 | 操作 |
|--------|------|
| Ctrl+C | 取消当前操作 |
| Ctrl+D | 退出 OpenCode |
| Tab | 自动补全 |
| ↑/↓ | 浏览历史记录 |
##理解界面
###提示符
默认提示符显示：
- 当前工作目录
- Git 分支（如果在 git 仓库中）
- 正在使用的模型
bash
~/projects/my-app (main) [claude-3-5-sonnet]
>
###输出模式
OpenCode 显示不同类型的内容：
代码块 - 语法高亮的代码：
bash
function greet(name: string): string {
return `Hello, ${name}!`;
}
文件操作 - 显示正在读取或修改的文件：
bash
Reading: src/utils/helpers.ts
Writing: src/components/Button.tsx
思考过程 - 显示 AI 的推理过程：
bash
Thinking: 分析代码库结构...
在 src/components/ 中找到 3 个 TypeScript 文件
##处理代码
###读取文件
要求 OpenCode 读取并解释代码：
bash
> 读取 src/App.tsx 并解释其结构
OpenCode 将会：
- 读取文件内容
- 分析代码结构
- 提供清晰的解释
###修改文件
用自然语言请求代码更改：
bash
> 为 fetchUser 函数添加错误处理
OpenCode 将会：
- 显示建议的更改
- 在应用之前请求确认
- 将更改应用到你的文件
###创建新文件
要求 OpenCode 创建新文件：
bash
> 创建一个名为 UserProfile 的新 React 组件
##最佳实践
###具体明确
更具体的请求会得到更好的结果：
❌ "修复这个 bug" ✅ "修复 src/api/users.ts 第 42 行的 TypeScript 错误"
❌ "让它更快" ✅ "优化 getUserById 中的数据库查询以使用索引"
###提供上下文
帮助 OpenCode 理解你的需求：
bash
> 我正在使用 Express.js 构建 REST API。
> 创建一个用于 JWT 认证的中间件。
###审查更改
在应用之前始终审查建议的更改：
- OpenCode 显示建议更改的差异
- 输入
y接受或n拒绝 - 你可以在接受之前要求修改
##常见任务
###代码审查
bash
> 审查 src/auth.ts 的安全问题
###重构
bash
> 重构 UserService 类以使用依赖注入
###文档
bash
> 为 utils/ 中所有导出的函数添加 JSDoc 注释
###测试
bash
> 为 validateEmail 函数编写单元测试
##成功技巧
- 从小处开始 - 从简单任务开始，了解 OpenCode 的工作方式
- 使用上下文 - 告诉 OpenCode 你项目的技术栈和约定
- 迭代改进 - 不要期望第一次就得到完美结果；逐步优化你的请求
- 从响应中学习 - 关注 OpenCode 如何解决问题
##下一步
准备好探索更高级的功能了吗？请查看：