Contana

Canonical install guide 标准安装指南

Install Contana without hunting for the right link. 安装 Contana，不再到处找正确入口。

This page is the stable install endpoint for Contana. It includes the CLI command, daemon setup, project directory usage, and the latest macOS desktop download. 这是 Contana 的稳定安装入口。这里会告诉你 CLI 安装方式、守护进程启动方式、 如何在指定项目目录中运行，以及最新的 macOS 桌面安装包下载地址。

Desktop build 0.1.1 桌面版本 0.1.1 CLI package: contana CLI 包名：contana Private API default: hpapi.gjs.ink 默认私有 API：hpapi.gjs.ink

CLI

Install the command first. 先安装命令行工具。

npm install -g contana@latest

Then use contana instead of claude, or contana codex instead of codex. 安装完成后，把 claude 换成 contana， 或把 codex 换成 contana codex。

Daemon 守护进程

Start it once, check status, or enable macOS login auto-start. 先启动一次，再按需查看状态或开启 macOS 登录自动启动。

Contana provides a dedicated daemon command group. On macOS, you can also enable login auto-start for the daemon. Contana 提供了专门的守护进程命令。macOS 上还可以把它设置为登录后自动启动。

contana daemon start
contana daemon status
contana daemon install

`contana daemon install` enables macOS login auto-start for the daemon. `contana daemon install` 用于在 macOS 登录后自动启动守护进程。

Project directory 项目工作目录

Choose the project directory when you start a session, not when you start the daemon. 项目目录是在启动会话时决定的，不是在启动守护进程时决定的。

The daemon is machine-level. When you want Contana to work inside a specific project, first enter that project directory, then start the session there. 守护进程是机器级服务。如果你想让 Contana 在某个具体项目里工作， 先进入那个项目目录，再在该目录里启动会话。

cd ~/code/my-project && contana
cd ~/code/my-project && contana codex

Replace `~/code/my-project` with your real project path. 把 `~/code/my-project` 替换成你自己的真实项目路径。

macOS

Download the latest desktop build. 下载最新桌面安装包。

The generic download link always points to the latest packaged desktop release on your own domain. 这个通用下载链接会一直指向你自己域名下最新的桌面安装包。

Download Contana.dmg 下载 Contana.dmg

Stable URL: https://contana.gjs.ink/releases/latest/Contana.dmg

iPhone

Current mobile distribution route. 当前手机端分发方式。

iPhone builds are currently intended for TestFlight or private distribution rather than a public self-serve download link on this page. iPhone 构建当前更适合通过 TestFlight 或私有分发渠道提供，而不是在这里直接公开下载。

Recommended route: TestFlight / private distribution 推荐方式：TestFlight / 私有分发

Private server 私有服务

Default private backend. 默认私有后端。

This fork defaults to your private API endpoint instead of the public Happy infrastructure. 这个分支默认连接你自己的私有 API，而不是公共 Happy 基础设施。

https://hpapi.gjs.ink