<div align="center">
thClaws 🦞
터미널과 데스크톱에서 작동하는 오픈 소스 에이전트 하니스.
코딩하고, 자동화하고, 기억하며, 조정하는 네이티브-Rust AI 에이전트 워크스페이스입니다. 사용자의 자체 기기에서 실행됩니다. 단일 바이너리. 설계 단계부터 주권적(Sovereign)입니다. 공개적으로 해킹하는 소규모 팀에 의해 구축되었습니다.
GitHub stars
Contributors
Discussions
Release
CI
License: MIT OR Apache-2.0
Platform
Built with Rust
Website · Download · Manual · Enterprise · Discussions · Contribute · Supporters
</div>
🆕 v0.126.0의 새로운 기능 — 여러 에이전트, 하나의 워크스페이스
워크스페이스는 더 이상 단일 에이전트가 아닙니다. 그것은 그들의 선반입니다. 코딩 에이전트, 리서치 에이전트, 그리고 책 쓰기 에이전트를 같은 프로젝트 내에서 나란히 유지하고, 왼쪽의 레일을 통해 전환하면서도 아무것도 잃지 마세요. 각 에이전트는 사용자가 자리를 비운 동안에도 자체 대화 기록, 스크롤 위치, 그리고 반쯤 작성된 메시지를 유지합니다.
┌────┬───────────────────────────────────────────────┐
│ MA │ Chat · Terminal · Files · UI │
│ RE │ │
...
- 각 에이전트는 독립적입니다. 각자의 세션, 지식 기반 (knowledge bases), 설정 및 브라우저 프로필을
.thclaws/bots/<name>/ 폴더 아래에 별도로 가집니다. 에이전트의 파일 도구는 해당 폴더에서 멈추기 때문에, 한 에이전트는 다른 에이전트의 작업 내용을 읽거나 쓸 수 없습니다.
- 나란히 실행됩니다. 모든 에이전트는 앱에 의해 감독되는 자체 프로세스입니다. 충돌하는 에이전트는 다른 에이전트를 방해받지 않고 재시작되며, 사용자가 전환한 에이전트는 계속 작동합니다.
- 레일의
+에서 에이전트를 추가하세요. thClaws.cloud에서 원하는 Agent Template을 가져오거나, 새로운 폴더를 여는 것과 정확히 같은 방식으로 동작하는 빈 에이전트를 시작할 수 있습니다. 최대 8개의 에이전트가 동시에 실행됩니다.
- 데스크톱 및 브라우저 모두 지원합니다. 동일한 레일이 데스크톱 앱과
thclaws --serve에서 작동합니다.
기존 작업 공간은 자체적으로 업그레이드됩니다. v0.126.0이 작업 공간을 처음 열 때 — 데스크톱 앱 또는 --serve를 통해 — 프로젝트를 .thclaws/bots/main/으로 이동시키고 (git 히스토리 포함) 그렇게 했다는 메시지를 알려줍니다. 스크립트는 계속 작동합니다: thClaws -p 및 작업 공간 루트에서의 --cli가 자동으로 첫 번째 에이전트로 진입합니다. 이전 버전의 thClaws가 업그레이드된 폴더를 열 경우, 깨진 프로젝트 대신 업데이트하라는 알림을 찾게 됩니다.
업그레이드 전에: 프로젝트의 이전 경로를 담고 있는 모든 것 — 편집기 창, 절대 경로를 가진 스크립트, 다른 클론 등 — 은 새 경로가 필요합니다. 중요한 경우 먼저 커밋하거나 백업하세요. 사용자의 홈 디렉토리는 절대 업그레이드되지 않으며, thClaws.cloud에 호스팅된 작업 공간은 이번 릴리스에서 마이그레이션되지 않습니다.
전체 변경 목록: CHANGELOG.md
작동하는 것을 확인하세요 (See it work)
세 개의 탭, 하나의 바이너리 — thClaws 세션에서 자체 소스를 바라보며 포착한 내용입니다.
<div align="center">
<a href="docs/img/screens-carousel.webp"><img src="https://raw.githubusercontent.com/thClaws/thClaws/HEAD/docs/img/screens-carousel.webp" alt="thClaws Desktop GUI — cycling through Files, Terminal, and Chat tabs" width="900" /></a>
</div>
파일(Files) (codemirror + tiptap) · 터미널(Terminal) (REPL · 슬래시 명령어 · ANSI 도구 출력) · 채팅(Chat) (마크다운 렌더링 · 도구 표시기)
주요 기능(Highlights)
Google Gemini, OpenAI gpt-image-2, Alibaba Qwen, Veo, DashScope HappyHorse 등 다양한 곳에서 텍스트 → 이미지, 이미지 편집, 텍스트 → 비디오, 이미지 → 비디오를 위한 클릭 몇 번으로 작동하는 셸입니다. 제공업체/모델을 선택하고 해상도를 설정한 후 '생성(Generate)' 버튼을 누르면, 완성된 미디어가 라이브 갤러리에 나타나 다음 실행의 소스로 재사용할 수 있습니다. 동일한 도구(TextToImage / ImageToImage / TextToVideo / ImageToVideo / MediaJobStatus)는 채팅에서도 에이전트에 의해 호출 가능하며, 비동기 비디오도 지원합니다.
<div align="center">
<a href="docs/img/media-studio.webp"><img src="https://raw.githubusercontent.com/thClaws/thClaws/HEAD/docs/img/media-studio.webp" alt="thClaws 미디어 스튜디오 — 라이브 갤러리가 있는 텍스트-이미지 생성기" width="860" "/></a>
</div>
🧠 OpenRouter Fusion — 여러 모델, 하나의 답변
openrouter/fusion은 질문을 최대 8개의 **패널(panel)**에 병렬로 분산하여 보내고 (각 패널이 웹 검색 가능), 이후 **심사위원(judge)**이 답변들을 평가하고 합의된 내용을 종합합니다. 이는 단일 모델 ID로 포장되어 제공됩니다. 새로운 **openrouter/fusion+**를 사용하면 모델 선택기에서부터 완전히 구성할 수 있습니다: 패널, 심사위원, 모델별 도구 호출 예산(tool-call budget), 온도(temperature), 추론 노력(reasoning effort), 그리고 도구 선택(tool-choice)을 지정할 수 있습니다. 플랫폼에 원하는 모델이 없을 때 실용적인 대안이 됩니다.
<div align="center">
<a href="docs/img/fusion-config.webp"><img src="https://raw.githubusercontent.com/thClaws/thClaws/HEAD/docs/img/fusion-config.webp" alt="thClaws — OpenRouter Fusion 패널, 심사위원 및 제한 사항 구성하기" width="860" "/></a>
</div>
문서(Docs): 미디어 도구 · Media Studio · Fusion 설정
최근 배포된 기능 (Recently shipped)
몇 주마다 릴리스됩니다. 전체 이력은 변경 로그(changelog)에서 확인할 수 있으며, 사용자에게 가장 중요할 만한 내용은 다음과 같습니다:
- 엔터프라이즈 정책 + 클라이언트 측 감사 추적 (Enterprise policy + client-side audit trail) — 서명된 조직 정책 파일은 동일한 바이너리를 관리형 클라이언트로 변환합니다: 브랜딩, 확장 허용 목록(extension allow-list), 강제 LLM 게이트웨이, OIDC SSO, 강제 권한 모드, 그리고 모든 도구 호출에 대한 페이로드 없는 기록을 제공합니다. (ENTERPRISE.md · 태국어)
- OS 수준 Bash 격리(confinement), 기본 활성화 — 셸 명령은 커널이 강제하는 파일 시스템 경계(macOS Seatbelt, Linux Landlock, bubblewrap 대체재) 내에서 실행되므로, 난독화된 명령어라 할지라도 작업 공간 외부로 쓸 수 없습니다.
- 태국어 PII 마스킹 (Thai PII masking) — 모델에 도달하기 전에 태국 개인 데이터를 감지하고 토큰화한 다음 출력에서 복원하는 선택적 파이프라인입니다.
- 무비 메이커 (Movie Maker) — 시나리오 → 샷(shots) → 생성된 비디오로, 엔드투엔드로 처리합니다.
- 브라우저 자동화 (Browser automation) — 실제 Chrome 세션을 도구로 구동합니다.
- 워크플로우 (Workflows) — 결정론적 다중 에이전트 스크립트(
/workflow run).
- GUI 셸 (GUI Shells) — 사용자 에이전트와 함께 맞춤형 HTML 표면을 배포하며, 이는 테마가 적용되고 세션, 메모리 및 도구에 연결됩니다.
- thclaws.cloud — 제공업체 키를 보유하고 싶지 않은 사용자를 위한 에이전트 카탈로그, 호스팅 런타임, 그리고 측정 가능한 게이트웨이입니다.
공개적으로 해킹하기 (Hacking in public)
thClaws는 2026년 4월에 시작되었습니다. 그 이후로 100개 이상의 공개 릴리스를 배포했으며, 30명 이상의 기여자가 참여했고, 약 일주일에 한 번씩 릴리스됩니다 — 현재 릴리스 버전은 v0.121.0입니다. 이는 **ThaiGPT Co., Ltd.**의 소규모 팀에 의해 개발되었으며, 코드베이스의 상당 부분은 이 프로젝트에 대해 듣고 남아준 외부 기여자들로부터 왔습니다.
우리는 **v1.0 = "다중 플랫폼 에이전트"**를 목표로 합니다: 데스크톱, 터미널에서 작동하는 동일한 에이전트 루프가 Telegram, Discord, Slack, WhatsApp, Facebook Messenger, 그리고 LINE에 연결됩니다. Telegram, LINE, 및 Messenger는 이미 배포 중입니다. Discord, Slack, 및 WhatsApp이 다음 순서이며 — 이들은 플러그인하기 좋은 곳들입니다. (Contribute →)
태국에서 제작되었습니다. 전 세계를 위해 존재합니다.
네 가지 인터페이스, 하나의 엔진
모든 UX에 걸쳐 동일한 Agent 루프, Session, 및 ToolRegistry가 작동합니다:
- 데스크톱 GUI (
thclaws) — 터미널, 채팅, 파일, 그리고 선택적 팀 탭이 있는 네이티브 창.
- CLI REPL (
thclaws --cli) — SSH, 헤드리스 서버 또는 제로-GUI 워크플로우를 위한 대화형 터미널 프롬프트.
- 비대화형 모드 (
thclaws -p "prompt") — 단일 턴 실행 후 종료됩니다. 스크립트 및 CI에 적합하며, -v는 stderr에서 토큰 사용량을 표시합니다.
- 웹앱 (
thclaws --serve --port 7878) — WebSocket/HTTP를 통해 동일한 엔진을 제공하며, 다른 도구들이 에이전트를 구동할 수 있도록 드롭인 API 인터페이스도 갖추고 있습니다: /v1/chat/completions에서 OpenAI 호환 및 /v1/messages에서 Anthropic 호환합니다. openai 또는 anthropic SDK를 여기에 연결하거나 ANTHROPIC_BASE_URL을 설정하세요. 포트를 열지 않고도 "Claude Code anywhere"를 위한 SSH 터널링이 가능합니다.
기능
모든 것이 하나의 바이너리에 담겨 있습니다. 작업에 맞는 인터페이스를 선택하고, 제공자를 교체하며, 스킬을 추가하고, MCP 서버를 연결한 다음, 예약된 작업이나 백그라운드 에이전트가 작업을 완료할 때까지 자리를 비우세요.