# 1Code: Claude Code와 Codex를 한 앱에서 실행하는 오픈소스 코딩 에이전트 클라이언트

**URL:** <https://discuss.pytorch.kr/t/1code-claude-code-codex/10811>\
**Category:** 읽을거리&정보공유\
**Tags:** 1code, desktop-app, claude-code, git-worktree, codex, coding-agent\
**Created:** [6월 24, 2026, 7:30오전 UTC](https://discuss.pytorch.kr/t/1code-claude-code-codex/10811 "2026-06-24T07:30:23Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![9bow](https://discuss.pytorch.kr/user_avatar/discuss.pytorch.kr/9bow/32/16301_2.png) [@9bow](https://discuss.pytorch.kr/u/9bow)\
**Post date:** [6월 24, 2026, 7:30오전 UTC](https://discuss.pytorch.kr/t/1code-claude-code-codex/10811/1 "2026-06-24T07:30:23Z")

</div>

![1Code: Claude Code와 Codex를 한 앱에서 실행하는 오픈소스 코딩 에이전트 클라이언트](https://discuss.pytorch.kr/uploads/default/original/3X/3/0/307c61a5bd111b511c2993f9a7792cae5d197f5b.jpeg)

## 1Code 소개

코딩 에이전트를 본격적으로 쓰기 시작하면 도구마다 실행 환경이 갈리는 문제에 부딪힙니다. Claude Code는 터미널에서, Codex는 또 다른 터미널이나 IDE에서 돌리고, 각 세션이 같은 작업 디렉토리를 건드리다 보면 변경 사항이 뒤섞이거나 main 브랜치를 실수로 오염시키기 쉽습니다. 결과를 눈으로 확인하기 전에 에이전트가 무슨 파일을 어떻게 고쳤는지 추적하기도 번거롭습니다.

1Code는 이런 코딩 에이전트들을 **하나의 데스크톱 앱에서 실행하고 관리하는 오픈소스 클라이언트** 입니다. [21st.dev](https://21st.dev) 팀이 만들었으며, Claude Code와 Codex를 한 화면에서 즉시 전환해 쓸 수 있고, 각 채팅 세션을 독립된 Git 워크트리(worktree)에서 돌려 작업끼리 격리합니다. Cursor와 비슷한 UI로 에이전트가 만드는 변경을 실시간 diff로 보여주고, 도구 실행 과정을 그대로 노출합니다.

소스에서 직접 빌드하면 무료로 쓸 수 있고, 구독 시 미리 빌드된 릴리스와 클라우드 백그라운드 에이전트 기능이 추가됩니다. macOS 데스크톱과 웹 앱을 지원하며 Windows·Linux로도 확장되고 있습니다. 본 게시물에서는 1Code의 작업 흐름, 워크트리 격리와 백그라운드 실행, 주요 기능, 설치 방법을 정리합니다.

## 1Code의 작업 흐름

1Code의 동작은 작업 지시에서 시작해 PR 생성으로 끝나는 흐름으로 정리할 수 있습니다. 에이전트에게 할 일을 전달하면, 그 작업은 독립된 Git 워크트리에서 실행되어 다른 작업이나 main 브랜치와 섞이지 않습니다. 필요하면 클라우드 샌드박스에서 백그라운드로 돌릴 수 있고, 마지막에는 변경 사항을 diff로 검토한 뒤 PR로 제출합니다.

 ![1Code의 작업 흐름 다이어그램](https://discuss.pytorch.kr/uploads/default/original/3X/e/b/ebc78953fc8f751d29bad0cd1104e6619e5558ad.jpeg)

### 1Code의 Git 워크트리 격리

각 채팅 세션은 자기만의 격리된 워크트리에서 실행됩니다. Git 워크트리는 하나의 저장소에서 여러 작업 디렉토리를 동시에 두는 기능으로, 1Code는 이를 활용해 에이전트가 main 브랜치를 직접 건드리지 않고 별도 브랜치에서 작업하도록 합니다. 한 작업이 백그라운드로 도는 동안 다른 작업을 계속 진행할 수 있고, 모든 코드는 로컬에 남아 클라우드 동기화 없이도 동작합니다.

![1Code의 워크트리 격리 실행 데모](https://discuss.pytorch.kr/uploads/default/original/3X/f/7/f7df46835e4710281a46785c03c2bfc6230cf5fe.gif)

## 1Code의 주요 기능

1Code는 코딩 에이전트 클라이언트가 갖춰야 할 기능을 폭넓게 제공합니다. 핵심은 여러 에이전트를 한 곳에서 다루면서, 변경 과정을 투명하게 보여주는 데 있습니다.

- **멀티 에이전트 지원** : Claude Code와 Codex를 한 앱에 두고 즉시 전환합니다. 모델·프로바이더는 자신의 API 키를 가져와 쓰는 BYOK(Bring Your Own Key) 방식을 지원합니다.
- **시각 UI와 내장 Git 클라이언트** : 변경 사항을 실시간 diff로 미리 보고, 스테이징·커밋·푸시·PR 생성까지 앱을 벗어나지 않고 처리합니다. 사용자 메시지 지점에서 변경을 롤백하거나, 어시스턴트 메시지에서 하위 대화를 분기(Chat Forking)할 수도 있습니다.
- **백그라운드 에이전트** : 노트북을 닫아도 격리된 클라우드 샌드박스에서 작업이 계속 진행되며, 개발 브랜치를 실제 브라우저로 미리 볼 수 있습니다.
- **MCP와 플러그인** : 설정 파일 없이 UI에서 MCP 서버를 켜고 끄거나 설정하고, 플러그인 마켓플레이스에서 한 번에 설치합니다.
- **자동화(Automations)** : GitHub, Linear, Slack에서 `@1code` 를 태그하거나 push·PR 같은 git 이벤트로 에이전트를 트리거합니다. 다만 자동화는 [Pro 또는 Max 구독](https://1code.dev/pro)이 필요합니다.

이 밖에도 칸반 보드, 통합 터미널, 메시지 큐, 음성 입력, 커스텀 스킬과 슬래시 명령, `CLAUDE.md`·`AGENTS.md` 기반 메모리, 그리고 휴대폰에서 백그라운드 에이전트를 시작·모니터링하는 PWA를 제공합니다.

### 1Code의 계획 모드

1Code는 실행 전에 계획을 세우는 계획 모드(Plan Mode)를 갖추고 있습니다. 에이전트가 필요한 것을 먼저 질문하고, 단계별로 구조화된 계획을 세운 뒤 읽기 좋은 마크다운으로 보여줍니다. 사용자는 계획을 검토하고 승인하거나 수정한 다음 실행에 들어갑니다. 확장 사고(Extended Thinking)는 기본으로 켜져 있으며, 하위 에이전트(Sub-agents)의 작업 목록도 사이드바에서 시각적으로 확인할 수 있습니다.

![1Code의 계획 모드 데모](https://discuss.pytorch.kr/uploads/default/original/3X/7/3/73255e1bd88d8f03f1bb9d5d4ab7ce271d5e8279.gif)

## 1Code 설치 및 사용법

소스에서 직접 빌드하면 무료로 사용할 수 있습니다. Bun, Python 3.11, setuptools, 그리고 macOS의 경우 Xcode Command Line Tools가 필요합니다.

```bash
bun install
bun run claude:download # Claude 바이너리 다운로드 (필수)
bun run codex:download # Codex 바이너리 다운로드 (필수)
bun run build
bun run package:mac # 또는 package:win, package:linux

```

`claude:download` 와 `codex:download` 단계는 에이전트 동작에 필요한 바이너리를 받아오므로 건너뛰면 앱은 빌드되어도 에이전트 기능이 정상 동작하지 않습니다. 네이티브 모듈 재빌드에는 Python 3.11이 권장되며, Python 3.12 이상에서는 `pip install setuptools` 로 setuptools를 먼저 설치합니다. 미리 빌드된 릴리스와 백그라운드 에이전트가 필요하면 [1code.dev](https://1code.dev)에서 구독할 수 있습니다.

에이전트를 프로그래밍 방식으로 실행하는 API도 제공합니다. 저장소와 작업을 지정하면 에이전트가 샌드박스에서 작업을 수행하고 PR을 만들어 돌려줍니다.

```bash
curl -X POST https://1code.dev/api/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "repository": "https://github.com/your-org/your-repo",
    "prompt": "Fix the failing CI tests"
  }'

```

## 1Code의 라이선스

1Code는 [Apache License 2.0](https://github.com/21st-dev/1code/blob/main/LICENSE)으로 공개되어 있어 개인 및 상업적 목적으로 자유롭게 사용할 수 있습니다.

## 🏠 1Code 공식 홈페이지

> **[1Code - Claude Code & Codex in One App](https://1code.dev)**
>
> Open source coding agent client. Switch between Claude Code and Codex, take the best of each, ship with the best UI.

## :github: 1Code 프로젝트 GitHub 저장소

> **[GitHub - 21st-dev/1code: Orchestration layer for coding agents (Claude...](https://github.com/21st-dev/1code)**
>
> Orchestration layer for coding agents (Claude Code, Codex)

## 더 읽어보기

- [Paseo: Claude Code, Codex 등 코딩 에이전트를 휴대폰과 데스크톱에서 쓰는 셀프 호스팅 도구](https://discuss.pytorch.kr/t/paseo-claude-code-codex/10553)

- [Async Code Agent: Codex UI 스타일로 Claude Code까지 사용할 수 있는 코드 에이전트 프로젝트](https://discuss.pytorch.kr/t/async-code-agent-codex-ui-claude-code/7094)

- [Mysti: 멀티 에이전트 AI 코딩 팀을 구성해주는 VS Code 확장 (Claude + Codex + Gemini + Copilot)](https://discuss.pytorch.kr/t/mysti-ai-vs-code-claude-codex-gemini-copilot/8570)

- [Claude Code Mux: 다양한 LLM들을 Claude Code에서 함께 사용할 수 있는 Rust 기반 AI 라우팅 프록시](https://discuss.pytorch.kr/t/claude-code-mux-llm-claude-code-rust-ai/8244)

- [Claude Code 동적 워크플로우(Dynamic Workflows): 작업마다 하네스를 직접 짜는 병렬 오케스트레이션](https://discuss.pytorch.kr/t/claude-code-dynamic-workflows/10519)

* * *

_이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다._ 🤗

[:pytorch:파이토치 한국 사용자 모임🇰🇷](https://pytorch.kr/)이 정리한 이 글이 유용하셨나요? [회원으로 가입](https://discuss.pytorch.kr/signup)하시면 주요 글들을 이메일💌로 보내드립니다!  
[텔레그램(Telegram)](https://t.me/pytorchkr)이나 [Slack/Discord/Teams/Dooray/GoogleChat 등](https://discuss-noti.pytorch.kr)으로도 새 글 알림을 받으실 수 있습니다. 😃

🎁 아래↘쪽에 좋아요👍를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ 🤩