1.3 快速开始

本节将带你快速上手OpenCode，从启动到完成第一个任务。

第一步：启动OpenCode

安装完成后，在终端中进入你的项目目录，然后运行：

cd your-project
opencode

这将启动OpenCode的TUI（终端用户界面）。

第二步：配置提供商

首次启动时，需要配置AI提供商。使用 /connect 命令：

/connect

选择你的AI提供商并输入API密钥。推荐新手使用 OpenCode Zen，可以通过 opencode.ai/auth 获取认证。

第三步：初始化项目

运行 /init 命令让OpenCode分析你的项目结构：

/init

这将创建一个 AGENTS.md 文件，包含项目的基本信息和规则。

第四步：开始对话

现在你可以开始与AI对话了。例如：

帮我创建一个简单的Hello World程序

或者询问关于项目的问题：

这个项目的主要功能是什么？

基本操作

文件引用

使用 @ 符号引用项目中的文件：

@src/main.js 帮我解释这个文件的功能

输入 @ 后会出现模糊搜索，帮助你快速找到文件。

执行Shell命令

使用 ! 前缀执行shell命令：

!ls -la

命令的输出会作为上下文提供给AI。

切换模式

按 Tab 键在规划模式和构建模式之间切换：

• 规划模式（Plan）：AI只分析和建议，不修改文件
• 构建模式（Build）：AI可以实际修改文件

常用斜杠命令

命令	功能	快捷键
/connect	添加提供商认证	—
/init	初始化项目	—
/new	开始新会话	ctrl+x n
/undo	撤销更改	ctrl+x u
/redo	重做更改	ctrl+x r
/share	分享会话	ctrl+x s
/models	切换模型	ctrl+x m
/help	获取帮助	—

退出OpenCode

使用以下任一方式退出：

• ctrl+c
• ctrl+d
• ctrl+x q（leader键 + q）

示例：创建一个简单项目

让我们通过一个实际例子来体验OpenCode：

# 1. 创建新目录并进入
mkdir my-project && cd my-project

# 2. 启动OpenCode
opencode

# 3. 配置提供商（首次使用）
/connect

# 4. 初始化项目
/init

# 5. 让AI帮你创建项目
请帮我创建一个Node.js的Express API项目，包含以下功能：
- GET /health 健康检查接口
- GET /users 获取用户列表
- POST /users 创建新用户

下一步

了解基本操作后，建议继续学习终端要求和配置优化。