---
title: "安装"
description: "安装 Carina CLI 与 daemon — shell、Homebrew、npm 或源码。"
source: https://carina.nebutra.com/zh-cn/getting-started/installation/
---

# 安装

> 安装 Carina CLI 与 daemon — shell、Homebrew、npm 或源码。

> 读完本页应能运行 `carina doctor` 并开始会话。

## 你将得到

- `PATH` 上的 `carina` CLI  
- 可启动本地 daemon（`carina daemon start`，或 `carina` 自动拉起）  
- 可选 workers 与客户端表面（TUI 内置于 CLI）  

## 前置

- **macOS 13+** 或现代 **Linux**（x86_64 / arm64）  
- 仅在拉包或调云端模型时需要网络（运行时本身本地优先）  

## 安装

需要完整工具链时优先 **shell 安装器**。

    ```bash title="install.sh" frame="none"
    curl -fsSL https://carina.nebutra.com/install.sh | sh
    ```

    ```bash title="brew" frame="none"
    brew install Nebutra/tap/carina
    ```

    ```bash title="npm" frame="none"
    npm install -g @nebutra/carina
    ```

    ```bash title="install-from-source.sh"
    git clone https://github.com/nebutra/carina.git
    cd carina
    make install
    ```

## 验证

    ```bash frame="none"
    carina version
    ```

    ```bash frame="none"
    carina init
    ```

    ```bash frame="none"
    carina doctor
    ```
    显式修复：`carina doctor --fix --yes`。

## Daemon

| 命令 | 含义 |
| --- | --- |
| `carina daemon start` | 启动本 CLI 拥有的本地 daemon |
| `carina daemon status` | 状态（不自动启动） |
| `carina daemon stop` | 仅停止本 CLI 拥有的 daemon |
| `carina status` | 健康与计数 |

交互式 `carina`（TUI）会在需要时**自动启动** daemon。默认套接字：`~/.carina/daemon.sock`。

## 更新

```bash frame="none"
carina update --check
carina update
```

## 权威来源

- 打包与安装：`docs/release.md`  
- 安全默认：[策略](/zh-cn/concepts/policy/)  

## 下一步

→ [快速上手](/zh-cn/getting-started/quickstart/)

---
Source: https://carina.nebutra.com/zh-cn/getting-started/installation/
Markdown: https://carina.nebutra.com/zh-cn/getting-started/installation/index.md