Orca의 Codex

Codex은 OpenAI의 에이전트 CLI입니다. Orca의 Codex 통합은 앱에서 가장 심층적인 통합 중 하나입니다. 사용, 핫스왑 및 다시 시작은 모두 계정 ID를 유지합니다.

설정

OpenAI의 문서에 따라 Codex을 설치합니다.
아무 터미널에서나 로그인하세요.
Orca은 계정 및 자격 증명에 대해 ~/.codex를 읽습니다.

출시

에이전트 콤보 상자에서 Codex(Codex 에이전트)을 선택합니다. Orca는 작업 트리를 cwd로 사용하여 codex을 시작하고 현재 선택된 계정을 통해 인증을 라우팅합니다.

계정 핫스왑

많은 Codex 사용자는 속도 제한을 늘리기 위해 여러 계정을 실행합니다. Orca의 계정 전환기는 재로그인이나 구성 편집 없이 활성 계정을 교체합니다. 핫스왑 Codex 계정을 참조하세요.

시스템 기본 계정과 추가 계정

**System default(시스템 기본값)**는 실제 ~/.codex 로그인을 사용합니다(Orca 외부에서 별도로 실행한 codex가 사용하는 것과 동일한 홈입니다). Orca가 관리하는 추가 계정은 Orca의 계정 데이터 아래에 각각 전용 홈을 두므로 자격 증명과 롤아웃이 격리됩니다. 새 Codex 실행은 활성 계정을 따르지만, 이미 실행 중인 세션은 다시 시작할 때까지 시작할 때 사용한 홈을 유지합니다.

Codex 0.157 이상

Orca에서 관리하는 계정 홈 경로가 Codex의 백그라운드 데몬 소켓에서 사용하기에 너무 길면, Orca는 해당 홈에서 데몬을 비활성화하여 Codex가 시작될 수 있게 합니다. 이는 에이전트 선택기에서 Codex를 시작하거나 Orca 터미널에서 codex을 입력하는 경우 모두에 적용됩니다. Orca는 계정 데이터를 그대로 유지하며 시스템의 ~/.codex/config.toml을 변경하지 않습니다.

영향을 받는 홈에서는 codex agents와 데몬 기반 재개 또는 계속 기능을 사용할 수 없습니다. Codex에서 계속 path must be shorter than SUN_LEN 오류를 보고하면 문제 해결을 참조합니다.

각 Codex 터미널은 자체 서버에서 실행됩니다

Codex 0.157 이상에서는 각 Codex 탭이 Orca 터미널에서 기본적으로 자체 백그라운드 서버를 실행합니다. 따라서 탭마다 에이전트 상태가 정확하게 유지되며, Codex 탭 하나를 닫아도 다른 탭의 연결이 끊기지 않습니다. 이 동작은 새 터미널에 적용됩니다. 업데이트할 때 이미 열려 있던 터미널은 다시 열 때까지 이전 동작을 유지합니다.

절충점: 탭별 서버를 사용하면 Codex의 공유 서버 기능(백그라운드 실행, codex agents, Codex 데스크톱 앱 또는 IDE에서 연 세션)이 Orca에서 시작된 세션을 인식하지 못합니다.
대신 Codex의 서버를 공유하려면 새 터미널을 열기 전에 **Settings → Agents → Run each Codex terminal on its own server(설정 → 에이전트 → 각 Codex 터미널을 자체 서버에서 실행)**를 끄거나 ORCA_CODEX_ISOLATE=0을 설정합니다(예: 셸 시작 파일의 export ORCA_CODEX_ISOLATE=0). 그러면 공유 서버에서 Codex의 에이전트 개요를 다시 사용할 수 있습니다.
직접 시작한 Codex가 공유 서버에 연결되면 Orca가 해당 탭 상단에 알림을 표시합니다. 알림의 **Fix(수정)**를 선택하면 공유가 꺼지며, 업데이트 전에 열린 탭에서는 대신 새 터미널을 열도록 안내합니다.

중첩된 Task 하위 에이전트

Codex가 Task 하위 에이전트를 생성하면 Orca는 작업 트리 에이전트 목록과 에이전트 대시보드에서 이를 상위 에이전트 아래의 하위 행으로 표시할 수 있습니다. 펼침 화살표를 열어 각 하위 에이전트를 확인할 수 있으며, 하위 에이전트를 클릭하면 상위 터미널에 포커스가 맞춰집니다(하위 에이전트에는 별도 창이 할당되지 않습니다).

다른 에이전트로 인계

에이전트 터미널의 헤더나 컨텍스트 메뉴에서 **Hand Off to Another Agent(다른 에이전트로 인계)**를 선택합니다. Orca는 동일하거나 다른 CLI로 새 에이전트 세션을 시작하고 이전 대화 기록 또는 캡처한 컨텍스트에서 범위를 제한한 인계 프롬프트를 주입합니다. 원래 세션은 그대로 유지되며, 이는 codex resume이 아닙니다.

칩 재시작

Codex이 종료되면 다시 시작 칩이 동일한 계정으로 에이전트를 다시 시작합니다. 세션 중에 계정을 교환하고 새 계정으로 다시 시작하려면 먼저 계정 전환기를 사용한 다음 다시 시작하세요.

사용량 및 속도 제한

Orca은 활성 계정에 대한 로컬 Codex 사용 상태를 읽고 이를 상태 표시줄에 표시합니다. 사용량 및 속도 제한 추적을 참조하세요.

Windows(WSL)의 Codex

Windows에서 Codex는 macOS 및 Linux와 동일한 실제 ~/.codex 홈에서 실행됩니다. 업데이트 후 Codex 터미널이 처음 나타날 때 Orca는 일회성 알림을 표시합니다. Codex가 폴더 신뢰 또는 명령 승인을 다시 요청할 수 있으며, Orca 안에서만 추가한 MCP 서버는 다시 추가해야 합니다. 이미 열려 있던 Codex 터미널은 다시 열 때까지 Orca의 이전 홈에서 계속 실행됩니다.

Windows에서 Orca는 호스트 설치 또는 WSL 배포판에서 Codex를 실행할 수 있습니다. 계정 전환기에서 WSL 호스팅 Codex 계정을 추가하면 Orca가 배포판 내부의 ~/.local/share/orca/codex-accounts/<id>/home 아래에 격리된 계정 홈을 만들고, 인증 정보를 읽을 수 있도록 호스트의 \\wsl.localhost\<distro>\... 경로에 다시 매핑하며, 시작·핫스왑·속도 제한 조회를 선택한 배포판을 통해 라우팅합니다. 대상 배포판에 Codex가 설치되어 있지 않으면 Add account(계정 추가) 대화 상자에 바이너리가 없는 배포판을 알려 주는 조치 가능한 오류 메시지가 표시됩니다.