EP3. Cocrates Harness 설치

🛠️ 5분 만에 내 컴퓨터에 'AI 코치' 들여놓기

지난 두 편의 에피소드를 통해 우리는 같은 AI라도 사용자의 태도에 따라 결과가 완전히 달라진다는 것, 그리고 주도권을 쥐기 위해서는 "검토되지 않은 산출물은 생성할 가치가 없다"는 원칙을 지켜야 한다는 것을 가슴 깊이 새겼습니다.

그렇다면 이 소크라테스식 철학을 내 컴퓨터 위에서 실현해 줄 도구, Cocrates Harness는 어떻게 시작해야 할까요?

복잡할 것 같다고요? 전혀요. 딱 5분만 투자하면 끝나는 초간단 설치법을 지금부터 친절하게 안내해 드릴 테니 눈 크게 뜨고 따라오세요! 🚀

---

🧩 Cocrates Harness의 정체는 '플러그인'입니다

가장 먼저 알아야 할 점은 Cocrates Harness가 단독으로 실행되는 프로그램이 아니라는 것입니다. 얘는 'opencode'라는 멋진 플랫폼 위에서 살아 숨 쉬는 플러그인이에요.

• opencode: AI 에이전트를 실행하고 든든하게 관리해 주는 무대(플랫폼)
• @cocrates/cocrates-harness: 그 무대 위에서 Cocrates만의 특별한 능력을 뽐내는 배우(플러그인)

구조가 참 명확하죠? 그래서 우리의 설치 미션은 딱 3단계로 나뉩니다. opencode를 깔고 → 플러그인을 심고 → 스킬 파일을 복사하면 끝입니다.

---

🛠️ Step 1. opencode 설치하기 (취향대로 골라잡기)

opencode는 여러분의 작업 스타일을 존중하여 총 세 가지 실행 방식을 제공합니다. 이 중 마음에 드는 옷을 골라 입으시면 됩니다.

설치 방식	추천 대상	특징
opencode 터미널	Claude/GPT TUI 환경을 사랑하는 힙스터	터미널 기반, 키보드 중심의 텍스트 UI (TUI)
opencode 데스크탑	Cursor나 VS Code 스타일이 손에 익은 분	깔끔한 GUI 에디터 환경 (현재 베타 버전)
opencode 확장	기존에 쓰던 Cursor/VS Code를 포기 못 하는 분	원래 쓰던 IDE 환경에 확장 기능만 쏙 추가

👉 상세한 OS별 다운로드 방법은 공식 사이트(opencode.ai/download)를 참고해 주세요.

💡 선배의 꿀팁 조언!

만약 터미널 환경(TUI)이 낯설다면, 고민하지 말고 VS Code나 Cursor 환경에서 확장 기능을 쓰시는 걸 적극 추천합니다. 특히 OpenChamber 확장을 함께 설치하면 VS Code의 Copilot이나 Cursor와 똑 닮은 예쁜 GUI 환경을 맛볼 수 있어 가장 편안하게 시작할 수 있습니다.

1. opencode 터미널을 설치한다.
2. VS Code를 설치한다.
3. OpenChamber 확장을 설치한다 (아래 그림 참조).

---

⚙️ Step 2. cocrates-harness 플러그인 심기

무대가 준비되었으니 이제 Cocrates를 심을 차례입니다. opencode의 설정 파일 하나만 살짝 수정해 주면 됩니다.

보통 ~/.config/opencode/ 디렉토리에 가면 opencode.jsonc라는 설정 파일이 기다리고 있을 겁니다. (환경변수 OPENCODE_CONFIG_DIR을 설정하셨다면 그 경로로 가시면 됩니다.)

이 파일을 열고 plugin 항목에 아래와 같이 슬쩍 추가해 주세요.

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@cocrates/cocrates-harness"]
}

벌써 2단계까지 마스터하셨습니다! 플러그인 연결 완료입니다.

---

