> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metask.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# 快速上手
> 先安装 MetaCode，再从三种方式里任选一种完成注册 / 授权，几分钟即可开始使用。
只需两步即可开始：**安装 → 选一种方式完成注册 / 授权**。授权成功后无需额外配置，直接使用。
最新版支持 **3 种授权方式**：网页授权（推荐）、API Key 授权、设备码授权。你只需任选一种完成即可，**不用全部都做**。
## 第一步：安装 MetaCode
安装方式不变，依旧是复制一行命令执行。安装完成后，会继续引导你进入注册 / 授权流程。
右键点击「开始」菜单，选择「Windows PowerShell（管理员）」。
```powershell theme={null}
irm https://napi.origintask.cn/install/metacode | iex
```
复制后直接运行即可，安装完成后会继续引导你进入注册 / 授权流程。
```powershell theme={null}
metacode --version
```
看到版本号即表示安装成功。
macOS：按 `Cmd + 空格`，搜索「终端 / Terminal」并打开。
```bash theme={null}
curl -fsSL https://napi.origintask.cn/install/metacode | sh
```
复制后直接运行即可，安装完成后会继续引导你进入注册 / 授权流程。
```bash theme={null}
metacode --version
```
看到版本号即表示安装成功。
安装完成！下一步只需要在下面三种方式里**任选一种**完成注册 / 授权。
## 第二步：注册 / 授权（三选一）
### 先看三种方式怎么选
新手首选，跟着网页提示点几步即可完成。
适合已有账号，或希望手动创建和管理 Key 的用户。
适合浏览器未自动拉起、远程机器，或更习惯按设备码完成登录的场景。
安装后，按终端或页面提示，会看到三种登录 / 授权入口，选最适合你的方式继续即可：
### 方式一：网页授权（推荐）
安装完成后，优先选择 MetaCode 推荐的网页授权方式，最省心，适合绝大多数新用户。
浏览器会自动打开授权页面。还没有账号可以直接在这里注册；已有账号则直接登录并授权。
网页确认后，终端会显示授权完成提示，说明账号已经和当前设备绑定成功。
### 方式二：API Key 授权
你希望手动创建和管理 Key，或者团队内部已经在用 API Key 方式统一发放凭证。
复制下面网址到浏览器打开：[https://napi.origintask.cn/keys/generatormckey](https://napi.origintask.cn/keys/generatormckey)
没有账号点「注册」，已有账号点「登录」。
登录后点「创建 / Generate」，填写 Key 名称（如「我的电脑」），选择类型和过期时间，然后创建。
创建成功后，页面会显示一串以 `sk-` 开头的密钥，复制保存好。
打开终端，运行：
```bash theme={null}
metacode config
```
终端提示输入时，粘贴刚才复制的 Key，按回车。
```bash theme={null}
metacode exec --ephemeral --skip-git-repo-check "你好，请回复测试成功"
```
如果 MetaCode 回复了「测试成功」，说明 API Key 授权正确。
### 方式三：设备码授权
浏览器没有自动打开、你正在远程服务器上操作，或者想手动在另一台设备上完成登录。
在安装后的三种授权方式中，选择「设备码授权」继续。
终端会给出设备码和访问地址。在浏览器中打开对应页面，输入设备码并确认授权。
网页确认后，终端会同步显示授权成功，你就可以开始正常使用 MetaCode。
注册 / 授权完成！无论你选哪一种方式，只要完成一次，后续直接运行 `metacode` 即可使用。
## 版本升级
MetaCode 启动时会自动检查更新，有新版本时会提示你升级。
重新运行安装命令即可升级到最新版：
```powershell Windows theme={null}
irm https://napi.origintask.cn/install/metacode | iex
```
```bash macOS / Linux theme={null}
curl -fsSL https://napi.origintask.cn/install/metacode | sh
```
升级完成后，重新启动：
```bash theme={null}
metacode
```
装好之后，前往 [第一次使用](/first-use) 跑通你的第一个任务。