Orkas Orkas
블로그 가이드
가이드

Claude Code와 Codex를 함께 실행하는 방법 — 채팅 하나로 둘 다 조율하기

Claude Code와 Codex는 각자 잘하는 일이 다릅니다. 터미널과 git worktree를 쓰는 수동 방식, 그리고 하나의 채팅에서 둘을 실행하는 Orkas Commander를 쓰는 더 간단한 방식으로 함께 사용하는 방법을 소개합니다.

2026년에 AI로 코드를 작성한다면 아마 두 도구 모두, 즉 Claude Code와 OpenAI Codex를 곁에 두고 있을 것입니다. 둘 다 터미널 기반 코딩 에이전트이므로 다음과 같은 구도로 보기 쉽습니다. Claude Code와 Codex, 어느 것이 더 좋을까? 실제로 더 유용한 질문은 다음입니다. Claude Code와 Codex를 어떻게 함께 실행할까, 두 터미널 사이에서 맥락을 복사하는 인간 메시지 전달자가 되지 않으면서 말입니다.

짧게 답하면 가능하며 방법은 두 가지입니다. 터미널 두 개, 공유 맥락 파일, git worktree를 사용하는 수동 방식은 지금도 작동합니다. 더 간단한 방식은 둘 앞에 조율자 하나를 두는 것입니다. 이 글에서 둘 다 다룹니다.

핵심 요약 하나의 채팅에서 두 CLI를 함께 Orkas는 자신의 기기에서 자신의 키로, 같은 대화 안에서 Claude Code와 Codex를 실행합니다. 다음도 참고하세요. Orkas와 Claude Code 비교.
Orkas 무료 다운로드

Claude Code와 Codex: 각각 무엇을 더 잘할까요

어느 하나가 다른 하나를 압도하지는 않습니다. 특성이 다르며 함께 실행한다는 것은 각자의 강점을 활용한다는 뜻입니다.

  • Claude Code는 대체로 기존 코드베이스 이해에 강합니다. 낯선 코드 읽기, 아키텍처 설명, 여러 파일의 신중한 편집, 실제로 무엇이 망가질지 살펴보는 변경 사항 검토입니다.
  • Codex는 대체로 범위가 명확한 작업의 빠른 실행에 강합니다. 새 기능의 기본 틀 만들기, 상용구 코드 생성, 명확히 정의된 티켓의 빠른 처리입니다.

따라서 "어느 것이 더 좋은가"는 잘못된 질문입니다. 흥미로운 워크플로는 한쪽으로 계획과 검토를 하고 다른 쪽으로 실행하는 것이며, 이상적으로는 서로의 실수도 잡아내는 것입니다.

수동 방식: 터미널 두 개, 공유 맥락 하나

두 도구 모두 CLI로 설치되며 어떤 프로젝트 디렉터리에서도 실행됩니다.

npm install -g @anthropic-ai/claude-code   # then: claude
npm install -g @openai/codex               # then: codex

두 도구를 같은 프로젝트에서 실행하는 요령은 공통 기준 정보를 주고 서로 방해하지 않게 하는 것입니다.

  • 저장소에 지속적으로 갱신하는 PROJECT_CONTEXT.md 파일을 두고 두 에이전트가 모두 읽고 업데이트하게 하세요. 그러면 한쪽이 작성한 계획을 다른 쪽도 볼 수 있습니다.
  • 또한 git worktree를 사용하면 각 에이전트가 자신의 디렉터리에서 자신의 브랜치로 작업하므로 같은 파일을 두고 충돌하지 않습니다.
git worktree add ../feature-claude feature/claude
git worktree add ../feature-codex  feature/codex
# run `claude` in one, `codex` in the other; review and merge the diffs

이 방식은 작동합니다. 다만 문제는 사용자 자신이 통합 계층이라는 점입니다. Claude Code의 계획을 Codex에 붙여 넣고, Codex의 변경 사항을 Claude Code에 다시 붙여 넣으며, 결과를 직접 조정해야 합니다.

실제로 잘 작동하는 워크플로: 계획 → 실행 → 교차 검토

사람들이 가장 신뢰할 만하다고 여기는 패턴은 두 에이전트로 구성한 작은 작업 라인입니다.

1. Claude Code  — 코드를 읽고 계획 작성(파일, 단계, 위험 요소)
2. Codex        — 계획을 빠르게 구현하고 diff 생성
3. Claude Code  — Codex의 diff 검토: 정확성, 경계 사례, 스타일
4. 검토에서 지적된 항목을 반복해서 수정