📚 Step 3. 핵심 무기인 'Skill' 파일 복사하기

플러그인만 덜렁 있으면 Cocrates가 힘을 쓰지 못합니다. 왜냐하면 Cocrates의 진짜 뇌섹녀 같은 매력은 '스킬(Skills)'에서 나오기 때문이죠. 스킬은 교육, 구조기반 산출물 생성 등 각각의 워크플로우를 정의해 둔 마법서 같은 파일들입니다.

스킬 파일들은 Cocrates 공식 GitHub 저장소의 skills/ 폴더에 예쁘게 모여 있습니다. 이 폴더 안의 모든 내용을 내 컴퓨터의 ~/.config/opencode/skills/ 디렉토리로 복사해 넣어주시면 세팅 끝입니다!

😎 "잠깐, 귀찮은데 AI한테 시키면 안 되나요?"

당연히 됩니다! 우리는 AI를 지휘하는 디렉터니까요. opencode를 설치한 다음, 실행 창에 대고 근엄하게 한마디만 던져보세요.

👤 "https://cocrates.ai/install.md 파일을 근거로 Cocrates Harness를 설치해 줘."

그럼 똑똑한 AI가 이 가이드를 찰떡같이 알아듣고 플러그인 설정부터 스킬 파일 다운로드 및 복사까지 알아서 대행해 줍니다. 파일 찾으러 깃허브를 방황할 필요가 전혀 없죠. 세상 참 좋아졌습니다.

---

🎉 설치 완료, 그리고 설레는 첫 대화

설치가 잘 끝났다면 opencode를 가볍게 재시작해 줍니다. 그리고 Agent 목록에서 자랑스러운 Cocrates Agent를 선택해 활성화해 주세요!

자, 겉모습은 다 갖춰졌습니다. 하지만 잊지 마세요. 설치만 해둔다고 해서 여러분의 코딩 인생이 저절로 180도 바뀌지는 않습니다. Cocrates는 자판기가 아니라 코치이니까요.

Cocrates는 여러분이 대화에 참여하고, 뼈대를 검토하고, 머리를 싸매며 결정 내리는 주도적인 순간을 목마르게 기다리고 있습니다.

준비가 되셨다면, 활성화된 Cocrates에게 가볍게 첫 질문을 툭 던지며 대화를 시작해 보세요.

💬 "블룸의 분류학에 대해 알려줘."

---

📌 오늘의 핵심 요약

1. 플러그인 기반 구조: Cocrates Harness는 opencode라는 플랫폼 위에서 플러그인으로 돌아갑니다.
2. 다양한 UI 지원: 터미널, 데스크탑, IDE 확장 중 마음에 드는 것을 고르되, 초보자는 VS Code+OpenChamber 조합을 강추합니다!
3. 치트키 설치법: 직접 설정하기 귀찮다면 AI에게 "install.md 근거로 설치해 줘" 한 문장이면 끝납니다.

---

🎬 다음 편 예고

"블룸의 분류학에 대해 알려줘"라고 물어보셨나요? 아마 다른 AI들처럼 논문 같은 설명글을 길게 늘어놓지 않을 겁니다.

Cocrates는 정답을 알려주는 대신, 은근슬쩍 오류가 섞인 예시와 함께 여러분에게 첫 번째 미션을 던질 테니까요.

다음 에피소드에서는 이 당돌한 AI 코치와 함께 Education → Knowledge Capture → Reflection으로 이어지는 Cocrates만의 짜릿한 3단계 학습 파이프라인을 실제 대화 스크립트와 함께 생생하게 경험해 보겠습니다.

생각 유발 유도형 AI와의 첫 만남, 기대하셔도 좋습니다! 다음 편에서 만나요! 🦉

---

이 시리즈는 Cocrates Harness 프레임워크를 소개합니다. Cocrates는 소크라테스식 대화로 사용자가 주도권을 잡고 성장하도록 설계된 에이전트 하네스입니다.