
설치 순서 한눈에 Homebrew 맥용 패키지 관리자. 이 글의 모든 설치를 맡는다 Node.js MCP 서버처럼 npx로 실행하는 도구에 필요 Orca 코딩 에이전트 여러 개를 나란히 돌리는 데스크톱 앱 에이전트 3종 Codex CLI, Claude Code, agy(Antigravity CLI) |
00 시작 전에 확인할 것
기준 환경은 Apple Silicon(M 시리즈) 맥과 macOS 기본 셸인 zsh다. Homebrew는 공식적으로 macOS 15(Sequoia) 이상을 지원한다.
터미널은 Spotlight(⌘ + Space)에서 "터미널"을 검색해 연다. 아래 명령은 한 줄씩 복사해 붙여 넣고 Enter를 누르면 된다.
에이전트마다 로그인할 계정이 필요하다. 미리 준비해 두면 설치 후 바로 쓸 수 있다.
에이전트 | 만든 곳 | 로그인 계정 |
|---|---|---|
Codex CLI | OpenAI | ChatGPT 계정(Plus·Pro·Business·Edu·Enterprise 요금제에 포함) 또는 API 키 |
Claude Code | Anthropic | Claude Pro·Max·Team·Enterprise 또는 Console 계정(무료 요금제는 사용 불가) |
agy | Google 계정 또는 Gemini API 키 |
01 Homebrew 설치
Homebrew는 맥에서 개발 도구를 설치하고 업데이트하는 패키지 관리자다. 이 글에서는 Node.js, Orca, 에이전트 3종까지 모두 Homebrew로 설치한다.

brew.sh 첫 화면에 있는 설치 명령을 터미널에 붙여 넣는다.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"스크립트는 무엇을 설치할지 먼저 보여 주고 멈춘다. Return(Enter)을 누르면 진행되고 중간에 맥 로그인 비밀번호를 묻는다. 비밀번호는 입력해도 화면에 나타나지 않는다.
Xcode Command Line Tools가 없으면 이 과정에서 함께 설치한다. 그래서 처음 설치할 때는 몇 분 더 걸릴 수 있다.
설치가 끝나면 마지막에 Next steps 안내가 나온다. 여기 나온 명령을 실행해야 터미널이 brew를 찾는다. Apple Silicon 맥의 zsh라면 아래 세 줄이 나온다.
echo >> ~/.zprofile
echo 'eval "$(/opt/homebrew/bin/brew shellenv zsh)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv zsh)"화면에 나온 명령이 이와 다르면 그것을 따른다. brew --version을 입력해 버전 번호가 나오면 끝이다.
02 Node.js 설치
Node.js는 자바스크립트 실행 환경이다. 함께 설치되는 npm과 npx는 에이전트에 MCP 서버를 붙이거나 자바스크립트 기반 도구를 실행할 때 쓴다.

brew install node설치가 끝나면 node -v와 npm -v로 버전을 확인한다. 원문 작성 때 확인한 2026년 10월 5일 Homebrew의 node 패키지는 Node.js 26 버전대였다. 설치되는 버전은 패키지 갱신에 따라 달라질 수 있다.
03 Orca 설치
Orca는 Claude Code, Codex 같은 코딩 에이전트를 여러 개 띄워 나란히 돌리는 데스크톱 앱이다. stablyai 팀이 만든 무료 오픈소스이고 작업마다 별도 git worktree를 만들어 에이전트끼리 서로의 작업을 건드리지 않게 한다.
Orca 자체가 AI 모델은 아니다. 이미 쓰고 있는 Claude, ChatGPT 구독을 그대로 연결해 쓰는 방식이다.

설치는 Homebrew로 한 줄이면 된다.
brew install --cask stablyai/orca/orca공식 사이트(onorca.dev)의 Download 페이지에서 Apple Silicon용 DMG를 받아 설치해도 된다.

처음 실행하면 Orca가 홈 폴더 접근 권한을 요청한다. ~/.claude, ~/.codex 설정이 있으면 가져올지도 묻는다. 그다음 빈 화면에서 Add Repo로 작업할 저장소를 추가하면 된다.
04 Codex CLI 설치
Codex CLI는 OpenAI의 터미널 코딩 에이전트다. 공식 문서에 나온 Homebrew 방법으로 설치한다.

