🤖 Pi Coding Agent 설치 가이드
Pi 는 최소한의 핵심을 가진 터미널 코딩 해니스입니다. TypeScript 확장, 스킬, 프롬프트 템플릿, 테마, pi 패키지를 통해 확장할 수 있도록 설계되었습니다.
공식 문서: https://pi.dev/docs/latest
📋 시스템 요구사항
| 항목 | 요구사항 |
|---|---|
| 운영체제 | Linux, macOS, Windows (WSL2 권장) |
| Node.js | 18 이상 |
| npm | 9 이상 |
| 터미널 | ANSI 색상 지원 |
| 네트워크 | API 키 또는 구독 인증 |
🚀 설치 방법
방법 1: npm 으로 설치 (권장)
# 전역 설치
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
# 설치 확인
pi --version
방법 2: 설치 스크립트 사용 (Linux/macOS)
# curl 로 설치
curl -fsSL https://pi.dev/install.sh | sh
# 설치 확인
pi --version
참고: --ignore-scripts 옵션은 설치 중 스크립트 실행을 비활성화합니다.
다른 패키지 매니저
- pnpm:
pnpm add -g @earendil-works/pi-coding-agent - Yarn:
yarn global add @earendil-works/pi-coding-agent - Bun:
bun add -g @earendil-works/pi-coding-agent
🔧 첫 실행
1. 프로젝트 디렉토리에서 실행
# 프로젝트 디렉토리로 이동
cd /path/to/your/project
# Pi 시작
pi
2. 인증 방법 선택
-
/login명령어로 구독 인증브라우저가 열리고 Pi 구독 계정으로 로그인합니다.
-
API 키 설정
# Anthropic API 키 설정 export ANTHROPIC_API_KEY="sk-ant-..." # 또는 .env 파일에 추가 echo "ANTHROPIC_API_KEY=sk-ant-..." >> .env
보안 주의: API 키를 코드에 하드코딩하지 마세요.
⚙️ 모델 설정
내장 제공자
| 제공자 | API 키 변수 | 설명 |
|---|---|---|
| Anthropic | ANTHROPIC_API_KEY |
Claude 모델 |
| OpenAI | OPENAI_API_KEY |
GPT 모델 |
| Custom Provider | 사용자 정의 | 커스텀 API |
커스텀 모델 추가는 공식 문서를 참조하세요.
🔧 기본 명령어
| 명령어 | 설명 |
|---|---|
pi |
Pi 시작 |
/login |
인증 |
/help |
도움말 |
/exit |
종료 |
/settings |
설정 |
❓常见问题
Q: 설치가 안 돼요
Node.js 18 이상, npm 9 이상 확인:
node --version
npm --version
Q: API 키가 작동하지 않아요
# 환경 변수 확인
echo $ANTHROPIC_API_KEY
Q: 터미널 스크롤 문제가 있어요
ANSI 색상 지원하는 터미널 사용 (iTerm2, Windows Terminal)