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

읽을거리&정보공유
, , , , ,
1

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

1Code 소개

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

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

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

1Code의 작업 흐름

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

1Code의 작업 흐름 다이어그램
1Code의 작업 흐름 다이어그램1536×1024 212 KB

1Code의 Git 워크트리 격리

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

1Code의 워크트리 격리 실행 데모

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 구독이 필요합니다.

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

1Code의 계획 모드

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

1Code의 계획 모드 데모

1Code 설치 및 사용법

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

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에서 구독할 수 있습니다.

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

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으로 공개되어 있어 개인 및 상업적 목적으로 자유롭게 사용할 수 있습니다.

:house: 1Code 공식 홈페이지

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

더 읽어보기



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

:pytorch:파이토치 한국 사용자 모임:south_korea:이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일:love_letter:로 보내드립니다!
텔레그램(Telegram)이나 Slack/Discord/Teams/Dooray/GoogleChat 등으로도 새 글 알림을 받으실 수 있습니다. :smiley:

:wrapped_gift: 아래:down_right_arrow:쪽에 좋아요:+1:를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ :star_struck:

1개의 좋아요