ONEDEV

Fuxi

AI Coding ToolsCLIPython

★ 3,406주당 +16조회 4

무엇인가

FuXi는 터미널에서 동작하는 AI 코딩 에이전트다. Claude Code와 같은 자리를 차지하는 CLI 계열 도구이며, 특정 모델 제공자에 종속되지 않는 것을 설계 기준으로 삼는다. 모델은 추론 엔진이고, FuXi는 그 모델을 실제 저장소 위에서 일하는 작업자로 바꾸는 실행 계층이다.

어떻게 동작하나

에이전트 루프는 Think → Act → Verify 세 단계를 반복한다. 모델이 계획을 세우고, 도구를 호출해 파일을 읽거나 쓰고 셸 명령을 실행한 뒤, 결과를 검증해 다음 단계를 정한다. 도구는 파일 읽기·쓰기·편집, bash와 PowerShell 실행, ripgrep 검색, 웹 fetch, LSP 진단, Jupyter, 브라우저 조작, 백그라운드 작업, 병렬 서브에이전트를 포함해 50개 이상이 하나의 바이너리에 들어 있다. 셸 명령은 실행 전에 AST 안전 분류기를 통과하고, 그 위에 세분화된 권한 설정과 감사 로그가 걸린다. 세션 기록은 디스크에 남고 체크포인트로 재개·롤백·분기할 수 있다. 유휴 시 'dreaming'이 세션 간 기억을 통합하고, 긴 대화는 토큰 절약을 위해 자동 압축된다. MCP 클라이언트, 훅, 스킬, 플러그인, 슬래시 명령은 핫 리로드된다.

무엇과 다른가

라우팅 계층이 제공자별 비용을 고려해 모델을 고르고, 실패하면 자동으로 다른 제공자로 넘어간다. OpenAI 호환 엔드포인트, Gemini, Bedrock/Vertex를 같은 인터페이스로 다룬다. 배포 형태도 다르다. 런타임 의존성 없는 단일 정적 바이너리로 나오고, 개인·팀·기업 모두 라이선스 비용이 없다. 백그라운드 버전 확인과 `fuxi update` 명령이 자기 자신을 갱신하며, 교체 전에 체크섬을 검증한다.

어떻게 쓰나

설치 스크립트는 바이너리를 ~/.local/bin에 넣고 사용자 PATH에 추가한다. 같은 명령을 다시 실행하면 기존 설치가 제자리에서 업그레이드된다. 첫 실행 시 ~/.fuxi/ 아래에 설정이 생성된다. 모델 연결은 두 갈래다. `fuxi login`이 브라우저 OAuth로 FuXi 관리 모델을 붙이고, 아니면 환경 변수나 ~/.fuxi/config.yaml에 제공자 API 키를 직접 넣는다. `fuxi init`이 시작 템플릿을 만들고 `fuxi wizard`가 대화형 설정을 진행한다. 여러 제공자를 쓸 때는 providers: 카탈로그와 model: 선택 레이어로 나눈 스키마를 쓴다. TUI 안에서는 /cost, /usage, /context, /status로 상태를 확인한다.

전제와 한계

서드파티 벤치마크(SWE-bench, Terminal-Bench, Aider polyglot) 점수는 아직 공개되지 않았다. 저장소에 실린 비교는 자체 실행한 소규모 과제 세트 결과이며, 에이전트 루프를 측정한 것이지 모델 원점수를 측정한 것이 아니다. 방법론과 원시 결과는 benchmark/REPORT.md에 있다. 동작에는 LLM 제공자 연결이 전제다. 모델이 없으면 에이전트 루프가 돌지 않는다. 설정과 세션 기록은 ~/.fuxi/에 쌓인다.

관련 논문 2

유사 도구