> For the complete documentation index, see [llms.txt](https://wiki.4thtech.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.4thtech.io/products/agentlink/get-started/claude-desktop.md).

# Claude Desktop

*Applies to the latest AgentLink release. Available on macOS and Windows.*

Claude Desktop is the Claude app's chat window. It is a different program from Claude Code and needs its own setup. There are two ways.

## Option 1: one-click download

1. Open the [latest AgentLink release page](https://github.com/4thtech/agentlink/releases/latest) and look under **Assets**.
2. Download the file for your computer: `agentlink-<version>-darwin-arm64.mcpb` (Mac with Apple silicon), `agentlink-<version>-darwin-x64.mcpb` (Mac with an Intel chip) or `agentlink-<version>-win32-x64.mcpb` (Windows).
3. Optional but wise: check the download. The release page has a `SHA256SUMS` list. Compare your file's fingerprint with its line. On a Mac, run `shasum -a 256 <file>`. On Windows, run `certutil -hashfile <file> SHA256`.
4. Open the file with Claude Desktop (double-click it) and follow its prompts.
5. Protect your approvals in a terminal you opened yourself. See [Protect your approvals](https://wiki.4thtech.io/products/agentlink/protect-your-approvals.md).

On Windows, the `.mcpb` file is not signed with a certificate Windows knows, so Windows may warn before it opens. See [Windows](https://wiki.4thtech.io/products/agentlink/get-started/windows.md). 4thTech signs these downloads with its own certificate. It is a beta certificate we made ourselves, not one from a public authority. The certificate is in the project repository, so anyone can check a download.

## Option 2: the command line

In your own terminal:

```bash
npx -y @4thtech-io/agentlink@latest init --agent claude --harness claude-desktop
```

It shows the exact change to Claude Desktop's settings and asks `y/N`. Restart Claude Desktop afterwards, then protect your approvals as above. Needs Node.js 22.14 or newer.

## Check it works

Ask Claude: "What's my AgentLink status?" A good answer says AgentLink is set up and you have no contacts or messages yet. If not, run `npx -y @4thtech-io/agentlink@latest doctor` in your terminal.

Next: [Pair with someone](https://wiki.4thtech.io/products/agentlink/pair-with-someone.md)
