Skip to content

Guides

Use your Mac as the server

Claude Code on the Mac you're sitting at, with Mucq connecting to it over SSH like any other server, from your Mac, iPhone or iPad.

On this page

Mucq from the App Store connects to servers over SSH, and a Mac is a fine server. Turn on Remote Login, and Mucq treats the Mac you're on exactly like a machine across the internet: its own tmux sessions, Claude in each project folder, and the same sessions on your iPhone and iPad.

An honest note

This treats your Mac like any remote server, reached over SSH. Sessions on This Mac, with its own files at hand, are a Mucq Pro feature. Mucq Pro comes later as a separate Mac app with its own price; for iPhone and iPad you'd still need Mucq from the App Store, bought separately.

1. Turn on Remote Login

In System Settings › General › Sharing, turn on Remote Login. Set Allow access for to your own account only.

2. tmux and Claude Code

Install tmux with Homebrew, and Claude Code the way Anthropic's setup guide describes:

Shell
brew install tmux

macOS gives commands that arrive over SSH a short PATH (/usr/bin:/bin:/usr/sbin:/sbin), which doesn't include Homebrew. Add Homebrew to ~/.zshenv, which every zsh reads, so Mucq finds tmux:

Shell
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshenv

On an Intel Mac, Homebrew lives in /usr/local/bin/brew instead. Claude itself is found once tmux runs, because tmux starts a login shell.

3. Add the Mac to Mucq

Add a server with Host localhost, your Mac username as User, and Sign in with SSH Key. Choose Copy Install Command, paste it into Terminal and press Return: it adds Mucq's key to your ~/.ssh/authorized_keys.

Open a project of localhost and confirm its host key once. Your Mac's fingerprint is one command away:

Shell
ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub

4. Keys only

Remote Login opens SSH on this Mac to the network, so allow keys only. A file of your own in /etc/ssh/sshd_config.d/ stays in place when a macOS update replaces /etc/ssh/sshd_config:

Shell
printf 'PasswordAuthentication no\nKbdInteractiveAuthentication no\n' | sudo tee /etc/ssh/sshd_config.d/010-key-logins.conf
sudo sshd -t

sudo sshd -t prints nothing when the configuration is valid. Check it: this login should now end with "Permission denied (publickey)", while Mucq still connects with its key.

Shell
ssh -o PubkeyAuthentication=no localhost

To undo it, delete the file again: sudo rm /etc/ssh/sshd_config.d/010-key-logins.conf.

5. iPhone and iPad

Your iPhone and iPad reach the same Mac over your network. Add it as a server there too, with the Mac's local hostname as Host. System Settings › General › Sharing shows it at the bottom, something like your-mac.local.

  • The first time, iOS asks whether Mucq may find devices on your local network. Allow it; without it, Mucq says No local network access and offers to open Settings.
  • Each device has its own key. Choose Copy Install Command on the iPhone and paste it into Terminal on the Mac (Universal Clipboard carries it across), or send the key over with Share Public Key… and add it yourself.

Outside your home network, the local name doesn't reach the Mac. Tailscale does.

A Mac that's asleep answers nobody. If you work from the couch while the Mac sits in the study, keep it from sleeping.