brew install --cask codex업데이트는 brew upgrade --cask codex로 한다. 공식 문서에는 전용 설치 스크립트와 npm 방법도 있지만 한 가지 방법만 쓰면 관리가 편하다.
설치 후 프로젝트 폴더에서 codex를 실행하고 Sign in with ChatGPT를 골라 로그인한다.
05 Claude Code 설치
Claude Code는 Anthropic의 터미널 코딩 에이전트다. 공식 문서에 Homebrew 설치 방법이 함께 나와 있다.

brew install --cask claude-codeclaude-code는 안정(stable) 채널이라 최신 버전보다 보통 1주일쯤 늦게 따라간다. 새 버전을 바로 받으려면 claude-code 대신 claude-code@latest를 설치한다. 둘은 함께 설치할 수 없다.
Homebrew로 설치하면 자동 업데이트가 되지 않으니 brew upgrade claude-code로 직접 올린다. 공식 문서가 기본으로 권하는 방식은 자동 업데이트되는 네이티브 설치 스크립트지만 이 글은 설치 관리를 Homebrew 하나로 모으려고 brew를 쓴다.
설치가 끝나면 claude --version으로 확인한다. 이어서 claude를 실행하면 브라우저가 열리고 로그인 화면이 나온다.
06 agy(Antigravity CLI) 설치
agy는 구글 Antigravity의 터미널 에이전트 Antigravity CLI의 실행 명령이다. Homebrew에는 antigravity-cli라는 이름으로 올라와 있고 설치하면 agy 명령이 생긴다.

