Set up · macOS

Set up Claude Code or Codex

Spikefrost works with either coding-agent CLI. Install and authenticate one of them on your Mac, then the desktop app can use it to change your apps by chat.

  1. 1

    Open Terminal

    Press ⌘ Space, type Terminal, and press Return. A window with a text prompt opens — that’s where the next commands go.
  2. 2

    Choose and install one coding agent

    You need Claude Code or Codex, not both. Pick the account and product you prefer.

    Option A — Claude Code

    Install Anthropic's Claude Code CLI:

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

    Option B — Codex

    Install OpenAI's Codex CLI:

    curl -fsSL https://chatgpt.com/codex/install.sh | sh
  3. 3

    Open a new Terminal window

    Close the Terminal window and open a fresh one (⌘ N). This lets your Mac find the newly installed claude or codex command.
  4. 4

    Start your coding agent and sign in

    If you installed Claude Code, run:

    claude

    Follow the browser prompts to sign in with an eligible Claude or Anthropic Console account.

    If you installed Codex, run:

    codex

    The first time it opens, choose Sign in with ChatGPT or another available sign-in method.

  5. 5

    You’re done

    Once your chosen CLI opens successfully, you can close Terminal and return to Spikefrost. Open any app and start a chat; Spikefrost will use the coding agent installed on your Mac.
    To double-check, run claude --version or codex --version.

If something doesn’t work

  • “command not found” — close Terminal completely, open a new window, and run claude or codex again.
  • The browser didn’t open — return to Terminal and restart your chosen CLI.
  • macOS asks if you’re sure — click Open. This is normal for new apps.

Official guides: Claude Code · Codex CLI.

← Back to download