<img src="https://raw.githubusercontent.com/PyModel/pythinker-code/main/docs/media/pythinker_animated.svg" alt="Pythinker logo" width="34" align="top"> Pythinker Code

데스크톱 앱으로 실행 가능한 코딩 에이전트

Downloads

macOS

Windows

Node.js

visitors

<a href="#get-the-desktop-app">다운로드</a>  · 
<a href="#what-the-agent-can-do">기능</a>  · 
<a href="#in-the-terminal">터미널에서 사용하기</a>  · 
<a href="#in-your-editor">에디터에서 사용하기</a>  · 
<a href="#development">개발하기</a>

데스크톱 앱 사용하기

macOS 또는 Windows용 다운로드

앱을 설치하고 열어 작업을 설명하면, Pythinker는 마치 동료가 작업하는 것처럼 프로젝트에서 작동합니다: 코드를 읽고, 파일을 변경하며, 명령어를 실행하고, 무슨 일이 일어났는지 확인하고, 작업이 완료될 때까지 계속 진행합니다.

이 앱은 에이전트 전체를 사용자의 기기에서 실행합니다. 루프백에 바인딩된 로컬 호스트를 시작하므로 네트워크에 노출되는 것이 없습니다. 창을 닫아도 앱이 종료되지 않고 트레이로 숨겨지므로, 긴 세션이 유지됩니다.

이미 CLI(Command Line Interface)를 사용하고 있다면, 이 앱은 동일한 데이터 디렉터리(~/.pythinker-code/가 기본값)를 가져옵니다. 로그인 정보, 제공업체(providers), MCP 서버 및 이전 세션들이 이미 그곳에 있습니다. 업데이트는 스스로 설치되며, 설정(Settings)에서 원치 않을 경우 비활성화할 수 있는 스위치가 있습니다.

macOS용으로는 .dmg 파일을 받게 됩니다. Windows용으로는 관리자 권한을 요청하지 않는 사용자별 설치 프로그램이 제공됩니다. 아직 Linux 빌드는 없으므로, Linux에서는 터미널 버전을 사용하거나 브라우저 인터페이스를 위해 pythinker web을 실행하세요.

더 자세한 내용은 데스크톱 가이드를 참고하세요.

에이전트가 할 수 있는 것들

아래 모든 기능은 앱, 터미널, 편집기에서 동일하게 작동합니다.

실제 코드베이스 작업하기

Pythinker는 사용자의 리포지토리를 검색하고 읽고, 파일을 수정하며, 셸 명령을 실행하고, 그 출력을 읽은 다음 다음에 무엇을 할지 결정합니다. 테스트를 실행하고 실패 내용을 읽으며 다시 시도합니다. 모듈 리팩터링, 버그 추적, 누락된 테스트 작성 등을 요청해보고, 편안하게 느낄 수 있는 만큼 자유롭게 맡겨보세요.

서브 에이전트 간 업무 분할

큰 작업은 위임됩니다. coder 서브 에이전트는 범위가 지정된 수정 작업을 수행하고, explore는 익숙하지 않은 리포지토리를 매핑하며, plan은 접근 방식을 설계합니다. 이들은 각자의 컨텍스트에서 병렬로 실행되므로, 메인 대화가 파일 덤프로 가득 차기보다는 읽기 쉬운 상태를 유지합니다.

도구에 대한 통제력 유지하기

도구가 실행되기 전에 호출을 보고 사용자가 승인할 수 있습니다. 권한 모델은 지루한 호출들을 미리 승인하고 위험한 호출들은 보류할 수 있게 합니다. 라이프사이클 이벤트에서 훅(Hooks)이 발생하므로, 명령을 차단하거나 결정을 기록하거나 자체 시스템에서 무언가를 트리거할 수 있습니다.

자신만의 도구와 지침 로드하기

/mcp-config를 사용하면 세션 내에서 stdio 또는 HTTP를 통해 Model Context Protocol 서버를 추가하고 인증하며, 다음을 위해 기억합니다. 스킬(Skills)은 /skill:<이름>으로 온디맨드 로드되는 리포지토리 로컬 지침 파일입니다. 플러그인(Plugins)은 마켓플레이스나 GitHub에서 직접 스킬, 서버, 데이터 소스를 묶어 제공합니다.

원하는 모델 사용하기

Pythinker 모델은 기본적으로 작동합니다. 다른 제공업체들은 OpenAI와 호환되는 엔드포인트나 로컬 엔드포인트를 포함한 구성을 통해 작동합니다.

설명하는 대신 보여주기

버그를 글로 쓰는 것보다 화면 녹화로 보여주는 것이 더 쉬울 때, 대화에 스크린 레코딩을 첨부하세요.

터미널에서

CLI는 네이티브 바이너리로 제공되므로 Node.js 전제 조건이 없습니다.

2.2.0–2.4.1 버전에서 네이티브 설치를 했나요? pythinker update로는 새 버전을 다운로드할 수 없습니다. 최신 버전을 받으려면 설치 명령을 다시 실행하세요(#354).

cd your-project
pythinker

최초 실행 시 /login을 실행하고 OAuth 또는 API 키를 선택하세요. 그런 다음 실제 질문을 해보세요:

Find where authentication is handled and add a unit test for the token refresh path.

[!NOTE]
Windows에서는 먼저 Git for Windows를 설치하세요. Pythinker는 내장된 Git Bash를 셸로 사용합니다. 다른 셸을 지정하려면 PYTHINKER_SHELL_PATH에 bash.exe의 전체 경로를 설정하세요.

에디터에서 사용하기

Pythinker는 Agent Client Protocol을 지원하므로, Zed, JetBrains 및 기타 ACP(Agent Client Protocol) 편집기에서 전체 세션을 인라인으로 호스팅할 수 있습니다. CLI에서 한 번 로그인한 후, 에디터가 pythinker acp를 가리키도록 설정하세요.

~/.config/zed/settings.json에 추가:

{
  "agent_servers": {
    "Pythinker Code": {
...

IDE에서 사용하기에서는 JetBrains 설정과 기능 매트릭리를 다루고 있습니다.

문서

개발

Pythinker Code는 pnpm 모노레포입니다. 데스크톱 앱과 CLI 모두 SDK와 통신하며, 엔진 패키지에는 직접 연결하지 않습니다.

git clone https://github.com/PyModel/pythinker-code.git
cd pythinker-code
pnpm install
...

기여 (Contributing)

버그 보고, PR(Pull Request), 플러그인, 스킬, 문서화 모두 환영합니다. CONTRIBUTING.md부터 시작하고, 취약점을 보고하기 전에 SECURITY.md를 읽어보세요.

대규모 리팩토링이나 API 변경을 하기 전에는 이슈(issue)를 생성하세요. Conventional Commits를 사용하고, PR이 릴리스 아티팩트에 영향을 미칠 경우 changeset(pnpm changeset)를 추가하며, diff를 설명할 준비가 되어 있어야 합니다. AI 지원 PR도 수작업으로 작성된 PR과 동일한 기준을 적용받습니다.

라이선스 (License)

MIT. LICENSE 참조.

저희 TUI는 pi-tui를 기반으로 구축되었습니다. 저자분들께 감사드립니다.

code.pythinker.com  · 
다운로드  · 
npm  · 
문서