Skip to content
Codux

Getting Started

Codux AI is a cross-platform workstation for AI coding CLIs — Codex, Claude Code, Gemini CLI, OpenCode, Kiro CLI, CodeWhale, Agy, and more driver-based integrations in progress. This page gets you from zero to your first project terminal quickly.

System Requirements

Section titled “System Requirements”
  • A supported desktop release for your platform
  • An AI CLI tool already installed locally (Codux launches them, it does not bundle them)

Install with Homebrew on macOS

Section titled “Install with Homebrew on macOS”
Terminal window
brew install --cask duxweb/tap/codux

To upgrade later:

Terminal window
brew update
brew upgrade --cask codux

Install from a GitHub Release

Section titled “Install from a GitHub Release”
  1. Download the latest desktop package from GitHub Releases or codux.dux.cn.
  2. Install Codux with the normal flow for your platform.
  3. Open Codux, click New Project, pick a directory, create or open a worktree task, and start a terminal split.

”Cannot be opened because the developer cannot be verified”

Section titled “”Cannot be opened because the developer cannot be verified””

On macOS, Codux may be blocked on first launch if the downloaded package is not notarized. Run:

Terminal window
sudo xattr -rd com.apple.quarantine /Applications/Codux.app

Or open System Settings → Privacy & Security, scroll down, and click Open Anyway next to the Codux warning.

Next Steps

Section titled “Next Steps”