하네스란?
코드를 치고 코드를 읽는 개발자들은 LLM 에게 물어보고 코드를 받고 읽는 수준으로 그동안 사용해왔습니다. 하지만 단순한 질문-답변을 넘어, 실제 비즈니스 환경에 AI를 도입하고 자체적인 AI 시스템을 구축하려면 훨씬 더 체계적이고 강력한 인프라가 필요합니다. 무질서한 데이터와 복잡한 AI 모델 사이에서 중심을 잡아주는 시스템, 바로 ‘하네스(Harness)‘가 필요한 시점입니다.
원래 하네스는 사람과 작업으로 예시하면 암벽 등반을 할 때 몸을 지탱해 주는 안전벨트나, 동력이 제대로 전달되도록 묶어주는 장구를 의미합니다.
AI 시스템에서의 하네스 역시 마찬가지입니다. 길들여지지 않은 방대한 데이터를 안전하고 통제 가능한 상태로 다듬어 AI 모델에 효율적으로 전달하는 ‘통합 제어 및 데이터 관리 프레임워크’를 뜻합니다.
그래서 하네스와 파이?
앞서 설명한 AI 시스템의 하네스가 무질서한 데이터와 AI 모델 사이를 연결하고 통제한다면, Pi 코딩 에이전트는 ‘개발자’와 ‘AI 모델’, 그리고 수많은 ‘개발 도구들’을 하나로 묶어주는 완벽한 ‘터미널용 코딩 하네스(minimal terminal coding harness)‘입니다.
파이를 설치하면 cladue code 또는 gemini cli 처럼 터미널 환경에서 작업하게 됩니다. 만약 vscode 와 같은 IDE 환경에서 작업하던 당신이라면 이번 기회에 PI 를 써보는 것도 좋은 발전의 기회가 될 것 이라고 생각합니다 :)
이번 포스팅에선 무료 모델을 다룰 예정입니다
1. PI 설치하기
PI 공식 페이지 : https://pi.dev/
여기서 본인이 원하는 프레임워크를 통해 설치 하면 됩니다 만약 curl 을 통해 설치한다면
curl -fsSL https://pi.dev/install.sh | sh명령어로 설치하시면 됩니다.
당연히 설치할 것이기 때문에 y 를 입력,
이렇게 뜨는 이유는 저는 fnm 을 사용하는데, npm의 전역(global) 패키지들이 각각의 Node 버전마다 독립적으로 관리되기 때문에 경로 불일치로 인해서 연결이 끊긴 상태라 새로운 환경 변수를 추가한다는 뜻 입니다.
가볍게 y 를 누르면 파이 설치가 완료 됩니다.
1-1. Pi 전용 Nvidia 패키지 설치하기
추후 알려드릴 api 키는 Pi가 제공하는 기본 모델이 여러가지 있지만 아직 공식 지원을 하고 있진 않아서 기능을 추가해주어야 합니다
# pi 전용 nvidia 호출 패키지 (직접 api 키 export 해주어여함)
pi install npm:pi-nvidia-nim
# 무료 api 호출 패키지
pi install npm:pi-free이 명령어를 통해서 손쉽게 추가하실 수 있습니다. 새로운 터미널 또는 Pi 채팅 앞에 ! 를 추가하여 바로 설치하실 수 있습니다.
pi-nvidia-nim 패키지 설명 링크 pi-free 패키지 설명 링크
눈치가 빠르신 분은 아시겠지만 pi install ~~ 을 통해서 여러 개발자가 만들어놓은 기능들을 사용할 수 있습니다. 이 부분은 다음 포스팅 때 알려드리도록 하겠습니다.
이번 포스팅에선
pi install npm:pi-free만 하셔도 무방합니다 :)
무료 좋아!
2. 모델 설정하기
앞서 패키지를 설치하며 아시겠지만, PI agent 는 모델이 쓸 모자 같은 껍데기이기 떄문에 모델을 직접 설정해주셔야합니다. Antigravity , Cursor 처럼 모델을 제공해주는 서비스와 달리 api 호출을 통해서 작업을 하게 될 예정입니다.
로그인을 하라고 뜨죠잉 이제 여기서 /login 명령어를 치면
-
- 유료 구독을 하고 있는 계정을 연결할건지
-
- api 키를 등록할건지
방향키를 통해 쭈욱 내리다 보면 nvidia 가 보일겁니다. 이제 api 키를 발급해보죠!
2-1. Nvidia freemium api 키 발급받기
무료 api 라고 해서 사용량이 적으면 어쩌지? 성능이안좋으면 어쩌지?
당연히 Opus4.7 또는 gpt5.5 보다는 낮겠지만 kimi 2.6은 벤치마킹 점수를 검색해보시면 가벼운 작업에는 괜찮은 수준으로 보입니다. 필자도 가벼운 작업에 직접 써 보고 포스팅을 하니 한번 사용해보시죠
추가로 분당 40회 호출만 지킨다면 언제든지 무료로 사용할 수 있다는 사실! 그리고 nvidia 에서 제공하는 다른 모델도 사용할 수 있으니 맘에 안드신다면 다른 모델 사용하셔도 됩니다 :)
우측 상단을 통해 회원가입 하시고
여기서 클라우드 계정 이름까지 다 설정하시면 됩니다.
그리고 핸드폰 인증까지 하시면 api 키를 만드실 수 있습니다.
모든게 완료 되었다면 다시 우측 상단에 api 페이지를 가셔서 api 키를 발급받으시고
여기에 입력하면 api 키 등록까지 완료 하신겁니다.
다음 포스팅에는 이제 모델 자연어를 입력하게 될 모델 설정방법과 여러가지 Pi 내장 기능들 사용법에 대해서 포스팅 해보도록 하겠습니다. 감사합니다!