Claude Code 및 Codex 사용자를 위한 안내

절차를 작성해 모델에 넘기는 방법은 이미 알고 계실 겁니다. 여기서 새로워진 점은 실행이 더 이상 노트북에서 이루어지지 않는다는 것입니다. 클라우드에서, 팀의 실제 계정을 대상으로, 트리거에 의해, 팀원들 앞에서 실행됩니다.

그러니 둘러보는 일은 건너뛰세요. 이미 만든 것의 거의 모든 항목이 여기에도 자리를 갖고 있습니다. 이름만 다를 뿐입니다.

이제, 한 번 더 추론 비용을 내게 만들고 이미 가진 것을 다시 쓰게 만드는 두 가지를 먼저 제거하는 것부터 시작하세요.

어떤 환경을 사용 중인가요?

이 문서는 두 가지 환경을 모두 다룹니다. Settings → Personal → My Okou가 보이면 My Okou 단계를 따르세요. New agent가 있는 Agents 페이지를 사용한다면 Legacy Agents 단계를 따르세요. 사용 가능 여부는 회원마다 다를 수 있으며, 이 문서는 사용 환경을 바꾸지 않습니다.

어느 환경에서든 여러 채팅이나 작업을 동시에 실행하고, 워크플로를 재사용하고, 검토된 작업을 팀과 공유할 수 있습니다. 런타임 하위 에이전트는 실행 도구일 뿐이며, 따로 만들어야 하는 별도의 제품 프로필이 아닙니다.

1. 이미 비용을 지불 중인 구독으로 실행하기

Okou는 제공업체 계정이 이를 지원하는 경우, Free 및 유료 요금제에서 자신의 Claude 또는 Codex 계정을 통해 모델 호출을 라우팅할 수 있습니다.

이 기능은 두 부분으로 나뉘며, 서로 다른 사람이 각각 맡습니다.

관리자가 경로를 선택합니다

Settings → Models에서 워크스페이스 관리자가 각 모델이 어떻게 제공될지 결정합니다. 선택지 중 두 가지는 다음과 같습니다:

• Claude subscription — 각 멤버가 자신의 Pro, Max 또는 Team 요금제를 연결합니다.
• Codex subscription — 각 멤버가 자신의 Pro 또는 Team 요금제를 연결합니다.

경로는 모델 선택기가 아니라 정책이 결정합니다. 따라서 어떤 모델이 이들 중 하나로 설정되어 있지 않다면, 개인 연결이 그 모델을 제공하는 데 사용되지 않습니다.

자신의 계정을 연결합니다

Settings → Models의 Personal 섹션에서 — 오직 자신의 실행에만 사용되며, 자신의 자격 증명으로 사용됨:

• Claude Code OAuth — Claude 기반 모델 경로에 대해 Claude Code 로그인으로 연결합니다. Okou가 Claude 승인 페이지를 열면, 그곳에서 Okou를 승인하고 표시된 인증 코드를 복사해 대화 상자에 다시 붙여넣으세요.
• ChatGPT (Codex) — Codex 기기 로그인을 사용해 연결합니다. Okou가 기기 코드를 복사하고 승인 페이지를 열면, 코드를 OpenAI에 붙여넣고 액세스를 승인한 다음, Okou가 연결을 마칠 때까지 대화 상자를 열린 상태로 두세요.

제공업체당 둘 이상의 계정을 연결하고 하나를 활성 상태로 표시할 수 있습니다. 연결되면 계정 메뉴에 각 구독 창의 남은 시간이 표시됩니다 — 5시간 창과 주간 창 — 따라서 긴 실행이 한도에 부딪히기 전에 미리 확인할 수 있습니다.

시작하기 전에 알아둘 세 가지가 있습니다:

• Free 및 유료 요금제에서 본인 제공업체를 사용할 수 있습니다. 제공업체 계정은 선택한 경로를 지원해야 합니다.
• 무료 ChatGPT 요금제는 Okou를 통해 Codex를 사용할 수 없습니다. Plus 또는 Pro가 필요합니다.
• 모델이 어떤 경로를 사용하든, 도구 호출, 생성, 저장은 여전히 Okou 크레딧으로 청구됩니다. 구독은 생각하는 비용을 커버할 뿐, 실제 수행 비용을 커버하지 않습니다.

