1Code: 코딩 에이전트를 위한 오케스트레이션 레이어

1Code Banner

코딩 에이전트가 많아졌다. Claude Code, Codex, Gemini CLI, Copilot… 각각 강력하지만 따로 쓰기엔 번거롭다. 터미널 여러 개, 설정 파일 여러 개, 컨텍스트는 제각각. 1Code는 이 문제를 해결한다. 모든 코딩 에이전트를 하나의 앱에서 실행하는 오케스트레이션 레이어다.

왜 주목해야 하는가

21st.dev 팀이 만든 1Code는 단순한 에이전트 러너가 아니다. 에이전트들이 안전하게 작업할 수 있는 인프라를 제공한다.

1Code UI

핵심 문제 해결:

여러 에이전트를 하나의 UI에서 관리
각 채팅이 독립된 Git Worktree에서 실행 — 메인 브랜치 보호
노트북이 꺼져도 클라우드 샌드박스에서 백그라운드 실행
개발 브랜치를 실제 브라우저에서 미리보기

핵심 철학: 격리와 통제

1Code의 설계 철학은 명확하다:

에이전트는 강력하지만 위험하다. 통제된 환경에서 실행하라.

Git Worktree 격리

각 채팅 세션은 독립된 Git Worktree에서 실행된다.

project/
├── main/           ← 메인 브랜치 (보호됨)
├── .worktrees/
│   ├── chat-001/   ← 채팅 1의 격리된 작업 공간
│   ├── chat-002/   ← 채팅 2의 격리된 작업 공간
│   └── chat-003/   ← 채팅 3의 격리된 작업 공간

이것이 왜 중요한가:

에이전트가 메인 브랜치를 망가뜨릴 수 없다
여러 에이전트가 동시에 다른 작업 가능
각 작업은 독립적인 Git 히스토리 유지
PR 생성 시 깔끔한 커밋 히스토리

기존 방식은 에이전트가 메인 브랜치에서 직접 작업했다. 실수 한 번이면 프로젝트가 망가진다. 1Code는 이를 근본적으로 차단한다.

백그라운드 에이전트

노트북을 닫아도 에이전트는 계속 작동한다.

작동 방식:

로컬에서 에이전트 시작
클라우드 샌드박스로 자동 마이그레이션
노트북 꺼져도 작업 계속
완료되면 알림

실제 시나리오:

“이 리팩토링 작업 맡겼는데 2시간 걸린대. 나 커피 마시러 갔다 올게.”

노트북 닫고 카페로 이동. 돌아오면 완료된 PR이 기다리고 있다.

Live Browser Previews

에이전트가 만든 코드를 실제 브라우저에서 즉시 확인한다.

개발 브랜치의 변경사항이 실시간 반영
핫 리로딩 지원
모바일 뷰 시뮬레이션

에이전트에게 “버튼 스타일 수정해”라고 요청

변경사항이 즉시 브라우저에 반영

“아니, 좀 더 둥글게”라고 피드백

다시 반영

빌드-배포-확인 사이클이 초단위로 줄어든다.

비주얼 UI: Cursor 같은 경험

1Code는 터미널 기반이 아니다. 비주얼 IDE를 제공한다.

Diff 프리뷰

에이전트가 변경한 코드를 사이드바에서 바로 확인:

- function oldAuth(user) {
+ function newAuth(user, token) {
+   if (!token) throw new Error('Token required');
    return validate(user);
  }

승인 전에 무엇이 바뀌었는지 명확히 파악 가능.

실시간 도구 실행

에이전트가 어떤 도구를 사용하는지 실시간으로 표시:

🔍 파일 검색: auth*.ts
📖 파일 읽기: src/auth/login.ts
✏️ 파일 수정: src/auth/login.ts
🧪 테스트 실행: npm test
✅ 완료

에이전트의 “사고 과정”이 시각화된다.

Kanban Board

에이전트 작업을 칸반 보드로 관리:

할 일	진행 중	완료
로그인 리팩토링	API 스펙 작성	버그 수정
테스트 추가		문서화

드래그 앤 드롭으로 우선순위 조정.

통합 터미널

비주얼 UI뿐만 아니라 터미널도 제공:

각 채팅마다 독립된 터미널
에이전트가 실행한 명령 히스토리
직접 명령 입력 가능

파일 뷰어

프로젝트 파일 구조를 탐색:

트리 뷰
파일 미리보기
변경된 파일 하이라이트

멀티 에이전트 지원

1Code는 하나의 에이전트만 지원하지 않는다.

지원 에이전트

에이전트	상태	특징
Claude Code	✅ 완전 지원	Anthropic 공식 CLI
Codex	✅ 완전 지원	OpenAI 코딩 에이전트
Gemini CLI	🔄 실험적	Google Gemini
Copilot CLI	🔄 실험적	GitHub Copilot

에이전트 선택

채팅 시작 시 에이전트를 선택:

[Claude Code] ← 복잡한 리팩토링에 강함
[Codex]       ← 빠른 버그 수정에 적합

작업 성격에 맞는 에이전트를 선택 가능.

MCP & Plugins

1Code는 MCP (Model Context Protocol)와 플러그인을 지원한다.

MCP 서버 관리

MCP 서버를 UI에서 관리:

MCP Servers:
├── filesystem ✅
├── postgres ✅
├── slack 🔄
└── github ✅

플러그인 마켓플레이스

커뮤니티 플러그인을 검색하고 설치:

데이터베이스 연결
API 통합
커스텀 도구

@ 멘션

에이전트에게 특정 도구나 컨텍스트를 명시:

@github PR #42 리뷰해줘
@postgres 쿼리 최적화해줘

Automations: 자동화 파이프라인

1Code는 수동 실행뿐만 아니라 자동화도 지원한다.

트리거 소스

소스	설명
GitHub	PR, Issue, Push 이벤트
Linear	태스크 생성, 상태 변경
Slack	/1code 명령어
Webhook	커스텀 트리거

자동화 예시

GitHub PR 리뷰:

trigger: github.pr.opened
agent: claude-code
prompt: |
  Review this PR for:
  - Code quality
  - Security issues
  - Test coverage
  Leave comments on the PR.

Linear 태스크 처리:

trigger: linear.task.created
filter: label == "bug"
agent: codex
prompt: |
  Fix the bug described in the task.
  Create a PR when done.

API 통합

curl로도 에이전트 실행 가능:

curl -X POST https://api.1code.dev/run \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
    "agent": "claude-code",
    "prompt": "Fix the login bug",
    "repo": "owner/repo"
  }'

