143 lines
8.7 KiB
Markdown
143 lines
8.7 KiB
Markdown
|
# 🤖 [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)
|