> ## Documentation Index
> Fetch the complete documentation index at: https://docs.baeum.ai.kr/llms.txt
> Use this file to discover all available pages before exploring further.

# Homebrew

Homebrew는 macOS에서 패키지를 설치하고 관리하는 표준 도구입니다. 이후 문서의 대부분은 Homebrew를 기준으로 진행합니다.

## 사전 준비

* macOS 13 이상
* 인터넷 연결
* 관리자 권한 계정

## 설치 과정

<Steps>
  <Step title="Command Line Tools 확인">
    터미널에서 아래 명령어를 실행합니다.

    ```bash theme={null}
    xcode-select -p
    ```

    경로가 출력되지 않으면 다음 명령어로 먼저 설치합니다.

    ```bash theme={null}
    xcode-select --install
    ```
  </Step>

  <Step title="Homebrew 설치 스크립트 실행">
    아래 명령어를 그대로 실행합니다.

    ```bash theme={null}
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    ```

    설치 중 비밀번호 입력이 필요할 수 있습니다.
  </Step>

  <Step title="PATH 환경변수 설정">
    설치가 끝나면 안내 문구에 맞춰 `brew shellenv`를 등록합니다.

    <Tabs>
      <Tab title="Apple Silicon">
        ```bash theme={null}
        echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
        eval "$(/opt/homebrew/bin/brew shellenv)"
        ```
      </Tab>

      <Tab title="Intel Mac">
        ```bash theme={null}
        echo 'eval "$(/usr/local/bin/brew shellenv)"' >> ~/.zprofile
        eval "$(/usr/local/bin/brew shellenv)"
        ```
      </Tab>
    </Tabs>
  </Step>
</Steps>

## 설치 확인하기

```bash theme={null}
brew --version
brew doctor
```

* `brew --version`에 버전이 출력되면 설치가 완료된 것입니다.
* `brew doctor`가 `Your system is ready to brew.`를 출력하면 정상입니다.

## 문제 해결

* **`brew: command not found`**: 터미널을 완전히 종료한 뒤 다시 열고 위 PATH 설정 명령어를 다시 실행합니다.
* **Command Line Tools 오류**: `xcode-select --install` 후 터미널을 재시작합니다.

## 설치 점검 목록

* 관리자 권한/필수 도구 등 사전 요구사항을 먼저 확인했습니다.
* 설치 후 버전 확인 명령어(`--version`)를 실행해 정상 설치를 검증했습니다.
* PATH/환경변수 변경이 필요한 경우 터미널을 다시 열어 적용 여부를 확인했습니다.
* 문제가 생겼을 때를 대비해 설치 로그 또는 스크린샷을 남겼습니다.

## 관련 문서

<CardGroup cols={2}>
  <Card title="Setup 홈" icon="house" href="/setup/index">
    운영체제별 설치 흐름을 다시 확인합니다.
  </Card>

  <Card title="다음: Git" icon="arrow-right" href="/setup/macos/git">
    다음 설치 단계를 이어서 진행합니다.
  </Card>
</CardGroup>