Install the Agent

The agent (code-agent) runs on the computer where your code and Claude Code live. It keeps one outbound connection to the server — your machine opens no ports.

Prerequisite

Claude Code must already be installed and signed in on this machine. The agent drives your local claude — it brings no credentials of its own.

macOS

curl -fsSL https://16co.de/install_agent.sh | sh

The script downloads the .dmg for your chip (Apple Silicon or Intel), copies Code Agent.app into /Applications, and launches it. You'll see a new icon in the menu bar — that's the agent.

Installing the .dmg by hand? Read this

The app is not notarized by Apple, so a plain double-click on first launch shows "Code Agent can't be opened because it is from an unidentified developer." Two ways around it:

• Right-click (or Control-click) the app → Open → Open in the dialog. Needed only once.
• Or: System Settings → Privacy & Security → scroll down → Open Anyway.

The install script avoids this entirely by clearing the quarantine flag for you.

Linux

curl -fsSL https://16co.de/install_agent.sh | sh

• Run as root → installs the deb/rpm package system-wide (/usr/bin/code-agent).
• Run as a normal user → unpacks under ~/.local/bin with a per-user systemd service. No root needed.

Either way, the agent is headless on Linux — there's no tray icon. The next step, code-setup, signs you in and enables the right service (system-wide when root, systemctl --user + lingering otherwise) so the agent starts at boot.

Windows

In PowerShell:

irm https://16co.de/install_agent.ps1 | iex

The script downloads the agent into %LOCALAPPDATA%\16code, unzips it, and launches it.

Verify

• macOS: the menu bar icon is there; it shows "not signed in" until you finish the next step.
• Linux: ~/.local/bin/code-agent (or /usr/bin/code-agent) exists; the service starts after code-setup.
• Windows: code-agent shows up in Task Manager.

Now connect it to your server: Sign In & Bind Your Machine.