이미 절차를 작성해 모델에 전달하는 방법을 알고 계실 것입니다. 여기서 새롭게 달라진 점은 실행이 더 이상 내 노트북에서 이루어지지 않는다는 것입니다. 이제 실행은 클라우드에서, 팀의 실제 계정으로, 트리거에 따라, 동료들 앞에서 진행됩니다.
따라서 둘러보기는 건너뛰세요. 지금까지 구축한 거의 모든 것이 이곳에 자리할 수 있습니다. 단지 이름만 다를 뿐입니다.
| 현재 보유한 것 | Okou에서의 변환 |
|---|---|
CLAUDE.md / AGENTS.md | 에이전트의 지침 — 상시 지시 사항 |
스킬 / SKILL.md | 해당 에이전트가 소유한 워크플로우 |
| 직접 실행하는 MCP 서버 | 워크스페이스에 MCP가 활성화된 경우의 커스텀 커넥터 |
| 셸에 저장된 API 키 및 환경 변수 | 커넥터 — 비밀은 모델에 전달되지 않음 |
cron 및 노트북의 스크립트 | 워크플로우의 자동화 |
| 더 많은 터미널 탭 | 워크스페이스별로 구매하는 더 많은 동시 실행 |
| Claude 또는 Codex 구독 | 여전히 본인 소유 — 설정 → 모델에서 연결 |
추가 비용이 발생하지 않도록, 중복 추론 비용을 유발하는 두 가지를 제거하고 기존 작업을 재작성하는 것부터 시작하세요.
1. 이미 결제 중인 구독으로 실행하기
Okou는 Free 및 유료 플랜에서, 제공업체 계정이 지원하는 경우 본인의 Claude 또는 Codex 계정을 통해 모델 호출을 라우팅할 수 있습니다.
이 과정은 두 부분으로 나뉘며, 각각 다른 담당자가 수행합니다.
관리자가 라우트 선택
설정 → 모델에서 워크스페이스 관리자가 각 모델의 제공 방식을 결정합니다. 두 가지 주요 옵션은 다음과 같습니다:
- Claude 구독 — 각 구성원이 자신의 Pro, Max 또는 Team 플랜을 연결합니다.
- Codex 구독 — 각 구성원이 자신의 Pro 또는 Team 플랜을 연결합니다.
정책이 라우트를 결정하며, 모델 선택기가 아닌 정책에 따라 라우트가 정해집니다. 따라서 모델이 이 중 하나로 설정되어 있지 않으면, 본인 연결이 해당 모델을 제공하지 않습니다.
본인 계정 연결
설정 → 모델의 개인 섹션에서 — 본인 실행에만 사용되며, 본인 자격 증명으로 연결됨:
- Claude Code OAuth — Claude 기반 모델 라우트에 Claude Code 로그인으로 연결합니다. Okou가 Claude 승인 페이지를 열어주면, Okou를 승인하고 표시되는 인증 코드를 복사해 대화상자에 붙여넣으세요.
- ChatGPT (Codex) — Codex 디바이스 로그인을 통해 연결합니다. Okou가 디바이스 코드를 복사하고 승인 페이지를 열어주면, OpenAI에 코드를 붙여넣고 접근을 승인한 뒤 Okou가 연결을 마칠 때까지 대화상자를 열어두세요.
제공업체별로 여러 계정을 연결할 수 있으며, 하나를 활성화로 지정할 수 있습니다. 연결 후에는 계정 메뉴에서 각 구독의 남은 사용량 — 5시간 창과 주간 창 — 을 확인할 수 있어, 장시간 실행 전에 제한에 도달할지 미리 알 수 있습니다.
시작 전 알아두어야 할 세 가지:
- Free 및 유료 플랜 모두에서 본인 제공업체를 연결할 수 있습니다. 단, 제공업체 계정이 선택한 라우트를 지원해야 합니다.
- 무료 ChatGPT 플랜은 Okou를 통한 Codex 사용이 불가합니다. Plus 또는 Pro가 필요합니다.
- 모델이 어떤 라우트를 사용하든, 툴 호출, 생성, 저장은 계속 Okou 크레딧으로 과금됩니다. 구독은 '사고'에만 적용되고, '실행'에는 Okou 크레딧이 필요합니다.
채팅 입력창 옆의 모델 선택기는 모델만 선택하며, 정책이 지정한 라우트를 덮어쓰지 않습니다. 모델은 채팅 스레드에 귀속되며, 에이전트나 워크플로우에는 귀속되지 않습니다 — 모델 참고.
2. 스킬을 워크플로우로 이전하기
여러분이 스킬이라 부르는 것은 Okou에서는 워크플로우입니다. 적용 시점을 설명하는 설명, 작업 방법을 안내하는 지침, 그리고 선택적으로 첨부되는 파일로 구성된 명명된 절차입니다. 이미 작성한 SKILL.md는 거의 그대로 워크플로우 지침이 됩니다.
가장 빠른 이전 방법은 채팅으로 전달하는 것입니다. 재작성할 필요도, 실행할 필요도 없습니다:
- 파일을 첨부하세요.
SKILL.md파일을 채팅창에 바로 드래그하세요. 체크리스트, 템플릿, 참고 파일도 함께 첨부할 수 있습니다. - 또는 Okou에 링크를 제공하세요. 스킬 폴더의 GitHub URL을 붙여넣으면 Okou가 전체 내용을 읽어옵니다.
그 다음, 원하는 작업을 설명하세요:
"이것은 제가 Claude Code에서 사용하는 스킬입니다. 이 에이전트에 워크플로우로 만들어 주세요. 절차는 유지하되, 로컬 파일 경로와 셸 단계를 커넥터로 대체하고, 아직 접근할 수 없는 부분을 알려주세요."
Okou가 파일을 읽고, 이름·설명·지침을 초안으로 작성한 뒤 저장 전 결과를 보여줍니다.
이전 시 수정할 가치가 있는 네 가지 차이점
- 워크플로우는 정확히 한 에이전트에 속합니다. 해당 에이전트가 권한을 가진 커넥터만 접근할 수 있습니다. 로컬 스킬은 셸에서 접근 가능한 모든 것을 상속하지만, 이곳에서는 그렇지 않습니다. 포팅된 워크플로우가 Gmail에 접근하지 못한다면 지침이 아니라 에이전트의 권한을 확인하세요.
- 이름은 소문자 슬러그입니다. —
triage-bug-report, 2에서 64자까지. 소유 에이전트의 채팅에서/triage-bug-report로 직접 호출하거나, 작업을 설명하면 Okou가 설명을 기준으로 매칭합니다. 정확한 설명이 있어야 워크플로우가 자동으로 실행됩니다. - 새 워크플로우는 기본적으로 비공개입니다. 워크스페이스에 공개하려면 별도 조치가 필요하며, 저장만으로는 공개되지 않습니다. 두 에이전트가 동일한 절차를 보유해도, 각자의 목소리와 권한에 따라 결과가 달라질 수 있습니다.
- 자격 증명은 이동하지 않습니다. 로컬 스킬의 환경 변수나 키는 커넥터로 대체되어, 비밀이 플랫폼에만 남고 모델에는 전달되지 않습니다. 적합한 1차 커넥터가 없다면, 지침에 키를 붙여넣지 말고 커스텀 커넥터로 구축하세요.
변경 없이 그대로 이전되는 한 가지: 보조 파일입니다. 템플릿, 체크리스트, 브랜드 가이드라인, 참고 데이터는 기존 SKILL.md 옆에 있던 것처럼 워크플로우에 첨부할 수 있습니다.
CLAUDE.md는 워크플로우가 아니라 에이전트입니다
스킬은 워크플로우가 됩니다. CLAUDE.md 또는 AGENTS.md에 보관하던 상시 규칙 — 톤, 사내 스타일, 금지 사항, 중단 및 문의 시점 등 — 은 에이전트의 지침에 위치해야 하며, 해당 에이전트의 모든 워크플로우가 이를 상속합니다.
파일을 붙여넣고 Okou에 에이전트 지침에 통합해 달라고 요청하세요. 제품 구조에 맞게 분리하세요: 업무 방식은 에이전트에, 특정 작업 방법은 워크플로우로 만드세요.
3. 로컬 CLI에 없는 기능 활용하기
모델 라우트와 절차를 준비했다면, Okou의 나머지 기능은 노트북에서 할 수 없는 부분입니다:
- 커넥터 — 에이전트가 읽고 쓸 수 있는 인증된 서비스로, 자격 증명은 네트워크 경계에 보관되고 모든 호출이 실행 로그에 기록됩니다. 이는 셸 프로필의 개인 액세스 토큰 모음을 대체합니다.
- 커스텀 커넥터 — 1차 커넥터가 없는 내부 API용. 관리자가 HTTPS 접두사와 인증을 한 번 등록하면, 워크스페이스에서 활성화된 경우 Streamable HTTP MCP 엔드포인트도 동일하게 등록할 수 있어, Claude Code에 이미 노출된 서버도 여기서 접근 가능합니다.
- 동시 실행 — 추가 터미널 탭을 기억할 필요 없이 워크스페이스 차원에서 확장할 수 있습니다. 긴 작업이 짧은 작업을 막지 않습니다.
- 자동화 — 워크플로우에 연결된 트리거: 일정, 새 이메일, 병합된 풀 리퀘스트, 캘린더 이벤트, 웹훅 등. 이 기능이 절차를 기억해야 하는 명령이 아닌, 팀원으로 만들어줍니다.
- 에이전트 — 고유 지침, 톤, 커넥터 권한을 가진 지속적 정체성으로, 실행 및 사용자 간에도 예측 가능한 동작을 보장합니다.
- 통합 — 동일한 에이전트를 Slack, Telegram, 웹 등 다양한 채널에서 접근할 수 있습니다. 더 이상 한 대의 터미널에만 국한되지 않습니다.
4. 도트파일에만 두지 말고 공유하세요
로컬 환경과의 진짜 차이는, 여러분이 만든 것을 다른 사람도 사용할 수 있다는 점입니다. 터미널을 열지 않는 사람도 포함해서 말이죠.
- 에이전트를 공개로 설정하고, 팀이 가장 먼저 실행하길 원하는 워크플로우를 게시하세요.
- 자격 증명과 일회성 데이터는 지침 및 파일에서 제거한 뒤 공유하세요.
- 설정 → 구성원 → 구성원 추가에서 동료를 초대하세요. 기본 역할은 Member입니다. 동료 초대 참고.
- 각 구성원은 본인 계정과 Claude 또는 Codex 구독을 직접 연결합니다. 로그인 정보는 공유하지 않습니다.
신규 사용자 안내 중 3~6 단계에서 에이전트 구축, 워크플로우 게시, 일정 예약을 더 자세히 다룹니다. 방식은 동일하며, 시작점만 다릅니다.
