AI 프로필의 역할은 다음에서 실행될 수 있습니다:자신의 컴퓨터에서 작동하는 코딩 에이전트모델 CoRoid가 호출하는 방식 대신 말입니다. 해당 에이전트는 설정된 대로 당신의 계정으로 로그인하여 그곳에서 역할에 따른 추론을 수행합니다. CoRoid는 역할에 필요한 도구를 제공하고 워크플로우의 나머지 부분—작업 내용, 검사 및 승인 단계, 발생한 사항에 대한 기록—을 관리합니다.
포함되는 내용
- 결정 엔진을 제외한 프로필의 모든 역할:해당 아키텍트및 코디네이터, 개발자, QA, 리뷰어, 웹 테스터, 번역가 등도 포함됩니다. 결정 엔진은 에이전트로 실행되지 않습니다. 이는 허용된 답변 각각의 확률을 결정 모델에 요청하는 방식이며, 코딩 에이전트는 이러한 결과를 제공하지 못합니다.
- **네 가지 에이전트:**Codex와 OpenCode, 그리고 일부 조직에 한해 현재는 Claude Code와 Cursor도 지원됩니다. 각 에이전트는 제공업체의 플랜에 따라 당신의 계정에서 실행됩니다(내 에이전트 플랜).
- 작업이 실행되는 모든 방식코디네이터 모드에서는 코디네이터와 그가 할당한 하위 작업들이 다른 역할과 마찬가지로 에이전트에서 실행됩니다.
내 에이전트 플랜
에이전트는 당신의 계정으로 로그인하여 제공업체의 플랜에 따라 작동합니다: Claude Code는 Anthropic, Codex는 OpenAI, Cursor는 Cursor사의 플랜을 사용하며, OpenCode의 경우 당신이 설정한 제공업체를 이용합니다. CoRoid는 해당 로그인 정보를 확인할 수 없으며, 누구의 플랜도 재판매하거나 공유하지 않습니다. 각 사용자는 자신의 컴퓨터를 연결하며, 에이전트는 그들이 시작한 작업을 처리합니다.
특정 플랜의 이용 약관에서 다른 제품을 통해 해당 서비스를 사용할 수 있는지 여부와 적용 범위는 제공업체와의 계약에 따릅니다. 이는 제공업체별로, 개인용 및 기업용 플랜별로 다르며, 사용량에 따라 달라질 수 있고 변경될 수도 있습니다. 플랜의 이용 약관을 확인하고, 명확하지 않은 부분은 제공업체에 문의하십시오.
에이전트에 역할을 할당하는 조직은 구성원의 플랜도 동일하게 확인해야 합니다. 조직 정책에 따라 승인된 이용 약관을 충족하는 에이전트만 허용될 수 있습니다(조직에서 허용하는 항목).
연결 방법
사용자의 컴퓨터
CoRoid 커넥터
오픈 소스로 제공됩니다. 새로운 빈 디렉터리에서 에이전트를 실행한 뒤 작업이 끝나면 자동으로 종료됩니다.
귀사의 코딩 에이전트
사용자가 직접 로그인하여 사용하는 에이전트로, 자체 도구는 비활성화된 상태입니다.
- 1작업을 요청합니다. 각 요청은 최대 25초간 유지되며, 커넥터는 3초마다 에이전트의 응답 내용을 보고합니다.
- 2해당 역할의 도구들을 호출합니다. 이번 작업에만 사용되는 토큰으로, 작업이 끝나면 즉시 효력을 잃습니다.
- 3자신의 모델에 문의합니다. CoRoid 없이도 동일하게 작동합니다. CoRoid는 해당 로그인 정보를 절대 확인할 수 없습니다.
CoRoid
오케스트레이터
작업을 시작한 사람의 컴퓨터에 해당 역할의 작업을 할당합니다(1).
해당 역할의 도구들
작업용 샌드박스에서 실행되며, 사용자의 코드는 그곳에 보관됩니다(2).
에이전트의 제공자
사용자의 로그인 정보를 바탕으로, 사용자가 이용 중인 요금제에 따라 에이전트의 모델 요청에 응답합니다(3).
컴퓨터 내부로는 아무것도 접근할 수 없습니다. 커넥터는 포트를 열지 않으며, 파일을 전송하거나 자체 명령을 실행하지 않습니다.
컴퓨터에는 에이전트에 대한 사용자의 로그인 정보와 작업 중에 에이전트가 보관하는 데이터만 남습니다.
컴퓨터는 CoRoid와 다음을 통해 연동됩니다:CoRoid 커넥터, 즉 설치하고 실행하는 작은 오픈소스 프로그램입니다. 모든 연결은 컴퓨터에서 시작됩니다: 커넥터가 CoRoid에 작업을 요청하면, 에이전트는 작업의 샌드박스 내에서 역할에 맞는 도구를 호출하고, 당신의 계정으로 로그인하여 제공업체의 모델에 답변을 요청합니다. 커넥터는 포트를 열지 않으며 컴퓨터의 파일을 전송하지도 않습니다.커넥터의 보안는 커넥터의 기능과 제한 사항, 그리고 릴리스 버전을 확인하는 방법을 설명합니다.
컴퓨터 연결하기
-
컴퓨터에 에이전트를 설치하고 직접 사용할 때와 같이 로그인하십시오.
-
macOS 또는 Linux에서는 Homebrew로 커넥터를 설치하세요:
brew install coroid-ai/tap/coroid-connector또는 Node.js 20 이상이 설치된 환경에서는 npm으로 설치할 수 있습니다:
npm install --global @coroid/connector -
Codex나 Claude Code의 경우 에이전트를 추가하세요:
coroid-connector add codex(또는add claude). 이렇게 하면 에이전트의 ACP 어댑터가 설치되며, 에이전트 자체 복사본(약 350MB)이~/.coroid/connector로 설치되고, 커넥터가 해시로 잠근 패키지에서 가져옵니다. OpenCode와 Cursor는 별도로 추가할 필요가 없습니다. CoRoid는 당신이 직접 설치한 버전을 사용합니다. -
열기설정 → 연결 → 내 컴퓨터에서 표시된 명령을 실행하세요(
coroid-connector --api …). 브라우저가 열리면 조직용으로 해당 컴퓨터를 승인하십시오. 바로 앞서 시작한 커넥터만 승인하세요.
그러면 커넥터는 중단될 때까지 계속 실행되며 CoRoid에 작업을 요청합니다.내 컴퓨터에는 연결된 컴퓨터가 목록으로 표시되며, 커넥터가 발견한 에이전트와 각 버전 정보가 나타납니다. 에이전트는 CoRoid가 테스트한 버전에서만 '준비 완료'로 표시되며, 다른 버전에서는 표시되더라도 사용되지 않습니다.
coroid-connector status에서는 컴퓨터에서의 동일한 정보와 각 에이전트에 할당된 모델이 표시됩니다.
컴퓨터 정보는 오직 당신만 볼 수 있습니다.연결 끊기를 실행하면 컴퓨터의 로그인이 종료되고, 커넥터는 1분 내에 중단됩니다.
에이전트에 역할 할당하기
조직 소유자는 맞춤형 프로필에서 다음 경로를 통해 이 작업을 수행합니다:설정 → AI 프로필(AI 프로필).
- 프로필 세부 정보를 엽니다. 역할 필드의 첫 번째 항목에는 다음이 표시됩니다:자신의 컴퓨터에서 실행: 조직에서 제공하는 에이전트 목록과, 각 에이전트를 사용할 수 있는 컴퓨터가 있는지 여부가 함께 표시됩니다.
- 에이전트를 선택하세요. 그러면 두 개의 추가 필드가 나타납니다:
- 모델을: 이 역할에 대해 에이전트가 사용할 모델로, 연결된 머신에서 보고하는 모델 중에서 선택됩니다.머신에 설정된 대로에이전트는 소유자가 설정한 모델을 그대로 사용합니다.
- 연결된 머신이 없는 경우: 작업을 수행할 머신이 없을 때 해당 역할을 실행하는 모델로, 이는 역할에 할당된 모델입니다.
- 저장.
첫 번째 필드에서 모델을 다시 선택하면 에이전트가 변경되고, 그에 맞는 모델도 함께 적용됩니다.
작업이 실행될 때 어떤 일이 발생하나요?
할당은 조직의 것이며,머신은 사용자의 것입니다.역할이 시작되면, CoRoid는 작업을 시작한 사용자의 머신을 찾습니다:
- 지난 1분 내에 이 조직에 연결된 머신이어야 하며,
- CoRoid가 테스트한 버전에서 할당된 에이전트가 준비되어 있어야 합니다,
- 할당에 모델이 명시되어 있다면 해당 모델을 제공해야 합니다.
해당 머신이 있으면 역할의 작업이 그곳으로 전달됩니다. 없다면 역할은 다음 모델에서 실행됩니다.연결된 머신이 없는 경우, 원래대로 작동합니다. 머신을 기다리지 않습니다. 사용자가 시작하지 않은 작업(이벤트 기반 자동화나 스케줄링된 작업)에는 그러한 머신이 없으므로 해당 모델에서 실행됩니다.
머신에서는 커넥터가 새롭고 비어 있는 디렉터리에서 에이전트를 시작하고, 세션에 하나의 도구 세트를 제공합니다: 이 작업에만 사용되는 CoRoid의 해당 역할용 도구입니다. Developer는 이를 통해 코드를 변경하며, 이는 모델이 하는 방식과 같습니다. QA와 Reviewer는 이를 통해 변경 사항을 평가합니다. 에이전트가 작업하는 동안 작업에 추가된 메시지는 다음 도구 결과와 함께 전달됩니다.
대기 중인 역할은 에이전트로 돌아갑니다.코디네이터는 작업을 Developer, QA, Reviewer에게 할당하고 각자의 응답을 기다립니다. 하위 역할은 코디네이터의 답변을 기다릴 수도 있습니다. 대기가 끝나면 역할은 에이전트로 돌아가며, 지금까지의 대화 내용이 전달됩니다. 머신은 최대 4개의 역할을 동시에 실행할 수 있습니다(커넥터 0.4.0), 따라서 Developer가 시작한 탐색 작업도 함께 실행됩니다.
역할 중간에 머신이 응답을 멈추면, 역할은 동일한 대화를 바탕으로 클라우드 모델에서 계속 진행되며, 발생한 상황이 전달됩니다. 중단된 작업은 에이전트도 중단시킵니다. 역할이 끝나면 에이전트는 중단되고 디렉터리도 삭제됩니다.
머신에 남는 것은 무엇인가요?
커넥터는 역할이 실행된 디렉터리를 삭제합니다. 에이전트가 자체 저장소에 보관하는 작업 내용은 에이전트에 따라 다릅니다:
| 에이전트 | 보관되는 내용 |
|---|---|
| Claude Code | 대화록 없음: 커넥터는 세션 지속 기능을 꺼서 시작합니다 |
| Codex | 각 세션의 대화록이~/.codex/sessions에 포함되며, 읽은 파일도 포함됩니다 |
| OpenCode | 자체 데이터베이스의 세션이~/.local/share/opencode |
| Cursor | 각 세션이 자체 데이터베이스의~/.cursor/acp-sessions |
현재로서는 Codex, OpenCode, Cursor에서는 이를 제어할 수 있는 옵션이 제공되지 않습니다. 조직에서 노트북에 코드를 보관하지 않아야 하는 경우, 정책에서 Claude Code만 허용하도록 설정하세요(아래 참조).
조직에서 허용하는 항목
소유자 또는 관리자는설정 → ID 및 접근 권한 → 조직 정책에서 설정하며,사용자 기기에서 실행되는 코딩 에이전트, 모든 요금제에서 적용됩니다:
- 사용자 기기에서 코딩 에이전트 실행 허용이 기능이 비활성화되면 모든 역할은 해당 모델에서 실행되며, 프로필에 이미 할당된 에이전트의 역할도 마찬가지입니다.
- 에이전트별로 하나의 스위치조직에 제공되며, 에이전트가 머신에 보관하는 데이터도 포함됩니다. 모든 에이전트가 활성화되면 나중에 CoRoid가 제공하는 에이전트도 자동으로 활성화됩니다.
AI 프로필 양식에는 정책에서 허용하는 에이전트만 표시되며, 역할을 다른 에이전트에 새로 할당할 수는 없습니다. 정책이 변경되기 전에 할당된 역할은 기존 할당을 유지하며, 양식에는 해당 모델에서 실행된다고 표시됩니다. 프로젝트의 정책은 조직의 정책을 더 제한할 수는 있지만 넓힐 수는 없습니다.
에이전트가 할 수 있는 작업과 할 수 없는 작업
- 오직 CoRoid의 도구만 사용할 수 있습니다.각 에이전트의 자체 도구(셸, 파일 편집, 웹 검색, 자체 MCP 서버 및 커넥터)는 해당 에이전트가 제공하는 방식에 따라 세션 동안 비활성화되며, 다른 것을 사용하려는 요청은 거부됩니다.
- 머신의 데이터는 전혀 사용할 수 없습니다.에이전트는 사용자의 체크아웃 영역에서 작업하지 않으며 머신의 파일에도 접근할 수 없습니다. CoRoid도 머신에 접근할 수 없으며, 커넥터는 단지 CoRoid에 작업을 요청하고 에이전트의 응답을 전달할 뿐입니다.
- 동일한 검증 절차가 적용됩니다.에이전트가 변경한 내용은 모델의 작업과 동일한 QA, 리뷰, 게이트 및 단계 제한을 거칩니다.
- 전송되는 내용역할에 필요한 정보(해당 코드, 요구사항, 도구 실행 결과, 첨부파일의 이미지 등)는 머신으로 전송된 뒤, 해당 에이전트가 로그인한 상태에서 에이전트 제공업체로 전달됩니다. 조직에서 특정 제공업체와 코드를 함께 보관해야 하는 경우, 에이전트에 역할을 할당하기 전에 이 점을 반드시 고려하세요.
비용 및 기록
에이전트의 추론 과정에 따른 비용은 작업을 수행한 사용자의 머신에 귀속되며, CoRoid의 모델 사용 비용과는 무관합니다. 작업 활동 내역에는 다음과 같은 실행 기록이 표시됩니다.Ada의 노트북에서 실행된 Codex(gpt-6-luna) · 사용량 측정 대상 아님, 절대 0개의 토큰으로 처리되지 않습니다. 만약 역할이 클라우드 모델에서 실행된다면, 해당 부분은 일반적으로 사용량 측정 대상이 됩니다.
CoRoid는 머신에 할당한 각 작업 내용을 모두 기록합니다: 어떤 머신과 에이전트를 사용했는지, 어떤 모델인지, 작업이 어떻게 종료되었으며 도구 호출 횟수는 몇 번인지 등입니다.
내보내기 및 가져오기
할당된 에이전트와 그 모델은 설정 내보내기 시 프로필과 함께 저장되며, 정책에 따른 에이전트 선택 내용은 조직 정책과 함께 저장됩니다. 로컬 에이전트가 없거나 해당 에이전트를 사용할 수 없거나 정책상 허용되지 않는 조직의 경우, 할당 내용은 클라우드 모델만 포함하여 가져오게 되며 가져오기 과정에서 이 사실이 명시됩니다. 자세히 보기설정 내보내기 및 가져오기.