brew install --cask antigravity-cli구글 공식 문서가 안내하는 방법은 설치 스크립트(curl -fsSL https://antigravity.google/cli/install.sh | bash)이고 antigravity-cli는 Homebrew 공식 cask 저장소에 등록된 패키지다. macOS 12 이상에서 설치되고 앱이 스스로 업데이트하는 방식이라 따로 brew upgrade를 하지 않아도 된다.
설치 후 프로젝트 폴더에서 agy를 실행하면 기본 브라우저가 열리고 Google 계정으로 로그인한다. 첫 실행 때는 색 테마, 렌더링 방식, 작업 폴더 신뢰 여부를 묻는 간단한 설정이 나온다.
07 Orca에서 에이전트 고르기
세 에이전트를 설치했으면 Orca에서 바로 고를 수 있다. Orca의 기본 에이전트 목록에 Claude Code, Codex, Antigravity가 모두 들어 있다.

순서 | 할 일 |
|---|---|
1 | 사이드바의 Add Repo로 작업할 저장소를 추가한다 |
2 | 저장소 옆 + 버튼이나 ⌘N으로 새 워크스페이스를 만든다 |
3 | Agent 항목에서 Claude Code, Codex, Antigravity 중 하나를 고른다 |
4 | 같은 작업을 다른 에이전트로 하나 더 만들면 결과를 나란히 비교할 수 있다 |
기본으로 열릴 에이전트는 Settings → Agents에서 바꾼다.
주의할 점이 하나 있다. Orca는 새로 띄우는 에이전트에 권한 확인을 건너뛰는 옵션을 기본으로 붙인다. Claude Code에는 --dangerously-skip-permissions, Codex에는 --dangerously-bypass-approvals-and-sandbox가 들어간다.
작업마다 워크트리가 분리돼 있어 결과를 버리기 쉽다는 이유다. 다만 워크트리는 작업 파일을 나누는 기능이지 보안 샌드박스가 아니며, 권한 확인 우회로 실행한 명령의 위험을 없애 주지는 않는다. 에이전트가 실행하는 명령을 하나하나 확인하고 싶다면 Settings → Agents → Agent Permissions에서 Manual로 바꾸면 된다. 이미 사용자 지정한 실행 인자가 있다면 실제 인자와 접근 권한도 별도로 확인한다.
08 설치가 안 될 때
증상 | 원인 | 해결 |
|---|---|---|
brew: command not found | Homebrew를 PATH에 추가하지 않음 | 01의 Next steps 세 줄을 실행하고 새 터미널 창을 연다 |
codex, claude, agy를 찾지 못함 | 설치가 끝나지 않았거나 터미널이 이전 설정을 쓰는 중 | 새 터미널 창을 열고 brew list --cask로 설치 목록을 확인한다 |
예전에 다른 방법으로 깐 claude가 실행됨 | 설치 스크립트나 npm으로 깐 claude가 함께 있음 | which -a claude로 경로를 확인하고 하나만 남긴다 |
Homebrew로 모아 설치했으니 업데이트도 한 번에 한다. agy처럼 스스로 업데이트하는 앱은 brew upgrade 대상에서 빠진다.
brew update
brew upgrade마지막으로 전체 설치를 한 번에 확인한다. 각 줄에서 버전 번호나 경로가 나오면 정상이다.
brew --version
node -v
npm -v
codex --version
claude --version
which agy09 얼라이엑스의 정리
새 맥이라면 Homebrew, Node.js, Orca, 에이전트 순서만 지키면 된다. 모든 설치를 Homebrew로 모아 두면 업데이트와 삭제도 brew 명령으로 한곳에서 관리할 수 있다.
에이전트는 하나만 써도 충분하다. 다만 Orca에서는 같은 작업을 여러 에이전트에 맡기고 결과를 비교할 수 있으니 구독 중인 서비스가 여럿이라면 함께 연결해 두는 편이 낫다.
얼라이엑스는 팀 단위 AI 개발환경 세팅과 코딩 에이전트 도입 교육을 함께한다. 문의는 allaixlabs@gmail.com으로 하면 된다.
자주 묻는 질문
Homebrew 설치 후 brew: command not found가 나오면 어떻게 하나요?
먼저 설치 마지막의 Next steps에 나온 PATH 설정 명령을 실행한다. 원문은 Apple Silicon 맥의 zsh 예시로 /opt/homebrew/bin/brew shellenv 설정을 ~/.zprofile에 추가하는 세 줄을 제시하지만, 실제 설치 화면의 안내가 다르면 그 안내를 따른다. 새 터미널을 연 뒤 brew --version으로 확인한다.
Orca를 쓰려면 Codex·Claude Code·agy를 모두 설치하고 Node.js도 준비해야 하나요?
세 에이전트를 모두 사용할 필요는 없다. 원문은 구독 중인 서비스를 비교해 쓰는 구성으로 세 가지를 안내하며 하나만 써도 된다고 설명한다. Node.js는 npx로 실행하는 MCP 서버와 자바스크립트 도구를 위해 포함했다. Orca 자체가 모델이나 서비스 이용권을 제공하는 것은 아니므로 사용할 에이전트의 계정·요금제·인증 방식을 별도로 확인한다.
Orca가 작업별 워크트리를 만들면 에이전트 명령은 안전하게 격리되나요?
워크트리는 작업의 파일 변경을 나누고 결과를 비교·폐기하기 위한 기능이지 보안 샌드박스가 아니다. 원문이 확인한 Orca 기본 실행에는 Claude Code의 --dangerously-skip-permissions와 Codex의 --dangerously-bypass-approvals-and-sandbox 같은 권한 확인 우회 옵션이 포함된다. 명령을 직접 확인하려면 Settings → Agents → Agent Permissions를 Manual로 바꾸고 실제 실행 인자와 접근 권한도 확인한다.
참고 자료
Homebrew: https://brew.sh
Homebrew 설치 문서: https://docs.brew.sh/Installation
Homebrew node 패키지: https://formulae.brew.sh/formula/node
Homebrew codex 패키지: https://formulae.brew.sh/cask/codex
Homebrew claude-code 패키지: https://formulae.brew.sh/cask/claude-code
Homebrew antigravity-cli 패키지: https://formulae.brew.sh/cask/antigravity-cli
Orca 설치 문서: https://www.onorca.dev/docs/install
Orca 지원 에이전트: https://www.onorca.dev/docs/agents/supported
Codex CLI: https://developers.openai.com/codex/cli
Claude Code 설치 문서: https://code.claude.com/docs/en/setup
Antigravity CLI 설치 문서: https://antigravity.google/docs/cli/install
2026년 10월 5일 기준으로 각 공식 문서와 Homebrew 패키지 정보를 확인했다. 설치 명령은 바뀔 수 있으니 실행 전에 공식 문서를 한 번 더 보는 것이 좋다.
기록 범위: Apple Silicon 맥·zsh와 2026년 10월 5일 확인한 문서·패키지 정보를 기준으로 쓴 안내다. 버전·계정·요금제·설치 명령은 바뀔 수 있으므로 실행 전 공식 문서를 확인한다. 10월 28일에는 설명과 FAQ를 보완했으며, 새 맥 설치·로그인·에이전트 실행 시험을 수행하지 않았다.
상담 신청