# 🤖 [macOS / Linux] 4. AI 개발 에이전트 (AI Agents)

[⬅️ 메인 README로 돌아가기](../README.md) | [💻 Windows 가이드 보기](./WIN-04-AI-AGENTS.md)

---

## ⚡ 빠른 원클릭 설치 (Bash)

```bash
# 4.1. Antigravity CLI (agy)
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-agy.sh?ref_type=heads" | bash

# 4.2. Claude Code
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-claude-code.sh?ref_type=heads" | bash

# 4.3. Codex CLI
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-codex-cli.sh?ref_type=heads" | bash

# 4.4. OpenCode
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-opencode.sh?ref_type=heads" | bash

# 4.5. pi (Pi Coding Agent + 추천 패키지 15종 일괄 설치)
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-pi.sh?ref_type=heads" | bash
```

---

## 📖 도구별 상세 사용법 및 팁

### 4.1. [Antigravity CLI (agy)](https://antigravity.google)
Google Antigravity 2.0 플랫폼의 공식 터미널 코딩 에이전트 인터페이스입니다. 로컬 파일 시스템 및 빌드 툴체인과 실시간으로 상호작용하는 최첨단 쌍방향 AI 엔진입니다.

* **설치 명령:**
  ```bash
  curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-agy.sh?ref_type=heads" | bash
  ```
* **주요 특징:**
  * **로컬 터미널 밀착 코딩** — 별도의 무거운 데스크톱 GUI 없이 터미널 내부에서 완벽한 페어 프로그래밍 실현
  * **보안 Google 계정 연동** — 첫 가동 시 Google Sign-In 보안 흐름이 브라우저와 클라이언트 단에서 연동 가동됨
  * **유연한 자동화** — CI/CD 파이프라인이나 백그라운드 워커 스크립트에서 자동 코딩 과업 실행 지원

```bash
agy                  # 대화형 코딩 에이전트 쉘 가동
agy -p "요청사항"     # 지정 요청 과업에 대한 단일 실행 및 분석 (Print 모드)
agy --help           # 도움말 및 명령어 명세 로드
```

---

### 4.2. [Claude Code](https://code.claude.com/)
Anthropic사에서 개발한 공식 터미널 기반 AI 개발 어시스턴트 툴킷입니다. npm이 깔려있지 않은 시스템에서도 curl 공식 네이티브 설치 방식을 사용하여 즉시 CLI 코딩 환경에 접목할 수 있습니다.

* **설치 명령:**
  ```bash
  curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-claude-code.sh?ref_type=heads" | bash
  ```
* **주요 특징:**
  * **고속 컨텍스트 추론** — Anthropic Claude 고성능 추론 엔진을 터미널 내에서 바로 가동
  * **네이티브 실행 제어** — 시스템 아키텍처 환경과 로컬 파일 구조를 깊이 이해하고 즉시 빌드 및 리서치 수행
  * **안전성 확보** — 강력한 로컬 샌드박스 정책 및 권한 승인 모드를 통해 안전한 자동 코딩 보장

```bash
claude                  # 대화형 코딩 세션 시작 (OAuth 로그인 연동)
claude -p "질문/작업"   # 터미널 창을 열지 않고 즉시 지시 수행 및 결과 출력 (단발 실행)
claude --help           # 도움말 및 사용법 로드
```

---

### 4.3. [Codex CLI](https://developers.openai.com/codex/cli)
OpenAI사에서 개발한 공식 터미널 기반 대화형 로컬 코딩 에이전트 CLI입니다. Rust 기반으로 제작되어 높은 성능을 자랑하며, npm 없이도 단일 실행 공식 인스톨러 방식을 활용해 네이티브하게 작동합니다.

* **설치 명령:**
  ```bash
  curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-codex-cli.sh?ref_type=heads" | bash
  ```
* **주요 특징:**
  * **강력한 시스템 통합** — 터미널 로컬 환경에서 사용자의 지시 하에 파일 편집, 아키텍처 리서치 및 CLI 빌드 실행 지원
  * **다양한 모델 스왑** — 세션 내에서 GPT-5.4, GPT-5.3-Codex 등으로 자유롭게 두뇌 변경 및 추론 조작 지원
  * **멀티모달 시각 분석** — 스크린샷이나 와이어프레임 설계도를 입력받아 UI 코드를 고속으로 구현 및 피드백

```bash
codex auth              # OpenAI ChatGPT 또는 API 계정 연동 로그인
codex                   # 대화형 코딩 TUI 세션 시작
codex -p "작업명령"     # 로컬 파일 시스템 변경 및 빌드 직접 지시 (단발)
```

---

### 4.4. [OpenCode](https://opencode.ai/)
터미널, IDE, 데스크톱 환경을 아우르는 오픈소스 AI 코딩 에이전트 CLI입니다. 특정 AI 프로바이더에 종속되지 않고 OpenAI, Anthropic, Google(Gemini)뿐 아니라 Ollama 등 로컬 모델을 포함한 75개 이상의 LLM 프로바이더를 자유롭게 연결하여 코드베이스 분석, 파일 편집, 터미널 명령 실행 등을 수행합니다.

