# How to run Claude Code in a desktop app on Mac and Windows

> HB Code is a free desktop app for Mac and Windows that runs Claude Code with your Claude sign-in. It's separate from Anthropic's own Claude Desktop app.

HB Code is a free desktop app for Mac and Windows that runs Claude Code with your own Claude sign-in. Download it, add a project folder, start a Claude session. It isn't Anthropic's Claude Desktop. HB Code comes from another company, helpful bits GmbH.

HB Code is a desktop app for Mac and Windows. It runs Claude Code and Codex on your own computer with your own Claude and ChatGPT plans.

Updated November 20, 2026

## Steps

1. Install HB Code. The Mac download is on this site and needs Apple silicon and macOS 12 or later. The Windows app is in the Microsoft Store and needs an x64 PC with Windows 10 version 1809 or later.
2. Start the app. Press Add project in the sidebar. Choose a project folder.
3. Press New session on the project. Choose Claude. Press Start Claude session. If the Claude account on this computer is signed out, a sign-in dialog opens. Finish the Claude sign-in in your browser.
4. Send the task. Each command, file, and edit of the agent is a row in the thread. Click a row to open the output, the file, or the diff.
5. To continue a conversation that you started in the terminal, select it in the same dialog. Then press Continue conversation.
6. Open Settings › Agents to see your limits. Press Add account to sign in to one more Claude account.

## Notes

- The desktop app is free and needs no HB Code account. Claude Code uses your own Claude plan. HB Code doesn't include one.
- Claude Code comes inside the app. You don't install the CLI or Node. A newer Claude Code comes with an HB Code update.
- HB Code also runs Codex. Each session runs one agent, and you choose it when you create the session.
- Anthropic didn't make HB Code.
- There is no build for Intel Macs or for Windows on ARM. The download page has an experimental Linux preview.
- The iPhone and Android apps open the same sessions. Phone access needs HB Code Pro after a 10-day connected preview.

## Questions

### Is there an official Claude Code desktop app?

Yes. Anthropic's Claude Desktop has a Code tab that runs Claude Code. HB Code is a different app, made by helpful bits GmbH.

### Is HB Code free?

The desktop app is free. You pay Anthropic for your Claude plan. Only phone access costs money, after a 10-day preview.

### Do I have to install Claude Code first?

No. Claude Code comes inside the app.

### Can I open the conversations from my terminal?

Yes. HB Code lists the Claude Code conversations that are saved for the project folder, and you continue one in the app.

## Details in the handbook

- [Sign-ins and optional keys](https://www.hbcode.ai/docs/setup.md#accounts): Setup: sign-ins, regions, and remote access
- [Agent sign-in at the first session](https://www.hbcode.ai/docs/setup.md#first-use): Setup: sign-ins, regions, and remote access
- [Find and continue a saved conversation](https://www.hbcode.ai/docs/claude-agent-sdk.md#continue-conversation): The Claude Agent SDK integration
- [Accounts and usage](https://www.hbcode.ai/docs/claude-agent-sdk.md#accounts): The Claude Agent SDK integration

## Guides

- [How to check usage limits and use more than one account](https://www.hbcode.ai/claude-code-usage-limits.md)
- [How to check what Claude Code or Codex did](https://www.hbcode.ai/claude-code-ui.md)
- [How to run several Claude Code and Codex sessions](https://www.hbcode.ai/claude-code-sessions.md)
- [How to use Claude Code or Codex on your phone](https://www.hbcode.ai/claude-code-mobile.md)
- [How to see what the subagents of Claude Code do](https://www.hbcode.ai/claude-code-subagents.md)
- [How to try Claude Code and Codex on the same task](https://www.hbcode.ai/claude-code-vs-codex.md)
- [How to run Codex in a desktop app on Mac and Windows](https://www.hbcode.ai/codex-desktop-app.md)
- [How to switch Claude Code and Codex accounts without logging out](https://www.hbcode.ai/switch-claude-code-codex-accounts.md)
- [How to let Claude Code write and Codex review the change](https://www.hbcode.ai/claude-code-codex-review.md)
- [How to use Claude Code and Codex on Windows](https://www.hbcode.ai/claude-code-windows.md)
- [How to use Claude Code and Codex from an Android phone](https://www.hbcode.ai/claude-code-android.md)
- [How to get a phone alert when Claude Code or Codex needs you](https://www.hbcode.ai/claude-code-notifications.md)
- [How to continue a Claude Code terminal session on your phone](https://www.hbcode.ai/claude-code-resume-session.md)
- [How to keep your computer awake while Claude Code or Codex works](https://www.hbcode.ai/claude-code-keep-computer-awake.md)
- [How to monitor your Claude Code and Codex usage over time](https://www.hbcode.ai/claude-code-usage-monitor.md)
- [Download HB Code](https://www.hbcode.ai/downloads)