완료되면 Webhook으로 결과 수신.

Plan Mode: 실행 전 검토

에이전트가 바로 실행하지 않고, 계획을 먼저 제시한다.

작동 방식

사용자 요청 입력
에이전트가 구조화된 계획 생성
사용자 검토 및 승인
실행

계획 예시:

📋 계획: 로그인 리팩토링

1. src/auth/login.ts 수정
   - 토큰 검증 로직 추가
   - 에러 핸들링 개선

2. src/auth/__tests__/login.test.ts 수정
   - 새로운 토큰 검증 테스트 추가
   - 엣지 케이스 테스트

3. 문서 업데이트
   - API 문서에 토큰 파라미터 추가

예상 소요 시간: 15분

[승인] [수정 요청] [취소]

Extended Thinking

복잡한 작업에서는 Extended Thinking 모드:

에이전트가 더 깊이 분석
다양한 접근법 고려
더 나은 품질의 코드

Chat Forking: 대화 분기

어시스턴트 메시지에서 서브 채팅을 포크할 수 있다.

사용 시나리오

메인 채팅:
  "기능 A 구현해줘"
  → [구현 완료]
  → "이제 기능 B도 추가해줘"
  
여기서 포크:
  "기능 A 구현해줘"
  → [구현 완료]
  → 🍴 포크: "이 버전을 최적화해줘"

장점

다양한 접근법 동시 탐색
실험적으로 시도 후 롤백
메인 작업 흐름 유지

PWA: 모바일에서도

1Code는 PWA(Progressive Web App)로 제공된다.

기능

폰에서 백그라운드 에이전트 모니터링
푸시 알림 (작업 완료 시)
오프라인 캐시

사용 시나리오

출근길 지하철에서 폰으로 에이전트 상태 확인

“아, 리팩토링 완료됐네”

회사 도착해서 노트북으로 PR 리뷰

크로스 플랫폼

1Code는 모든 주요 플랫폼에서 작동한다.

플랫폼	상태	설치 방식
macOS	✅	.dmg, Homebrew
웹	✅	브라우저
Windows	🔄 베타	.exe, winget
Linux	🔄 베타	.AppImage, snap

기술 아키텍처

구성 요소

┌─────────────────────────────────────┐
│           1Code Desktop             │
│  ┌─────────────────────────────┐   │
│  │      Orchestration Layer     │   │
│  └─────────────────────────────┘   │
│  ┌──────────┐  ┌──────────┐        │
│  │Claude Code│  │  Codex   │        │
│  └──────────┘  └──────────┘        │
│  ┌─────────────────────────────┐   │
│  │     Git Worktree Manager     │   │
│  └─────────────────────────────┘   │
│  ┌─────────────────────────────┐   │
│  │    Background Agent Runner   │   │
│  │    (Cloud Sandbox)           │   │
│  └─────────────────────────────┘   │
└─────────────────────────────────────┘

보안 모델

격리: 각 채팅은 독립된 Worktree
승인: 파일 변경 전 사용자 승인
감사: 모든 작업 로깅
암호화: 통신 및 저장 데이터 암호화

빠른 시작

macOS

brew install 1code
1code

웹

https://1code.dev 접속 → GitHub로 로그인 → 시작

첫 사용

프로젝트 폴더 선택
에이전트 선택 (Claude Code / Codex)
API 키 입력
채팅 시작

언제 1Code를 쓸까

비추천

단순 작업 — 설정 오버헤드
터미널 파워유저 — CLI가 더 빠를 수 있음
오프라인 전용 — 클라우드 기능 활용 어려움

가격

플랜	가격	기능
Free	$0	로컬 에이전트, 기본 기능
Pro	$20/월	백그라운드 실행, Automations
Team	$50/월	협업 기능, 관리자 콘솔

에이전트 API 비용은 별도 (Anthropic, OpenAI 등).

마치며: 코딩 에이전트의 운영체제

1Code는 단순한 “에이전트 러너”가 아니다. 코딩 에이전트를 위한 운영체제다.

핵심 가치 정리

통합 — 모든 에이전트를 하나의 앱에서
격리 — Git Worktree로 안전한 작업 환경
지속성 — 백그라운드 실행으로 중단 없는 작업
가시성 — 비주얼 UI로 투명한 작업 확인
자동화 — 트리거 기반 자동 실행

빠른 시작

brew install 1code
1code

에이전트를 쓰고 있다면, 1Code로 한 단계 업그레이드해보라.

🔗 관련 정보

공식 사이트: https://1code.dev
개발사: 21st.dev
문서: https://docs.1code.dev
Twitter: @1code_dev