Skip to the main content
Menu

Get started

Your first run, step by step

You say what you want in plain English, and the site is built for you. The engine that does the building is Claude Code. You do not have to learn it first: follow the steps below in order, typing a few lines exactly as shown.

The Duck arms folded, a wry knowing look
Paid plans are not open yet, and payments here are in test mode.You can read every step, but a test payment makes no key, so the steps cannot be completed yet. They are here so you can see what the first run is.

What this takes today

  • Your own computer. Today the engine runs on your computer: a Mac, a Windows PC or a Linux machine. It does not run on a phone or a tablet.
  • Your own Claude account. Claude Code is made by Anthropic, and today it runs on your own account with Anthropic, which bills you for it. On Anthropic's pricing page, read 19 November 2026, the Pro plan is $20.00 a month. Anthropic sets that price; Hostless Duck adds nothing to it.
  • An active Solo or Agency plan and its account page. The link to your account is on your tracker.
  • About half an hour for the setup in steps 1 to 4, most of it waiting for things to install. This is our estimate, not a measurement: nobody outside Hostless Duck has done a first run yet.

Would you rather set up nothing? Two other routes. The done-for-you move: we run the one-time move of your WordPress site for you, for $499, one time, on top of a plan. And Use Our Claude, where we provide the Claude and you need no account of your own: it is planned as the standard way in, but it is not built yet and has no price or date, so today it is not an option.

  1. Step 1: Install the engine

    Open Anthropic's setup page for Claude Code and follow it for your kind of computer. It is one line to paste, or one download, and then a sign-in with your Claude account. We link to Anthropic's page instead of copying its line here, because Anthropic keeps it current.

    Its instructions use a terminal: a window where you type a line and press Enter. Every computer has one already.

    • On a Mac: press Command and Space together, type Terminal, press Enter.
    • On Windows: open the Start menu, type PowerShell, press Enter.

    You are done with this step when typing claude and pressing Enter opens Claude Code and it greets you. Type /exit to close it again for now.

  2. Step 2: Make your key

    Your key is what lets the engine on your computer fetch Core, modules and themes from the Hostless Duck library. On your account page, press the button that makes your key. The key starts with whds_ and is shown once: copy it straight away and keep it somewhere private, such as a password manager. We keep only a scrambled form of it and cannot show it again. If you lose it, make a new one; that switches the old one off.

    One key is for one person. On Agency, make one key for each user rather than sharing a key.

  3. Step 3: Make a folder for your site and connect it

    Each site gets its own folder on your computer. This folder is your project: everything Claude Code builds for the site goes into it. In the terminal, type these two lines, pressing Enter after each. The first makes a folder named my-site; the second steps into it.

    In a terminal
    mkdir my-site
    In a terminal
    cd my-site

    Then paste this one line, with your own key in place of whds_YOUR_KEY, and press Enter:

    In a terminal
    claude mcp add --transport http --scope project webhd https://webhd.aironz.workers.dev/mcp --header "Authorization: Bearer whds_YOUR_KEY"

    That writes a small file named .mcp.json in the folder. It is where the key lives. If you would rather make the file by hand, this is all it holds:

    .mcp.json
    {
      "mcpServers": {
        "webhd": {
          "type": "http",
          "url": "https://webhd.aironz.workers.dev/mcp",
          "headers": {
            "Authorization": "Bearer whds_YOUR_KEY"
          }
        }
      }
    }

    Keep .mcp.json private. It contains your key. Do not email it, paste it into a chat or publish it with the site's code. The Hostless Duck library's address is https://webhd.aironz.workers.dev/mcp; the key is sent to that address and nowhere else.

  4. Step 4: Check the connection

    Still in that folder, start Claude Code by typing claude and pressing Enter. The first time, it asks whether to use the webhd server it found in the folder: say yes. Then type:

    Type in Claude Code
    /mcp

    You should see webhd listed as connected. Then ask, in ordinary words:

    Type in Claude Code
    What is new in the WebHD catalog?

    Claude answers from the library. If it does, the key works and the setup is finished: from here on you only type what you want.

    If it does not connect
    • Send your WebHD seat key as a Bearer token or That seat key is not valid: the key in .mcp.json is missing or mistyped. It must read Bearer, a space, then the whole key.
    • This seat key comes from a purchase made in test mode: the key was made from a test payment, which unlocks nothing. A real subscription gets its own key.
    • This seat has been revoked: a newer key was made for that user. Use the newest one.
    • The last payment for this subscription did not go through or This subscription has been cancelled: fix the payment on your account page. Sites you have already built keep working either way.
    • Anything else: write to support@webhd.com. Never send us the key itself.
  5. Step 5a: Build a new site

    In that folder, with Claude Code open, say what you want. To begin:

    Type in Claude Code
    Install WebHD Core in this folder and start the site on this computer.

    Claude fetches Core from the library, installs it and tells you the address to open in your browser to see the site. From there you ask for themes and modules by name, or simply by what you need, in your own words.

  6. Step 5b: Or move a WordPress site

    In an empty folder connected as in step 3, with Claude Code open, type:

    Type in Claude Code
    Install the WebHD move kit.

    When that is done, type:

    Type in Claude Code
    /webhd-move

    If Claude Code does not know /webhd-move yet, close it and start it again in the same folder.

    Claude then asks four things in one message:

    1. The old site's address (it must begin with https://).
    2. A name for the new site: small letters, digits and hyphens.
    3. Where it should run: your own Cloudflare account (it asks for the account ID), or this computer for a first look.
    4. The email address of the new site's first administrator.

    It also asks you to do two things yourself, and never to paste a password into the conversation:

    • On the old WordPress site, signed in as an administrator: install the WebHD Migration Helper plugin (Claude gives you the download address) and make an Application Password named "Hostless Duck move" under Users → Profile. The helper only reads; you can remove it when the move is done.
    • On your computer: put that user name and application password in a small private file outside the site's folder (Claude tells you the two lines). For Cloudflare, you also sign in to Cloudflare once from the terminal when asked.

    The move then runs without more questions, usually between ten minutes and an hour depending on the site's size, and ends with a working site at a staging address and a written report of what came across and what did not. Your WordPress site is only read; nothing on it is changed or taken down.

    The move kit is served on paid plans only. The move runs in your own Claude Code, on your own Claude usage. If you bought the done-for-you move instead, you do none of step 5b: we write to you to arrange it.

  7. Step 6: Back up your project

    The project folder lives on one computer: yours. Hostless Duck does not hold a copy of it, and neither does anyone else. If that computer is lost or breaks, the folder goes with it, unless you kept a copy.

    So keep one. Close Claude Code, then copy the whole my-site folder to a second place you already trust: an external drive, or a cloud drive such as iCloud Drive, Google Drive, Dropbox or OneDrive. Copy it again whenever you have made changes you would not want to lose.

    • GitHub is optional. If you already use it, a private repository is a good home for the folder. If you have never used it, you do not need to start now: a copied folder does the job.
    • Keep the copy private, wherever it is. The folder holds .mcp.json, and that file holds your key. Never put the folder anywhere public. If a copy ever gets out, make a new key on your account page; that switches the old one off.
    • What the folder is, and is not. It is your site's code and settings: the part Claude Code changes when you ask for something. Your posts, pages and pictures are not in it. Once a site is on Cloudflare they live in the site's own database and storage, on your own Cloudflare account, and Core's export backs those up: one file with every database table and your settings, plus a list of your media files.
    • Your live site does not depend on the folder to stay up. A site running on your Cloudflare account keeps running whatever happens to your computer. The folder is what you need to keep changing it.