DeepSeek-Reasonix

오픈 소스 · MIT · 내 컴퓨터에서 실행, 원하는 모델 선택

터미널, 데스크톱, 브라우저, 에디터를 위한 오픈 소스 코딩 에이전트.
프로젝트를 읽고, 파일을 편집하고, 명령과 테스트를 실행합니다. 각 단계마다 확인을 요청하게 하거나, 설정한 한도 내에서 스스로 작업하게 할 수 있습니다. 편집 도구가 변경한 파일은 되감을 수 있습니다. 처음이신가요? Studio 데스크톱 앱으로 시작하세요.

유지 관리: Huahui Yu .

중요

커뮤니티 · 加入社区 — 설정 도움( #help / #求助 ), 워크플로 쇼케이스, 기능 아이디어를 위한 이중 언어 Discord. → https://discord.gg/XF78rEME2D

QQ 그룹 DeepSeek-Reasonix官方群 ( 1093562660 ) → https://qm.qq.com/q/i59b0z2R8s ( QR 코드 )

Douyin: 做游戏的小鱼 (Douyin ID 22703872788 ) · QR 코드

❤️후원
이 프로젝트를 후원해 주신 Right Code에 감사드립니다! Right Code는 Claude Code, Codex, Gemini 등의 모델에 대한 라우팅 서비스를 안정적으로 제공하며, 종량제와 월 구독 요금제를 모두 제공합니다. 충전 시 인보이스를 발급받을 수 있고, 기업 및 팀 사용자는 전담 1:1 지원을 받을 수 있습니다. 이 링크 로 등록하세요 . 이 프로젝트를 후원해 주신 PackyCode에 감사드립니다! PackyCode를 통해 하나의 API 엔드포인트와 하나의 API 키로 선도적인 AI 모델에 접속할 수 있으며, 자동 장애 조치와 Codex 및 Claude Code용 전용 고속 경로를 제공합니다. 이 링크 로 등록하세요 .
무엇인가
Reasonix는 오픈 소스 AI 코딩 어시스턴트입니다. 프로그램은 내 컴퓨터에서 실행되며, AI 모델은 사용자가 구성하는 서비스로, 모델이 읽는 내용을 전달받습니다. 작업을 자연어로 설명하면, 선택한 프로젝트 폴더 안에서 코드를 읽고, 파일을 편집하고, 명령과 테스트를 실행하며 각 단계를 보여줍니다.

모델은 직접 선택합니다: DeepSeek 프리셋이 내장되어 있고, OpenAI 호환 서비스는 설정 항목 하나로 추가되며, 모델 제공자에게 직접 비용을 지불합니다.

제공 기능

읽기, 편집, 실행. 프로젝트 폴더 안에서 코드를 읽고, 파일을 편집하고, 테스트와 명령을 실행합니다.
권한 수준. 매번 확인을 요청하게 하거나, 일상적인 작업은 스스로 실행하게 할 수 있습니다. 금지 규칙은 항상 적용됩니다. 먼저 접근 방식을 보고 싶다면 플랜 모드를 사용하세요: 승인한 후에만 작업을 시작합니다.
되감기. 파일은 변경 전에 저장되므로, git 기록을 건드리지 않고 대화 턴 단위로 되감을 수 있습니다. 편집 도구가 변경한 파일만 해당되며, 셸 명령이 수행한 작업은 포함되지 않습니다.

30초 시작
다운로드하고, 모델 키를 추가하고, 프로젝트를 여세요. 처음이신가요? Studio 데스크톱 앱으로 시작하세요.

릴리스 페이지 에서 데스크톱 앱 Reasonix Studio를 다운로드하여 설치하세요.
앱을 열고 요청 시 모델 제공자와 키를 입력하세요.
프로젝트 폴더를 열고 원하는 작업을 작성하세요. 예: "http 클라이언트에 실패 시 재시도 추가".
선택한 수준에 따라, 승인이 필요한 작업 전에 멈추고 확인을 요청합니다. 계속하도록 허용하거나 거부하세요.

터미널을 선호하시나요? reasonix 명령줄 도구를 다운로드하고, reasonix setup 을 실행해 모델을 선택한 다음 reasonix 를 실행하세요. 설치 및 빠른 시작 을 참고하세요.

네 가지 사용 방법

데스크톱 앱 (Studio). 그래픽 앱으로, 시작하기에 가장 좋은 곳입니다.
터미널. 전체 화면 텍스트 인터페이스이며, reasonix run "task" 는 스크립트에서도 작동합니다.
브라우저. reasonix web 은 내 컴퓨터에서 웹 인터페이스를 엽니다.
에디터. VS Code에 확장을 설치하세요. ACP(Agent Client Protocol, 에디터가 AI 어시스턴트에 연결하는 일반적인 방식)를 지원하는 다른 에디터는 reasonix acp 에 연결할 수 있습니다.

네 가지 모두 내부적으로는 동일한 프로그램입니다. 다음 내용은 고급 사용자와 기여자를 위한 것입니다.

DeepSeek Harness에서 사용하기
DeepSeek Harness ( dsh )는 ACP를 통해 Reasonix에 작업을 서브에이전트로 넘길 수 있습니다. 이 저장소는 이를 위한 플러그인 인덱스를 게시합니다:

dsh를 실행하는 머신에서 reasonix setup 을 실행하세요. DSH Web UI에서 Custom plugin markets (Plugins, More)를 켜고 Discover 탭에서 이 인덱스를 추가하세요: https://raw.githubusercontent.com/esengine/DeepSeek-Reasonix/studio/integrations/dsh-plugin/market-index.json
여기서 "Reasonix subagent"를 설치하세요.
플러그인 페이지를 열고 스위치를 켜세요. 꺼져 있는 동안 모델에는 reasonix 도구가 없으며, 자체 셸에서 reasonix -p 를 실행할 수 있는데, 이는 위임처럼 보이지만 위임이 아닙니다.

설정 세부 사항, 권한 정책 및 한도는 DeepSeek Harness에서 Reasonix 사용하기 에 있습니다.

버전
Reasonix는 두 개의 라인으로 배포됩니다. 분리의 배경은 버전 로드맵 공지를 참고하세요.

라인
브랜치
상태
받기

Reasonix 2.x
studio (이 브랜치)
활발한 개발
Studio 릴리스

Reasonix 1.x
main-v2
유지 관리 / 안정
npm i -g reasonix · 데스크톱 다운로드

안정적인 것을 원하시나요? 1.x에 머무르세요. 버그 수정,
제공자/API 호환성, 업데이터 및 보안 수정을 계속 받습니다. 핵심 아키텍처는
더 이상 확장되지 않습니다.
새 아키텍처를 원하시나요? 2.x Reasonix Studio를 사용하세요. 여전히 빠르게
변화하고 있으며, 보고를 환영합니다.

1.x의 가치 있는 수정, 테스트, 동작은 하나씩 검토되어 새 아키텍처에 맞는 경우
2.x에 포팅되거나 재구현됩니다.

1.x에서 2.x로 이동 : 두 라인이 공유하는 것, 그리고
세션을 잃지 않고 한 머신에서 둘 다 실행하는 방법.
2.x 로드맵 : 2.x가 아직 제공해야 할 것, 배포 방식,
그리고 아직 열려 있는 결정들.

기능
고급 사용자를 위한 기술적 하이라이트.

설정 기반. 제공자, 에이전트, 활성화된 도구, 플러그인은 모두
reasonix.toml 에 선언됩니다. 하드코딩된 모델이 없습니다.
멀티 모델 & 조합 가능. DeepSeek은 프리셋으로 제공되며, 모든
OpenAI 호환 엔드포인트는 새 코드가 아닌 설정 항목입니다. 선택적으로
두 모델(실행자 + 플래너)을 별도의 캐시 안정적인 세션에서 함께 실행할 수 있습니다.
플러그인 기반. MCP 서버는 도구, 프롬프트, 리소스를 제공합니다;
Extension Protocol v1 사이드카는 런타임 이벤트를 가로채고, 제공자와 구조화된 UI를
제공하며, 버전이 지정된 플러그인 패키지를 배포할 수도 있습니다.
캐시 인식 컨텍스트 유지 관리. 시작 시 작고 안정적인 환경
요약을 주입하고, 오래된 도구 출력은 요약 압축 전에 잘라내거나 정리하며,
내장 도구 스키마 계약은 회귀 검토를 위해 문서화됩니다.
마찰 없는 배포. CGO_ENABLED=0 단일 바이너리; 한 명령으로
여섯 개 타깃으로 크로스 컴파일. 결과물은 완전히 자체 포함된 정적
바이너리로, 바이너리 자체 외에는 대상 머신에 설치할 것이 없습니다.

설치
이 브랜치는 Reasonix 2.x 입니다. 데스크톱 앱은 Reasonix Studio이며, CLI,
Studio, 에디터 통합은 모두 동일한 로컬 Reasonix 엔진을 실행합니다.

Reasonix Studio (2.x)
최신
Studio 릴리스
( studio-v2.* 태그; -rc.N 같은 후보는
사전 릴리스로 표시됨)에서 플랫폼용 패키지를 다운로드하세요:

플랫폼
패키지
아키텍처

macOS
.dmg 또는 .zip
Apple Silicon ( arm64 ) / Intel ( amd64 )

Windows
설치 프로그램 -installer.exe 또는 포터블 .zip
x64

Linux
.deb , .rpm , 또는 .AppImage (다운로드 전용)
x64 ( amd64 ) / ARM64 ( arm64 , aarch64 )

모든 패키지에는 .minisig 서명이 포함되며, 릴리스에는
SHA256SUMS 가 함께 제공됩니다. 설치 후 Studio는 제자리에서 자체 업데이트됩니다.

같은 릴리스에는 darwin|linux|windows × amd64|arm64 용 아카이브로
2.x reasonix CLI도 포함됩니다.

Reasonix 1.x (안정)
1.x CLI는 지원되는 모든 플랫폼에서 npm으로, 또는 macOS에서
Homebrew로 설치합니다:

npm i -g reasonix # 모든 OS; 미리 빌드된 네이티브 바이너리를 가져옴
brew install esengine/reasonix/reasonix # macOS
1.x 데스크톱 앱은
공식 다운로드 페이지 에 있습니다. Windows
설치 프로그램은 Certum 코드 서명 인증서로 코드 서명됩니다.

VS Code 확장
확장은 CLI를 번들하지 않으며, 로컬 reasonix acp
백엔드를 시작하고 네이티브 채팅, 에디터 컨텍스트, 도구 호출 승인, 모델
선택, 워크스페이스 세션을 추가합니다. 먼저 1.x CLI를 설치하세요.

VS Code: Visual Studio Marketplace에서 설치
VSCodium / Eclipse Theia: Open VSX Registry에서 설치
확장 ID: SivanLiu.reasonix-agent · 소스 및 사용 가이드

소스에서 빌드
저장소를 클론하세요; studio는 2.x를, main-v2는 1.x를 빌드합니다:

git clone https://github.com/esengine/DeepSeek-Reasonix.git
cd DeepSeek-Reasonix
git switch studio
CLI
CLI 빌드에는 Go 1.25+ 가 필요합니다. 모듈은 툴체인 지시문을 고정하므로,
Go가 고정된 툴체인을 다운로드하도록 GOTOOLCHAIN=auto 를 유지하거나 직접 설치하세요.

make build # -> bin/reasonix(.exe)
make cross # -> dist/ (darwin|linux|windows × amd64|arm64)
Studio
Studio는 프런트엔드를 위해 추가로 Node 24+ 와 pnpm 10
( npm install -g pnpm@10 )이 필요합니다.

make studio
플랫폼 웹뷰 의존성과 Linux 빌드 태그는 Studio 빌드 가이드 를 참고하세요.

빠른 시작
Reasonix Studio
Studio를 설치하고 실행한 다음, 앱에서 제공자와 모델을 연결하세요. CLI
설정은 필요하지 않습니다.

CLI / TUI
reasonix setup # 제공자와 모델 구성
reasonix # 대화형 세션 시작
reasonix run " implement the TODOs in main.go "
대화형 세션에서 Reasonix가 프로젝트
지침을 생성하도록 하려면 /init 을 실행하세요.

고급 CLI 사용법과 구성은 CLI 레퍼런스 ,
가이드 , 그리고
구성 경로 를 참고하세요.

문서

시작하기: 가이드 · CLI 레퍼런스 ·
구성 경로 · ACP 에디터 통합 ·
DeepSeek Harness에서 사용
기능 & 문제 해결: 서브에이전트 프로필 ·
Context Engine v2 ·
기능 진단 ·
복구 및 업데이트 ·
체크포인트 & 되감기
에이전트 프리셋: 세션 에이전트 구성
엔지니어링 & 마이그레이션: 스펙 ·
작업 계약 & 일시정지 정책 ·
도구 계약 · 1.x에서 2.x로 이동 ·
2.x 로드맵
확장 개발: 스킬 · 확장 ·
플러그인 패키지 및 Manifest v1 ·
Extension Protocol ·
Go SDK 및 스타터

Star 기록

감사의 말
Reasonix를 가장 많이 형성한 분들의 작은 목록 — 커밋 수 기준 현재 상위
20명의 기여자입니다. 전체 기여자 그래프는
GitHub 에 있습니다.

기여자
기여자
기여자
기여자

SivanCola
KHG420
ttmouse
chuiwenwei

lifu963
XTLine
HUQIANTAO
xxoingr

Harbor404
GTC2080
mchenziyi
Li-Charles-One

light-front-theory
imcreazy
eghrhegpe
noreply

par73e
Bernardxu123
lancy69
Guan0923

프로젝트 로고와 인트로 영상을 디자인해 주신 Bernardxu123에게 특별히 감사드립니다.

MIT — LICENSE 참고

esengine/DeepSeek-Reasonix 의 커뮤니티가 만들었습니다

이 프로젝트 후원하기

Reasonix가 유용했다면 감사의 뜻을 전할 수 있습니다. 커피 한 잔일 뿐,
계약이 아닙니다 — 후원은 기능 우선순위를 사거나 이슈 처리 방식을 바꾸지 않습니다.

해외 — PayPal: paypal.me/yuhuahui
국내 — 微信支付 / 支付宝 (QR 스캔)