# Mac: Detailed Install Guide

What follows is a detailed guide to installing Nimbalyst and setting up Claude Code on Mac

### Initial Install

**Download the Nimbalyst-MacOS.dmg and click to install it**

<figure><img src="/files/ofdyMBLe96f85d7EtLdC" alt=""><figcaption></figcaption></figure>

**Drag Nimbalyst into your Applications**

<figure><img src="/files/LxQbaMCuklIziBNp2TW3" alt=""><figcaption></figcaption></figure>

**Open Nimbalyst from your Applications**

<figure><img src="/files/v2VUEhnwA25yaOSTqhH3" alt=""><figcaption></figcaption></figure>

**Open Nimbalyst**

<figure><img src="/files/dwFIS4z1dQJrp4XXCWOv" alt=""><figcaption></figcaption></figure>

### Initial Nimbalyst Config

Choose what Project you will work on. A Project is a folder on your local file system. It could be a Git folder or just another folder. You have different projects for different folders. Open one or create a new one.

<figure><img src="/files/YLT1xprvkpnRK4q9IHGD" alt=""><figcaption></figcaption></figure>

**In this example, I create My Project, to work on with Nimbalyst**

<figure><img src="/files/0FO1McHw32rGmIxPLQUJ" alt=""><figcaption></figcaption></figure>

**Read and click through Nimbalyst's onboarding screens, Click Get Started**

<figure><img src="/files/TRXxjkyLj6cd3pocOUJx" alt=""><figcaption></figcaption></figure>

**Let Nimbalyst know your role and email.** We will only send you product updates occasionally.

<figure><img src="/files/2D4aRrgmkU8OiN6UpOsT" alt=""><figcaption></figcaption></figure>

**Type something into the Agent panel to test your coding agent**

* If you already have the coding agent installed, it should just work
* If not, Nimbalyst will give you a link to install the coding agent

<figure><img src="/files/WHZ8H2clel0Fr0KXSrfb" alt=""><figcaption></figcaption></figure>

### Installing Claude Code

**Click LogIn to be guided through Claude Code setup**

<figure><img src="/files/iDadGqmJ7n8vGDLGGV4H" alt=""><figcaption></figcaption></figure>

**Nimbalyst pops up the terminal. Click Allow to allow it to install Claude Code for you.**

<figure><img src="/files/0MhHkJqxl4gGGF1qVMBI" alt=""><figcaption></figcaption></figure>

**Nimbalyst opens your browser and asks you to authenticate to your Claude Pro or Max accounts**

* Google Auth or
* Email Auth

<figure><img src="/files/8p7t35BV2cNJ874KE8cN" alt=""><figcaption></figcaption></figure>

**Authorize Claude Code to connect to your Claude account**

<figure><img src="/files/1JdUVVaaLUpoWSCpmFZp" alt=""><figcaption></figcaption></figure>

**Success installing Claude Code and connecting it to Claude**

<figure><img src="/files/Nw3K9O9bxdZpgewrqeBs" alt=""><figcaption></figcaption></figure>

### Claude Code in Nimbalyst

**These two terminal windows can be closed. Hit the red dot to close them.**

<figure><img src="/files/rfcSWobftU38a1SibRY0" alt=""><figcaption></figcaption></figure>

**Hit the Check Status box in Nimbalyst to Check Status of your Claude Code Setup**

<figure><img src="/files/O4Vxl0Ne7mTeX6URxr4Q" alt=""><figcaption></figcaption></figure>

**Success. Claude Code now works in Nimbalyst.**

<figure><img src="/files/zlWjxR9dqu1l1zjIjAz0" alt=""><figcaption></figcaption></figure>

**Use Nimbalyst**

* Type into the Agent panel and have your coding agent research, write, edit, mockup, diagram and more
* Work in documents and code in the center panel
* To set up Codex as an additional coding agent, see [AI Provider Setup](/setup-nimbalyst/ai-provider-setup-and-notifications.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nimbalyst.com/detailed-install-guides/mac-detailed-install-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.