채팅 작성기 옆의 모델 선택기는 모델을 선택할 뿐이며, 정책이 그 모델에 할당한 경로를 덮어쓰지 않습니다. 또한 모델은 에이전트나 워크플로가 아니라 채팅 스레드에 속합니다. 모델를 참고하세요.

2. 자신의 기술을 워크플로로 옮기기

여러분이 skill이라고 부르는 것은 Okou에서는 workflow입니다. 적용 시점을 설명하는 설명, 작업 방법을 설명하는 지시사항, 그리고 옆에 함께 묶는 선택적 파일로 이루어진 이름 있는 절차입니다. 여러분이 이미 작성한 SKILL.md는 거의 한 줄 한 줄 그대로 워크플로 지시사항입니다.

가장 빠르게 옮기는 방법은 채팅으로 넘기는 것입니다. 다시 작성할 필요도, 무언가를 실행할 필요도 없습니다:

• 파일을 그대로 넣으세요. SKILL.md를 체크리스트, 템플릿, 참조 파일과 함께 채팅으로 바로 드래그하세요.
• 또는 Okou에 링크를 주세요. 기술 폴더의 GitHub URL을 붙여넣으면 Okou가 전체를 직접 읽습니다.

그다음, 어떻게 처리하길 원하는지 말하세요:

"여기 Claude Code에서 사용하는 기술이 있습니다. 이 워크스페이스에서 이를 바탕으로 개인용 워크플로를 만들어 주세요. 절차는 유지하되, 로컬 파일 경로와 셸 단계는 커넥터로 바꾸고, 아직 도달할 수 없는 부분도 알려 주세요."

Okou가 파일을 읽고, 이름·설명·지시사항 초안을 작성한 다음, 저장하기 전에 결과를 보여줍니다.

옮길 때 함께 고쳐 둘 네 가지 차이

• My Okou의 워크플로는 워크스페이스에 있습니다. 개인용 워크플로는 사용자 개인의 것이며, 공개 워크플로는 워크스페이스 내에서 공유됩니다. Legacy Workflows는 하나의 에이전트에 계속 연결되어 있습니다. 실행은 자신의 연결된 계정과 권한을 사용하며, 로컬 셸의 접근 권한은 그대로 이어지지 않습니다. 도구를 사용할 수 없을 때는 실제 연결과 명시된 권한을 확인하세요.
• 이름은 소문자 slug입니다 — triage-bug-report, 2에서 64자. 워크플로가 사용 가능한 채팅에서 /triage-bug-report로 명시적으로 호출하거나, 작업을 설명해 Okou가 설명을 기준으로 매칭하게 할 수 있습니다. 정확한 설명이 있어야 워크플로가 자동으로 실행됩니다.
• 새 워크플로는 기본적으로 비공개입니다. 이를 워크스페이스에 공개로 만드는 것은 저장의 부수 효과가 아니라 의도적인 단계입니다. My Okou에서는 같은 이름의 비공개 워크플로가 공개 버전보다 우선합니다. Legacy Agents에서는 소유 에이전트의 공개 범위도 확인하세요.
• 자격 증명은 따라가지 않습니다. 로컬 skill에 있던 환경 변수나 키는 대신 커넥터가 되므로, 비밀은 플랫폼에 남고 모델의 손이 닿지 않습니다. 기본 제공 커넥터가 맞지 않으면, 지시사항에 키를 붙여넣는 대신 사용자 지정 커넥터를 만드세요.

그대로 이어지는 한 가지가 있습니다: 보조 파일입니다. 템플릿, 체크리스트, 브랜드 가이드라인, 참조 데이터는 여러분의 SKILL.md 옆에 있던 것과 같은 방식으로 워크플로에 첨부됩니다.

개인 Instructions와 작업 방법을 분리하기