* **설치 명령:**
  ```bash
  curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-opencode.sh?ref_type=heads" | bash
  ```

```bash
opencode             # 대화형 코딩 TUI 세션 시작
opencode auth login  # AI 모델 프로바이더 계정 및 API 키 연동
opencode --help      # 도움말 및 사용 가능 옵션 확인
```

---

### 4.5. [Pi Coding Agent (pi)](https://pi.dev/)
CLI 기반의 최첨단 AI 코딩 파트너입니다. 본 저장소의 `install-pi.sh` 설치 도구를 활용하면 에이전트 본체뿐 아니라 성능 극대화를 지원하는 핵심 플러그인 에코시스템 15종을 단번에 일괄 셋업할 수 있습니다.

* **설치 명령:**
  ```bash
  curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-pi.sh?ref_type=heads" | bash
  ```

#### [일괄 설치되는 추천 패키지 리스트]

| 패키지 | 설명 |
| :--- | :--- |
| [pi-subagents](https://pi.dev/packages/pi-subagents) | 오케스트레이션, 코드 리뷰, Auditor 등 세분화된 하위 태스크를 자식 에이전트들에 분할 위임 |
| [context-mode](https://pi.dev/packages/context-mode) | 컨텍스트 윈도우 보호 가드 및 session sandbox, BM25 로컬 검색 연동 |
| [pi-mcp-adapter](https://pi.dev/packages/pi-mcp-adapter) | 단 하나의 통합 MCP 프록시 툴을 가동하여 토큰 소모량을 아끼고 다양한 서버와 통합 |
| [pi-web-access](https://pi.dev/packages/pi-web-access) | Exa, Perplexity, Gemini API를 통합하여 구글 검색, 실시간 웹 분석 및 YouTube 영상 이해 탑재 |
| [@plannotator/pi-extension](https://pi.dev/packages/@plannotator/pi-extension) | 가동 중인 에이전트의 변경 계획안을 예쁜 로컬 브라우저 UI 상에서 직접 시각화하여 확인/승인 |
| [@juicesharp/rpiv-ask-user-question](https://pi.dev/packages/@juicesharp/rpiv-ask-user-question) | 애매모호한 요구 조건을 임의로 판단하지 않고 객관식/주관식 모달 문항을 띄워 사용자 동기화 |
| [pi-lens](https://pi.dev/packages/pi-lens) | 실시간 LSP 진단, 코드 포맷터, 타입 분석기, 수정 전 분석 안정성 가드 가동 |
| [@juicesharp/rpiv-todo](https://pi.dev/packages/@juicesharp/rpiv-todo) | 에이전트가 처리 중인 Task 목록을 /reload 시점 이후에도 영속성 있게 관리 |
| [pi-simplify](https://pi.dev/packages/pi-simplify) | 최근 편집 및 변경된 코드를 리팩토링 및 리비전 제안 피드백 가동 |
| [@juicesharp/rpiv-advisor](https://pi.dev/packages/@juicesharp/rpiv-advisor) | 행동 개시 직전 고차원 추론 모델의 2중 감사 피드백 확보 |
| [@juicesharp/rpiv-pi](https://pi.dev/packages/@juicesharp/rpiv-pi) | 리서치 -> 설계 -> 계획 -> 구현 -> 유효성 검증이라는 스킬 파이프라인 확립 |
| [@samfp/pi-memory](https://pi.dev/packages/@samfp/pi-memory) | 세션이 달라도 과거의 코딩 습관, 사용자 선호도 등을 계속 기억 및 반영 |
| [pi-btw](https://pi.dev/packages/pi-btw) | 메인 에이전트 가동에 지장을 주지 않고 병렬로 대화를 주고받을 수 있는 사이드 톡 (/btw) 지원 |
| [pi-docparser](https://pi.dev/packages/pi-docparser) | PDF, Office 파일, 다양한 시트 서식 로드 및 광학 문자 인식(OCR) 지원 |
| [pi-ollama-cloud](https://pi.dev/packages/pi-ollama-cloud?name=ollama) | 로컬 서버 사양이 무거워도 원격지 Ollama Cloud 서비스를 끌어와 동적 구동 |

```bash
pi                  # 대화형 페어 코딩 세션 개시
pi -p "구현 요청사항" # 프롬프트를 넘겨 단일 태스크 처리 및 출력 (Print 모드)
pi --help           # 도움말 및 사용 가능 커맨드 파악
pi list             # 현재 설치 완료된 플러그인 에코시스템 목록 출력
```

---

[⬅️ 이전: 3. 개발 유틸리티](./UNIX-03-DEV-UTILS.md) | [🏠 메인 README](../README.md) | [다음: 5. 바이브 코딩 도우미 ➡️](./UNIX-05-VIBE-ASSISTANTS.md)