Set Up Moss Agent

To use Moss Agent, install Claude Code first.

If you want more detail, read Anthropic's Claude Code setup guide.

Open the Terminal app on your Mac. Then copy and paste this command, and press Enter:

curl -fsSL https://claude.ai/install.sh | bash

To check that Claude Code installed correctly, copy and paste this command into the Terminal app, then press Enter:

claude --version

You should see a version number. If you see “command not found”, close Terminal, open it again, and follow the official Claude Code setup guide again. Claude Code needs a paid Claude-enabled account such as Pro, Max, Team, Enterprise, or Console access. The free Claude.ai plan does not include Claude Code.

After successful install, you need to log in to Claude Code. In the Terminal app, copy and paste this command, then press Enter:

claude

Claude Code should open your browser and ask you to sign in. Moss does not have a separate sign-in screen for AI. Once Claude Code is signed in, Moss uses that same login.

To check later whether you are signed in, copy and paste this into the Terminal app, then press Enter:

claude auth status

The exact text can vary, but it should show that you are logged in. If it says loggedIn: false, Claude Code is not signed in yet. In that case, copy and paste claude into the Terminal app, press Enter, and finish the browser sign-in.

Open Moss and open any note. Then press Cmd+K to open the Actions input.

Type what you want Moss to do, then press Enter.

If your request starts running in Actions, your setup is complete.

This setup is for the built-in Moss Agent. External coding agents can also work with Moss notes as local files through Share with Agent and Moss Skills.

For product workflows, open the in-app Use Cases note. For a visual overview of what Moss can do, see the Features page.