Zaru Get Zaru free

가이드

Zaru CLI: 무엇을 하고 어떻게 설치하나, README를 바탕으로

다른 언어: English, Español, Português, 日本語, Deutsch, Français, 简体中文, Italiano, हिन्दी · 한국어 가이드 전체

공개: Zaru는 100monkeys AI, Inc.가 만들고 있으므로 이 가이드는 만든 쪽의 설명으로 읽어 주세요. 저희 AI 에이전트 하나가 2026년 10월 28일에 읽은 zaru-cli README(영어)의 main 브랜치를 바탕으로 초안을 쓰고 회사가 검토했으며, 이 한국어판은 영어 원문 가이드의 번역입니다. 아래의 모든 명령은 그 README에서 그대로 복사했습니다. README가 답하지 않는 질문은 채워 넣지 않고 그렇다고 밝힙니다.

README를 한 문장으로: "Zaru is an AI assistant that works in your terminal. You give it a task, it asks a language model, and it runs the tools the model asks for: it reads and edits files, runs commands and fetches web pages, asking your permission first."(Zaru는 터미널에서 일하는 AI 어시스턴트입니다. 작업을 주면 언어 모델에 묻고, 모델이 요청한 도구를 실행합니다. 파일을 읽고 고치며, 명령을 실행하고, 웹 페이지를 가져오는데, 먼저 여러분의 허락을 구합니다.) 모든 단계는 cat으로 읽을 수 있는 일반 텍스트 기록에 남습니다.

지금 어느 단계인지 알기

README는 솔직하게 말합니다. "It is pre-alpha: there are no releases and no packages, you build it from source, and commands, files and settings can change without notice."(프리알파 단계입니다. 릴리스도 패키지도 없고, 소스에서 직접 빌드하며, 명령과 파일과 설정은 예고 없이 바뀔 수 있습니다.) Apache-2.0 라이선스의 오픈 소스입니다. 샌드박스도 아닙니다. "Zaru acts on your machine with your user account's permissions."(Zaru는 여러분 사용자 계정의 권한으로 여러분의 컴퓨터에서 행동합니다.) 중요한 것에 쓰기 전에 README의 Safety 절을 읽으세요.

1단계. 요구 사항 확인

2단계. 빌드하고 설치하기

git clone https://github.com/100monkeys-ai/zaru-cli.git
cd zaru-cli
cargo install --path crates/zaru-cli --locked

이렇게 하면 zaru가 ~/.cargo/bin에 들어갑니다. zaru --version을 실행해 동작하는지 확인하세요.

3단계. 모델 고르기

"Zaru has no default model."(Zaru에는 기본 모델이 없습니다.) ~/.zaru/config.toml은 직접 만듭니다. Gemini라면 키를 저장하고(표준 입력에서 읽습니다. 붙여 넣고 Enter를 누른 다음 Ctrl-D) 모델 이름을 적으세요.

zaru providers keys add gemini
[model]
default = "gemini-3.6-flash"

저장된 키는 운영 체제의 키링에 보관된 키로 암호화됩니다. 서버, WSL, 컨테이너처럼 키링이 없는 머신에서는 ZARU_CREDENTIAL_KEY를 소문자 16진수 64자로 설정하고 그 값을 보관하세요. "without it, the keys you stored cannot be read again."(그것이 없으면 저장한 키를 다시 읽을 수 없습니다.) Ollama는 키가 필요 없습니다. [provider.default] 아래에 kind = "ollama"를 설정하면 Zaru가 http://localhost:11434에 연결합니다. OpenAI 호환 서버라면 kind = "openai-compatible"와 그 endpoint를 설정하고, 서버의 모델 목록이 컨텍스트 창 크기를 알려 주지 않으면 context_tokens도 설정하세요.

4단계. 작업 실행하기

zaru "read src/main.rs and tell me what it does"

작업할 디렉터리에서 실행하세요. 샌드박스가 아니라는 경고, 각 도구 호출과 그것이 한 일, 답, "counted by the provider"(제공자가 센) 토큰 수, 그리고 검증기에 관한 안내를 출력합니다. 인자 없이 zaru를 실행하면 대신 대화형 세션이 열리고, zaru --continue는 현재 디렉터리의 마지막 세션을 다시 엽니다.

5단계. 권한 질문에 답하기

파일 쓰기, 편집, 명령, 웹 가져오기 전에 Zaru는 그 호출이 무엇을 할지 보여 주고 [y/N/a ...]라고 묻습니다. y는 한 번 허용하고, a는 바로 그 호출을 세션 동안 허용하며, N, Enter, Esc는 거절하고 작업은 계속됩니다. Ctrl-C는 작업 전체를 멈춥니다. 웹 가져오기는 전체 URL을 보여 줍니다. "because a URL can carry data off your machine"(URL은 데이터를 여러분의 컴퓨터 밖으로 가지고 나갈 수 있기 때문입니다). 물어볼 터미널이 없으면 호출은 거부됩니다. 모드는 기본값이 ask이고, allow는 허용 목록에 있는 것을 묻지 않으며, yolo는 아무것도 묻지 않습니다. README는 이것을 "only for a directory and a task you trust entirely."(완전히 신뢰하는 디렉터리와 작업에만) 쓰라고 합니다.

6단계. 기록 읽기

zaru sessions list
cat ~/.zaru/sessions/<id>/transcript.jsonl

한 줄에 JSON 객체 하나씩입니다. 여러분의 작업, 모델의 각 응답과 모델이 요청한 도구 호출, 각 호출이 허용되었는지, 그 호출이 반환한 내용("exactly as the model was given it", 모델이 받은 그대로), 그리고 답이 들어 있습니다. 저장된 키와 토큰은 무엇이든 기록되기 전에 표식으로 바뀝니다.

7단계. 검증기 추가하기

zaru init은 예시 ./zaru.toml을 씁니다. 검증기는 모델의 작업을 확인하는 명령입니다.

[[validator]]
name = "test"
run = "cargo test"
expect = "exit-zero"

검증기를 선언하면 작업은 반복이 됩니다. 모델이 무언가를 바꾸고, 검증기가 실행되고, 실패는 모델에게 돌아가며, 모두 통과하거나 runtime.max_iterations에 이를 때까지 계속됩니다. 검증기는 여러분이 승인한 뒤에만 실행되고, 바뀌면 다시 묻습니다. "the permission mode does not skip it."(권한 모드도 이 질문을 건너뛰지 않습니다.)

아직 하지 않는 것

README가 답하지 않은 것

관련 가이드

아무것도 빌드하지 않고 Zaru를 쓰고 싶다면, 웹 앱은 무료입니다. "Your name and email. That is all it asks."(이름과 이메일. 그것만 묻습니다.)

Get Zaru free