🍎 Mac (터미널)

# 1. uv 설치 (Python 패키지 매니저)
curl -LsSf https://astral.sh/uv/install.sh | sh

2. Python 3.14 설치

uv python install 3.14

3. Takopi 설치

uv tool install -U takopi

4. 코딩 에이전트 설치 (원하는 것 골라서)

npm install -g @openai/codex # Codex (ChatGPT 구독)
npm install -g @anthropic-ai/claude-code # Claude Code (Claude 구독)
npm install -g opencode-ai@latest # OpenCode (75+ 프로바이더)

5. 온보딩 (텔레그램 봇 연결)

takopi --onboard

🪟 Windows WSL
# 0. WSL 터미널 열기 (PowerShell에서)
wsl

1. uv 설치

curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.bashrc # 또는 터미널 재시작

2. Python 3.14 설치

uv python install 3.14

3. Node.js 없으면 설치

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

4. Takopi 설치

uv tool install -U takopi

5. 코딩 에이전트 설치

npm install -g @openai/codex
npm install -g @anthropic-ai/claude-code
npm install -g opencode-ai@latest

6. 온보딩

takopi --onboard

온보딩 과정 (공통)

takopi --onboard 실행하면
1. 텔레그램 봇 토큰 입력 → @BotFather에서 /newbot으로 만들어서 토큰 복붙
2. 워크플로우 선택 → Assistant(대화형) / Workspace(프로젝트별) / Handoff(수동 제어)
3. 기본 엔진 선택 → codex, claude, opencode 중 택