빠른 시작

이 페이지는 설치부터 유용한 첫 번째 pi 세션을 시작하는 과정까지 안내합니다.

Pi는 npm 패키지로 배포됩니다.

npm install -g --ignore-scripts @earendil-works/pi-coding-agent

--ignore-scripts는 설치 중 의존성 라이프사이클 스크립트를 비활성화합니다. 일반적인 npm 설치에서 Pi는 설치 스크립트를 필요로 하지 않습니다.

pi를 설치할 때 사용한 패키지 관리자를 사용하세요. curl 설치 프로그램은 전역 npm을 사용하므로 curl 또는 npm으로 설치한 경우 모두 npm으로 제거합니다.

# curl installer or npm install -g
npm uninstall -g @earendil-works/pi-coding-agent

# pnpm
pnpm remove -g @earendil-works/pi-coding-agent

# Yarn
yarn global remove @earendil-works/pi-coding-agent

# Bun
bun uninstall -g @earendil-works/pi-coding-agent

pi를 제거해도 설정, 자격 증명, 세션, 설치된 pi 패키지는 ~/.pi/agent/에 남습니다.

그런 다음 pi가 작업할 프로젝트 디렉터리에서 시작합니다.

cd /path/to/project
pi

Pi는 /login을 통해 구독 Provider를 사용할 수 있습니다. API-key Provider는 환경 변수나 인증 파일을 통해 사용할 수 있습니다.

pi를 시작하고 다음을 실행합니다.

/login

그런 다음 Provider를 선택합니다. 기본 제공 구독 로그인에는 Claude Pro/Max, ChatGPT Plus/Pro (Codex), GitHub Copilot이 포함됩니다.

pi를 실행하기 전에 API key를 설정합니다.

export ANTHROPIC_API_KEY=sk-ant-...
pi

/login을 실행한 뒤 API-key Provider를 선택해 key를 ~/.pi/agent/auth.json에 저장할 수도 있습니다.

지원되는 모든 Provider, 환경 변수, cloud provider 설정은 Providers를 참고하세요.

pi가 시작되면 요청을 입력하고 Enter를 누릅니다.

Summarize this repository and tell me how to run its checks.

기본적으로 pi는 모델에 네 가지 도구를 제공합니다.

• read - 파일 읽기
• write - 파일 생성 또는 덮어쓰기
• edit - patch로 파일 수정
• bash - Shell 명령 실행

추가 내장 read-only 도구(grep, find, ls)는 도구 옵션으로 사용할 수 있습니다. Pi는 현재 작업 디렉터리에서 실행되며 그 안의 파일을 수정할 수 있습니다. 쉽게 되돌릴 수 있어야 한다면 Git이나 다른 checkpoint workflow를 사용하세요.

Pi는 시작할 때 context files를 로드합니다. 프로젝트에서 어떻게 작업해야 하는지 알려주려면 AGENTS.md 파일을 추가하세요.

# Project Instructions

- Run `npm run check` after code changes.
- Do not run production migrations locally.
- Keep responses concise.

Pi는 다음을 로드합니다.

• 전역 지침용 ~/.pi/agent/AGENTS.md
• 상위 디렉터리와 현재 디렉터리의 AGENTS.md 또는 CLAUDE.md

디렉터리에 AGENTS.override.md가 있으면 Pi는 그 디렉터리의 AGENTS.md 또는 CLAUDE.md 대신 해당 파일을 로드합니다.

context files를 변경한 뒤에는 pi를 다시 시작하거나 /reload를 실행하세요.

편집기에서 @를 입력해 파일을 fuzzy search하거나, 명령줄에서 파일을 전달할 수 있습니다.

pi @README.md "Summarize this"
pi @src/app.ts @src/app.test.ts "Review these together"

이미지나 텍스트는 Ctrl+V(Windows에서는 Alt+V)로 붙여넣을 수 있습니다. 지원되는 터미널에서는 이미지를 끌어다 놓을 수도 있습니다.

인터랙티브 모드에서:

!npm run lint

명령 출력은 모델로 전송됩니다. 출력을 모델 컨텍스트에 추가하지 않고 명령을 실행하려면 !!command를 사용하세요.

모델을 선택하려면 /model 또는 Ctrl+L을 사용하세요. thinking level을 전환하려면 Shift+Tab을 사용하세요. scoped models 사이를 전환하려면 Ctrl+P / Shift+Ctrl+P를 사용하세요.

세션은 자동으로 저장됩니다.

pi -c                  # Continue most recent session
pi -r                  # Browse previous sessions
pi --name "my task"    # Set session display name at startup
pi --session <path|id> # Open a specific session

pi 안에서는 /resume, /new, /tree, /fork, /clone으로 세션을 관리합니다.

일회성 Prompt에는 다음을 사용합니다.

pi -p "Summarize this codebase"
cat README.md | pi -p "Summarize this text"
pi -p @screenshot.png "What's in this image?"

JSON event output에는 --mode json, 프로세스 통합에는 --mode rpc를 사용하세요.

• Using Pi - 인터랙티브 모드, slash commands, 세션, context files, CLI 참조.
• Providers - 인증 및 모델 설정.
• Settings - 전역 및 프로젝트 설정.
• Keybindings - 단축키와 사용자 지정.
• Pi Packages - 공유 Extensions, Skills, Prompts, Themes 설치.

플랫폼 참고 사항: Windows, Termux, tmux, Terminal setup, Shell aliases.