8.7 KiB
8.7 KiB
🤖 [macOS / Linux] 4. AI 개발 에이전트 (AI Agents)
⬅️ 메인 README로 돌아가기 | 💻 Windows 가이드 보기
⚡ 빠른 원클릭 설치 (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)
Google Antigravity 2.0 플랫폼의 공식 터미널 코딩 에이전트 인터페이스입니다. 로컬 파일 시스템 및 빌드 툴체인과 실시간으로 상호작용하는 최첨단 쌍방향 AI 엔진입니다.
- 설치 명령:
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 파이프라인이나 백그라운드 워커 스크립트에서 자동 코딩 과업 실행 지원
agy # 대화형 코딩 에이전트 쉘 가동
agy -p "요청사항" # 지정 요청 과업에 대한 단일 실행 및 분석 (Print 모드)
agy --help # 도움말 및 명령어 명세 로드
4.2. Claude Code
Anthropic사에서 개발한 공식 터미널 기반 AI 개발 어시스턴트 툴킷입니다. npm이 깔려있지 않은 시스템에서도 curl 공식 네이티브 설치 방식을 사용하여 즉시 CLI 코딩 환경에 접목할 수 있습니다.
- 설치 명령:
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-claude-code.sh?ref_type=heads" | bash - 주요 특징:
- 고속 컨텍스트 추론 — Anthropic Claude 고성능 추론 엔진을 터미널 내에서 바로 가동
- 네이티브 실행 제어 — 시스템 아키텍처 환경과 로컬 파일 구조를 깊이 이해하고 즉시 빌드 및 리서치 수행
- 안전성 확보 — 강력한 로컬 샌드박스 정책 및 권한 승인 모드를 통해 안전한 자동 코딩 보장
claude # 대화형 코딩 세션 시작 (OAuth 로그인 연동)
claude -p "질문/작업" # 터미널 창을 열지 않고 즉시 지시 수행 및 결과 출력 (단발 실행)
claude --help # 도움말 및 사용법 로드
4.3. Codex CLI
OpenAI사에서 개발한 공식 터미널 기반 대화형 로컬 코딩 에이전트 CLI입니다. Rust 기반으로 제작되어 높은 성능을 자랑하며, npm 없이도 단일 실행 공식 인스톨러 방식을 활용해 네이티브하게 작동합니다.
- 설치 명령:
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 코드를 고속으로 구현 및 피드백
codex auth # OpenAI ChatGPT 또는 API 계정 연동 로그인
codex # 대화형 코딩 TUI 세션 시작
codex -p "작업명령" # 로컬 파일 시스템 변경 및 빌드 직접 지시 (단발)
4.4. OpenCode
터미널, IDE, 데스크톱 환경을 아우르는 오픈소스 AI 코딩 에이전트 CLI입니다. 특정 AI 프로바이더에 종속되지 않고 OpenAI, Anthropic, Google(Gemini)뿐 아니라 Ollama 등 로컬 모델을 포함한 75개 이상의 LLM 프로바이더를 자유롭게 연결하여 코드베이스 분석, 파일 편집, 터미널 명령 실행 등을 수행합니다.
- 설치 명령:
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-opencode.sh?ref_type=heads" | bash
opencode # 대화형 코딩 TUI 세션 시작
opencode auth login # AI 모델 프로바이더 계정 및 API 키 연동
opencode --help # 도움말 및 사용 가능 옵션 확인
4.5. Pi Coding Agent (pi)
CLI 기반의 최첨단 AI 코딩 파트너입니다. 본 저장소의 install-pi.sh 설치 도구를 활용하면 에이전트 본체뿐 아니라 성능 극대화를 지원하는 핵심 플러그인 에코시스템 15종을 단번에 일괄 셋업할 수 있습니다.
- 설치 명령:
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-pi.sh?ref_type=heads" | bash
[일괄 설치되는 추천 패키지 리스트]
| 패키지 | 설명 |
|---|---|
| pi-subagents | 오케스트레이션, 코드 리뷰, Auditor 등 세분화된 하위 태스크를 자식 에이전트들에 분할 위임 |
| context-mode | 컨텍스트 윈도우 보호 가드 및 session sandbox, BM25 로컬 검색 연동 |
| pi-mcp-adapter | 단 하나의 통합 MCP 프록시 툴을 가동하여 토큰 소모량을 아끼고 다양한 서버와 통합 |
| pi-web-access | Exa, Perplexity, Gemini API를 통합하여 구글 검색, 실시간 웹 분석 및 YouTube 영상 이해 탑재 |
| @plannotator/pi-extension | 가동 중인 에이전트의 변경 계획안을 예쁜 로컬 브라우저 UI 상에서 직접 시각화하여 확인/승인 |
| @juicesharp/rpiv-ask-user-question | 애매모호한 요구 조건을 임의로 판단하지 않고 객관식/주관식 모달 문항을 띄워 사용자 동기화 |
| pi-lens | 실시간 LSP 진단, 코드 포맷터, 타입 분석기, 수정 전 분석 안정성 가드 가동 |
| @juicesharp/rpiv-todo | 에이전트가 처리 중인 Task 목록을 /reload 시점 이후에도 영속성 있게 관리 |
| pi-simplify | 최근 편집 및 변경된 코드를 리팩토링 및 리비전 제안 피드백 가동 |
| @juicesharp/rpiv-advisor | 행동 개시 직전 고차원 추론 모델의 2중 감사 피드백 확보 |
| @juicesharp/rpiv-pi | 리서치 -> 설계 -> 계획 -> 구현 -> 유효성 검증이라는 스킬 파이프라인 확립 |
| @samfp/pi-memory | 세션이 달라도 과거의 코딩 습관, 사용자 선호도 등을 계속 기억 및 반영 |
| pi-btw | 메인 에이전트 가동에 지장을 주지 않고 병렬로 대화를 주고받을 수 있는 사이드 톡 (/btw) 지원 |
| pi-docparser | PDF, Office 파일, 다양한 시트 서식 로드 및 광학 문자 인식(OCR) 지원 |
| pi-ollama-cloud | 로컬 서버 사양이 무거워도 원격지 Ollama Cloud 서비스를 끌어와 동적 구동 |
pi # 대화형 페어 코딩 세션 개시
pi -p "구현 요청사항" # 프롬프트를 넘겨 단일 태스크 처리 및 출력 (Print 모드)
pi --help # 도움말 및 사용 가능 커맨드 파악
pi list # 현재 설치 완료된 플러그인 에코시스템 목록 출력