Contana

Remote control for terminal AI 远程掌控终端 AI

Run Claude Code or Codex from anywhere without breaking flow. 让 Claude Code 或 Codex 持续运行，你离开电脑后也能随时接管。

Start a coding session on your Mac. Step away. Review output, approve permissions, and switch control from your phone when the agent needs you. 在 Mac 上启动编码会话后，你可以离开工位。Agent 需要你时，用手机查看输出、批准权限， 然后再无缝切回键盘继续工作。

Get started 开始使用 Download macOS app 下载 macOS 应用
  • Open source 开源可审计
  • End-to-end encrypted 端到端加密
  • Mac + CLI + iPhone Mac + CLI + iPhone

Get started 开始使用

Set up your Mac and iPhone in a few minutes. 几分钟完成 Mac 和 iPhone 的设置。

Before you begin: make sure you have Node.js (v18+) and Claude Code or Codex already installed on your Mac. 开始之前：请确认 Mac 上已安装 Node.js (v18+) 和 Claude Code 或 Codex。

Mac

1

Install the CLI 安装命令行工具

npm install -g contana@latest
2

Start the background daemon 启动后台守护进程

contana daemon start

Only needed once. It stays running in the background and bridges your phone. 只需启动一次，它会在后台持续运行并连接手机。

3

Run a session in your project 在项目目录启动会话

cd ~/code/my-project && contana

Use contana codex for Codex instead of Claude Code. 如果使用 Codex 而非 Claude Code，运行 contana codex。

iPhone

1

Install the app 安装手机应用

Get Contana from TestFlight (Apple's beta testing platform). 通过 TestFlight（Apple 官方测试平台）安装 Contana。

Join TestFlight 加入 TestFlight
2

Scan the QR code to pair 扫码完成配对

The first time you run contana, a QR code appears in your terminal. Open the Contana app on your phone and scan it. 首次运行 contana 时，终端会显示一个二维码。 打开手机上的 Contana 应用扫码即可。

You're set 设置完成

Your phone will receive push notifications whenever the agent needs your input. 当 agent 需要你操作时，手机会收到推送通知。

Want a native macOS window instead of the terminal? 想要原生 macOS 窗口而非终端界面？

Download Contana.dmg 下载 Contana.dmg

Daily workflow 日常工作流

One session, two devices, no handoff ceremony. 一个会话，两台设备，不需要繁琐切换。

01

Start locally 在电脑上启动

Run contana in your project directory. The agent starts working in your terminal as usual. 在项目目录运行 contana，agent 照常在终端里开始工作。

02

Step away, stay connected 离开电脑，保持掌控

When the agent needs a permission or hits an error, your phone gets a push notification. Review and approve from anywhere. 当 agent 需要权限确认或遇到错误时，手机会收到推送。 随时随地查看并处理。

03

Return to keyboard 回到键盘

Press any key and continue the exact same session. No re-login, no lost context. 按任意键即可继续同一个会话。无需重新登录，不丢失上下文。

Ready 准备好了

Stop babysitting the terminal. 别再守着终端了。

Download Contana 下载 Contana Install reference 安装参考