기술은 워크플로가 됩니다. My Okou에서는 개인 선호 사항을 Settings → Personal → My Okou → Instructions에 두며, 이 워크스페이스에서 오직 본인에게만 적용됩니다. 재사용 가능한 팀 규칙과 작업 방법은 워크스페이스 워크플로에 속합니다. 개인 Instructions를 저장하면 이미 진행 중인 작업이 아니라 Okou가 다음에 시작하는 작업에 영향을 줍니다. Legacy Agents에서는 대신 선택한 에이전트의 Instructions를 편집하세요.

Legacy Agents 전용:

무언가를 저장하기 전에, 개인 선호 사항과 재사용 가능한 절차를 분리하도록 Okou에 요청하세요. 개인 Instructions는 워크스페이스 정책이 되지 않으며 계정 권한을 변경할 수 없습니다.

3. 그런 다음 로컬 CLI에는 없는 부분을 사용하세요

모델 경로와 절차가 준비되면, 나머지 Okou는 노트북으로는 할 수 없는 부분입니다:

• 커넥터 — 에이전트가 읽고 쓸 수 있는 승인된 서비스로, 자격 증명은 네트워크 경계에 보관되고 모든 호출은 실행 로그에 표시됩니다. 이는 쉘 프로필에 쌓여 있던 개인 액세스 토큰들을 대체합니다.
• 사용자 지정 커넥터 — 기본 제공 커넥터가 없는 내부 API용입니다. 관리자가 HTTPS 접두사와 인증을 한 번 등록합니다. 워크스페이스에서 이 기능이 활성화되어 있다면, Streamable HTTP MCP 엔드포인트도 같은 방식으로 등록할 수 있으므로, 이미 Claude Code에 노출해 둔 서버도 여기에서 접근할 수 있습니다.
• 동시 실행 — 두 번째 터미널 탭을 열어 두었다는 사실을 기억해야 하는 대신, 워크스페이스 차원에서 늘릴 수 있는 기능입니다. 긴 작업이 짧은 작업을 막지 않습니다.
• 자동화 — 일정, 새 이메일, 병합된 풀 리퀘스트, 캘린더 이벤트, 웹훅처럼 워크플로에 연결된 트리거입니다. 절차를, 실행해야 할 일을 매번 기억해야 하는 명령이 아니라 팀원처럼 바꾸는 부분이 바로 이것입니다.
• 지침 및 경험 모드 — My Okou용 개인 선호 사항이며, 별도의 레거시 에이전트 프로필 안내도 유지됩니다.
• 통합 — 하나의 머신에서 하나의 터미널이 아니라 Slack, Telegram 또는 웹에서 같은 에이전트에 접근할 수 있게 해 줍니다.

4. dotfile에 넣어 두는 대신 공유하기

로컬 설정과의 진짜 차이점은, 다른 사람이 여러분이 만든 것을 사용할 수 있다는 점입니다. 터미널을 열어 보지 않을 사람들까지도 포함해서 말이죠.

• My Okou: 검토된 공개 워크플로를 공유하세요. Legacy Agents: 그 소유 에이전트도 공개로 만드세요.
• 그렇게 하기 전에 지시사항과 파일에서 자격 증명과 일회성 데이터를 제거하세요.
• Settings → People → Add member에서 팀원을 초대하며, 기본 역할은 Member입니다. 팀원 초대를 참고하세요.
• 각 멤버는 자신의 계정과 자신의 Claude 또는 Codex 구독을 연결합니다. 누구도 로그인 정보를 공유하지 않습니다.

신규 사용자용의 3단계부터 6단계까지는 개인 Instructions(또는 레거시 에이전트 설정), 워크플로 공유, 예약 실행을 더 자세히 다룹니다. 메커니즘은 같고, 시작점만 달랐습니다.

다음에 갈 곳

• 모델 — 라우팅, 자신의 구독, 그리고 각 모델이 드는 비용.
• 워크플로 — 구조, 소유권, 공개 범위, 그리고 Okou가 하나를 선택하는 방식.
• 자동화 — 일정, 이메일, GitHub, 캘린더, 웹훅 트리거.
• 권한 — 에이전트가 무엇을 만질 수 있는지, 그리고 이를 어떻게 더 좁힐지.
• 사용자 지정 커넥터 — 기본 제공 커넥터가 없는 내부 API용.