독립적인 두 모델이 서로의 작업을 검토하면 혼자 자기 숙제를 채점하는 에이전트가 쉽게 놓치는 유형의 실수를 잡아냅니다. 그 대가는 조율 오버헤드이며, 바로 그 부분이 자동화할 가치가 있습니다.

불편한 점: 사용자가 조율자입니다

위의 모든 방법은 작동하며 일회성 작업에는 괜찮습니다. 하지만 매일 하다 보면 수동 방식은 어느새 사용자 자신을 조율자로 만듭니다. 각 작업을 맞는 에이전트로 보내고, 맥락을 전달하고, 두 변경 사항을 조정하며, 누가 무엇을 했는지 머릿속에 기억해야 합니다. 이것은 실제 노동이며 코딩 에이전트가 두 개든 스무 개든 같은 조율 문제입니다.

Orkas가 Claude Code와 Codex를 함께 실행하는 방법

Orkas는 이런 수동 작업을 내장 기능으로 바꾸는 오픈 소스 로컬 우선 데스크톱 앱입니다. 로컬 CLI 코딩 에이전트인 Claude Code, Codex, OpenClaw, OpenCode, Hermes를 실행하고 하나의 채팅에서 조율할 수 있습니다. 설정은 간단합니다.

1. 내 컴퓨터에 `claude`와 `codex` CLI를 설치하고 로그인
2. Orkas에서: 새 채팅 → 에이전트 추가 → "외부" 탭 → CLI 선택
   (Orkas는 PATH에서 감지한 CLI만 표시합니다)
3. 두 번 반복 — Claude Code 에이전트 하나, Codex 에이전트 하나
4. 필요하면 에이전트별 프로젝트 디렉터리와 모델 설정
   (모델을 비워 두면 각 CLI의 기본값을 사용합니다)

Orkas는 모델을 다시 구현하거나 감싸지 않습니다. 이미 설치된 실제 claudecodex 바이너리를 하위 프로세스로 실행하며, 이미 로그인한 자격 증명을 사용합니다. 키가 아니라 조율을 관리합니다.

Commander 하나로 두 에이전트를 병렬 실행

이제 대화 하나에 전문 에이전트 두 개가 있습니다. 리드 에이전트인 Commander에게 요청하면 작업을 나눠 전달합니다. "이해와 계획"은 Claude Code에, "빠른 구현"은 Codex에 맡길 수 있습니다. Commander가 한 턴에서 여러 작업을 전달하면 Orkas는 이를 동시에 몇 개씩 실행합니다. 사용자가 터미널을 오가는 대신 Claude Code와 Codex가 동시에 작업합니다. 어느 에이전트든 직접 @멘션할 수도 있습니다. 이 조율 방식은 다음 글에 정리했습니다. 멀티 에이전트 오케스트레이션의 실제 활용.

일반 터미널 두 개로는 얻을 수 없는 이점도 있습니다. Orkas가 Claude Code나 Codex를 실행할 때 로컬 브리지를 통해 자기 자신도 다시 노출합니다. 코딩 에이전트는 실행 중에 저장소 파일뿐 아니라 Orkas에 연결된 도구와 지식, 즉 GitHub, Notion, Google Workspace 커넥터와 지식 베이스에도 접근할 수 있습니다.

제대로 설정해야 할 몇 가지

  • CLI와 로그인은 직접 준비합니다. Orkas는 claudecodex를 실행하며 API 키나 로그인을 관리하지 않습니다. 먼저 최신에 가까운 버전(대략 Claude Code 2.0+ 및 Codex 0.100+)을 설치하고 로그인하세요.
  • 안전한 병렬 실행을 위해 서로 다른 디렉터리를 지정하세요. Orkas는 각 에이전트를 별도의 git worktree로 격리하지 않습니다. 둘이 같은 폴더를 가리키고 동시에 실행되면 같은 파일을 동시에 편집합니다. 실제 병렬 작업을 하려면 각자 별도의 프로젝트 디렉터리나 저장소를 지정하세요.
  • 자율적으로 수행할 범위는 사용자가 고릅니다. 각 CLI 에이전트는 AI 팀 > 에이전트 > 런타임 설정 > 권한 수준에서 설정한 권한으로 실행됩니다. CLI 기본값 사용, 권한 요청 또는 전체 액세스를 선택할 수 있습니다. CLI 기본값 사용은 CLI 자체의 권한 설정을 유지합니다. 권한 요청은 승인 요청을 활성화하며, 전체 액세스는 CLI의 승인 메시지를 건너뜁니다. 커넥터 권한은 별도입니다. 해당 작업에 대해 그 연결을 이미 승인했거나 Orkas에서 신뢰 모드를 켠 경우가 아니면 민감한 동작 전에 승인을 요청합니다.

