DeepCode
논문과 설명을 코드로 옮기는 다중 에이전트 코딩 환경
uv tool install --python 3.12 deepcode-hku여러 에이전트를 묶어 연구 논문이나 자연어 설명을 돌아가는 코드로 옮기는 코딩 환경입니다. 에이전트 런타임은 하나이고 인터페이스가 둘입니다. 터미널에서 쓰는 대화형 CLI 와 시각적으로 세션과 코드 변경, 검증을 다루는 데스크톱 작업대가 같은 프로젝트와 세션 기록, 모델, 스킬, 권한, 목표, 자동화를 공유합니다. 스킬과 플러그인, MCP 를 세 인터페이스에서 같은 방식으로 다루고 MCP 목록은 인증과 실제 연결 시험까지 포함해 관리합니다. 파괴적인 명령을 걸러 내는 1차 검사가 앞에 있고 실제 경계는 샌드박스가 맡습니다.
판단
이럴 때 씁니다
- 논문이나 설계 문서를 돌아가는 코드로 옮겨야 할 때
- 터미널과 화면을 오가며 같은 세션을 이어 보고 싶을 때
- 스킬과 MCP 를 한 곳에서 관리하고 싶을 때
이럴 땐 쓰지 마세요
- 파이썬 3.12 이상이 필요하고 낮은 판으로 물러서지 않습니다
- CLI 설치가 데스크톱 앱을 함께 깔지 않습니다
- 연구실에서 나온 프로젝트라 판마다 구조가 바뀌는 편입니다
차별점
- 하나의 에이전트 런타임에 터미널과 데스크톱 두 인터페이스를 얹었습니다.
- 스킬과 플러그인, MCP 를 세 인터페이스에서 같은 방식으로 다룹니다.
- MCP 목록에 인증과 실제 연결 시험이 붙어 있습니다.
- 논문을 코드로 옮기는 작업을 전면에 내세운 드문 프로젝트입니다.
워크플로
- 01실행기 도구로 CLI 를 설치합니다.
- 02초기화 명령을 돌립니다.
- 03모델 제공자를 한 번 등록하고 연결을 시험합니다.
- 04세션을 만들어 목표를 넣습니다.
- 05필요하면 데스크톱 작업대에서 같은 세션을 이어 봅니다.
주요 명령
| 명령 | 설명 |
|---|---|
uv tool install --python 3.12 deepcode-hku | CLI 와 공용 런타임을 설치합니다. 데스크톱 앱은 별도입니다. |
deepcode init | 초기 설정을 만듭니다. |
deepcode provider set <name> --template <provider> --api-key | 모델 제공자를 등록합니다. 키는 화면에 찍히지 않는 입력으로 받습니다. |
함정
설치 전에 확인하세요
- 파이썬 판을 명시해 설치하라고 문서가 강조합니다. 낮은 판에서는 지원하지 않는 옛 패키지로 떨어질 수 있습니다.
- 1.x 환경이 남아 있으면 갱신 명령으로 옮겨야 합니다.
- 파괴적인 명령 검사는 인자 단위로 판단하는 1차 관문일 뿐이고 실제 경계는 샌드박스라고 저장소가 명시합니다.
- CLI 와 데스크톱이 같은 세션을 공유하지만 설치 경로가 다릅니다. 하나를 깔았다고 다른 하나가 생기지 않습니다.
비교
코딩 에이전트는 대체로 터미널이거나 편집기 확장입니다. 이쪽은 같은 런타임을 두 인터페이스에 노출해서, 실행은 터미널에서 하고 검토는 화면에서 하는 흐름을 만듭니다. 대신 설치 경로가 둘로 나뉘고 파이썬 판 요구가 엄격합니다.
최근 변경
스킬과 플러그인, MCP 를 세 인터페이스에서 통합했습니다. 프로젝트를 바꿀 때 목록 적재가 멈추던 문제와 파괴적 명령 검사가 문자열 포함으로 오판하던 문제도 함께 고쳐졌습니다.