그렇다면 Claude Code인가요, Codex인가요?

둘 다입니다. 이해, 아키텍처, 검토에는 Claude Code를 쓰고 범위가 명확한 작업의 빠른 실행에는 Codex를 쓰세요. Commander 하나가 둘 사이를 배분하게 하여 사용자는 작업을 옮기는 대신 방향을 잡으세요. 승자를 고르지 않고 함께 실행하는 이유가 바로 이것입니다.

로컬 우선은 저장소와 키가 자신의 기기에 남는다는 뜻입니다. 다음을 참고하세요. 로컬 우선 AI란 무엇인가요? 터미널 두 개를 오가는 일을 생략하려면 Orkas를 다운로드하고 Commander 하나에 Claude Code와 Codex를 모두 연결하세요.

Claude Code와 Codex 함께 사용하기: 자주 묻는 질문

Codex와 Claude Code를 함께 사용할 수 있나요?

네. 세션 상태가 별개인 독립 CLI이므로 같은 저장소에 둘 다 실행하는 데 제약은 없습니다. 중요한 것은 같은 파일을 동시에 편집하지 않게 하는 것입니다. git worktree를 사용하거나 Commander 하나가 각 작업을 한 에이전트에 맡기게 하세요.

Claude Code와 Codex는 서로 대화하나요?

직접 대화하지는 않습니다. Claude Code는 CLAUDE.md를, Codex는 AGENTS.md를 읽으며 어느 쪽도 다른 쪽 세션을 감시하지 않습니다. 공유할 내용은 둘 다 쓰는 파일이나 한쪽 결과를 다른 쪽 프롬프트로 전달하는 조율자를 거쳐야 합니다.

Codex와 Claude Code를 함께 쓰는 가장 좋은 방법은 무엇인가요?

파일이 아니라 강점에 따라 나누세요. Claude Code가 계획하고 검토하게 하고, Codex가 범위가 정해진 변경을 실행하게 한 다음, 다른 쪽이 변경 사항을 읽게 하세요. 이런 검토는 어느 한 에이전트를 두 번 실행하는 것보다 더 많은 문제를 잡습니다.

Codex와 Claude Code를 어떻게 협업하게 하나요?

수동으로는 터미널 두 개, 공유 명세 파일, 편집 충돌을 막을 에이전트별 git worktree가 필요합니다. Orkas에서는 둘 다 Commander 하나 아래의 로컬 세션으로 실행되며, Commander가 작업을 배분하고 두 변경 사항을 같은 채팅으로 모읍니다.

같은 프로젝트에서 Claude Code와 Codex를 동시에 실행할 수 있나요?

병렬 실행할 수 있지만 둘이 동시에 같은 폴더를 가리키게 하지 마세요. 같은 파일을 동시에 편집하게 됩니다. 각 에이전트에 별도의 git worktree나 프로젝트 디렉터리를 지정하세요. Orkas가 에이전트를 별도 worktree로 격리해 주지는 않으므로 어느 방식이든 이 단계는 직접 해야 합니다.

터미널 하나에서 Claude Code와 Codex를 실행할 수 있나요?

두 대화형 세션으로는 안 됩니다. 각 CLI에 별도의 TTY가 필요합니다. 실제로는 tmux로 터미널을 나누거나 조율자가 둘을 로컬 세션으로 실행하고 출력을 한곳에 모으게 합니다. Orkas는 두 번째 방식을 씁니다. 두 CLI가 Commander 하나 아래에서 실행되고 같은 채팅으로 보고합니다.

Claude Code와 Codex 외의 도구도 조율할 수 있나요?

네. Orkas는 Claude Code, Codex, OpenCode, OpenClaw, Hermes라는 로컬 CLI 에이전트 다섯 가지를 실행합니다. 설치한 도구가 표시되며 Commander 하나가 같은 프로젝트에서 조합해 사용할 수 있습니다.

Claude Code와 Codex 모두 유료 요금제가 필요한가요?

각 CLI는 자체 로그인과 자체 요금제를 사용합니다. Orkas는 이미 보유한 바이너리만 실행하며 어느 쪽의 API 키, 로그인, 결제도 관리하지 않습니다.