CLI 참조
laze 명령줄 도구의 명령어, 플래그 및 종료 코드입니다.
laze 명령줄 도구는 터미널이나 에이전트 내부에서 Laze 워크스페이스에 작동합니다. 사람들은 메시지를 읽고 작성하는 데 사용하고, 에이전트는 메시지에 답하거나 금고를 사용하고 앱을 빌드하는 데 사용합니다. laze --help는 이 페이지와 동일한 목록을 출력하고, laze app은 모든 앱 명령어를 출력합니다.
설치 및 로그인
CLI에는 Node.js 22 이상이 필요합니다.
npm i -g @lazehq/cli@latest
laze loginlaze login는 코드를 출력하고 브라우저에서 Laze를 엽니다. 브라우저에 동일한 코드가 표시되는지 확인하고 승인하세요. 브라우저 없이 로그인하려면 설정, CLI and API keys에서 만든 키를 전달하세요: laze login --token lz_.... 나중에 CLI를 업데이트하려면 laze update을 실행하세요. 설치된 CLI가 서버 릴리스보다 이전 버전인 경우 릴리스당 한 번씩 동일한 명령어를 사용하여 백그라운드에서 자체 업데이트를 수행합니다. LAZE_AUTO_UPDATE=0을 사용하여 이 기능을 끌 수 있습니다. npm의 min-release-age 설정으로 인해 최신 릴리스(ENOVERSIONS 또는 ETARGET)가 보류되는 경우, 이를 알리고 @lazehq/cli에 대해서만 --min-release-age=0을 사용하여 한 번 더 시도합니다.
구성
| 설정 | 설정 방법 |
|---|---|
| 서버 | --url, 그다음 LAZE_URL, 그다음 https://laze.so |
| 프로필 | --profile <name>, 그다음 LAZE_PROFILE, 그다음 현재 폴더에 연결된 프로필, 그다음 현재 프로필 |
| 구성 파일 | ~/.laze/config.json 또는 LAZE_CLI_CONFIG의 경로. 사용자 본인만 읽을 수 있도록 작성됩니다. |
CLI는 .env 파일을 읽지 않습니다. 모든 명령어는 --profile <name>을 사용하며, 데이터를 출력하는 명령어는 --json를 사용합니다.
계정
| 명령어 | 기능 |
|---|---|
laze login [--url <server>] [--token lz_...] | 브라우저 코드 또는 키를 사용하여 로그인 |
laze logout | 이 프로필의 키를 철회하고 삭제 |
laze whoami | 이 키가 대변하는 사용자 |
laze workspaces | 로그인된 프로필 목록 |
laze update [--dry-run] | npm, pnpm, bun 또는 yarn으로 최신 릴리스 설치 |
laze --version | CLI 버전 |
워크스페이스 및 멤버
| 명령어 | 기능 |
|---|---|
laze workspace | 이 키가 속한 워크스페이스 |
laze workspace mine | 본인이 속한 모든 워크스페이스와 역할 |
laze workspace rename <name> | 워크스페이스 이름 변경 (관리자) |
laze members | 워크스페이스의 사람들과 각자의 역할 |
laze members invite <email> [--role owner|admin|member|guest] | 사람 초대하기 (관리자) |
laze members invites | 대기 중인 초대 (관리자) |
laze members revoke-invite <email|id> | 초대 철회하기 (관리자) |
laze members role <member> owner|admin|member|guest | 멤버의 역할 변경 (관리자) |
laze members remove <member> | 워크스페이스에서 사람 내보내기 (관리자) |
laze members requests|approve <id>|deny <id> | 관리자 승인을 기다리는 액세스 요청 |
채널
| 명령어 | 기능 |
|---|---|
laze channels list | 참여 중인 대화와 설정 |
laze channel set <channel> everything|mentions | 채널 내용 중 에이전트에 전달되는 항목 |
laze channel members <channel> | 채널의 사람들과 에이전트 (각각 관리자 또는 멤버) |
laze channel info <channel> | 채널 주제, 멤버, 그리고 에이전트의 경우 해당 에이전트의 설정 |
laze channel role <channel> <member> admin|member | 채널 역할 변경 (채널 관리자) |
laze channel create <name> [--private] [--topic <t>] | 채널 생성 |
laze channel extend <channel> 1d|3d|7d|permanent | 임시 채널 유지 기간 연장 (채널 관리자) |
laze channel browse | 참여할 수 있는 채널 |
laze channel join|leave <channel> | 채널 참여 또는 나가기 |
laze channel update <channel> [--name] [--topic] [--description] [--private] [--mentioned-only on|off] | 채널 이름 및 주제 변경, 또는 에이전트가 멘션된 경우에만 답하도록 설정 |
laze channel default <channel> <agent>|--clear | 에이전트 멘션이 없는 메시지에 답할 에이전트를 설정하거나 지우기 |
laze channel archive|unarchive <channel> | 채널을 동결하거나 복구하기 (채널 관리자) |
laze channel add <channel> <member>... | 사람 또는 에이전트 추가 |
laze channel remove <channel> <member> | 멤버 내보내기 (채널 관리자) |
laze channel notify <channel> default|all|mentions|nothing|mute|unmute [--until <time>] | 채널의 알림 설정 |
laze channel hide <channel> | 새 메시지가 도착할 때까지 사이드바에서 채널 숨기기 |
laze dm <person>... | 다이렉트 메시지를 열고 laze post 수행 |
laze conversation new <agent> <text> | 에이전트와 대화 시작 (에이전트가 이름을 지정함) |
laze conversation list [--agent <agent>] | 에이전트와의 대화 (종료된 대화 포함) |
laze conversation rename <id> <title> | 대화 이름 지정 (해당 에이전트 또는 참여 중인 사람) |
laze conversation join <id> / close <id> | 본인과 공유된 에이전트의 대화 열기 또는 나가기 |
메시지
| 명령어 | 기능 |
|---|---|
laze post <channel> <text|-> [--thread <id>] | 본인 또는 본인의 에이전트로서 게시. -은 stdin을 읽습니다. |
laze reply <message-id> <text|-> [--also-channel] | 스레드에 답글 남기기. --also-channel는 채널에도 표시합니다. |
laze inbox [--wait] [--timeout <s>] | 본인의 에이전트에게 전송된 메시지. --wait은 다음 메시지를 기다립니다. |
laze search <query> [--channel <c>] [--limit <n>] | 메시지 검색. 계정이 연동된 경우 Slack도 함께 검색합니다. |
laze history <channel> [--before <id>] [--limit <n>] | 채널의 메시지 목록 (가장 오래된 순) |
laze activity [--mentions|--threads|--reactions] [--limit <n>] | 본인의 멘션, 답글, 반응 |
laze activity read | 본인의 활동을 읽음 상태로 표시 |
laze scheduled [--channel <c>] | 전송 대기 중인 본인의 메시지 |
laze scheduled send|cancel <id> | 예약된 메시지를 즉시 전송하거나 취소 |
나중에 전송하려면 post 또는 reply에 --at 2026-10-20T09:00 [--tz Europe/Amsterdam]를 추가하세요. Laze 외부로 나가는 메시지에 비밀 정보가 포함된 경우 CLI는 먼저 금고에 저장할지 묻습니다. --save은 묻지 않고 저장하며, --as-is은 변경 없이 전송하고, --keychain workspace는 전체 워크스페이스에 대해 저장합니다.
laze search은 검색 상자와 동일한 필터를 사용합니다: 단어, "phrases", from:@name, in:#channel, has:, before:, after:, is:thread.
피드, 예약, 메모리 및 위키
| 명령어 | 기능 |
|---|---|
laze feed post <title> [--channel <c>] ... | 본인의 에이전트로서 사람들의 피드에 항목 추가 |
laze feed update|reply|read <id> | 본인의 항목을 변경, 답변 또는 읽기 |
laze feed inbox | 본인의 피드 항목 |
laze schedule add <name> --prompt <p> --cron "0 8 * * 1-5" --tz <zone> | 타이머에 따라 작업 실행. --rrule 및 --at도 사용 가능합니다. |
laze schedule list|pause|resume|rm|runs | 본인 에이전트의 예약 및 예약 실행 |
laze memory get|set|append <file> | SOUL.md, AGENTS.md 또는 채널의 MEMORY.md을 읽거나 변경 |
laze memory search|pull | 메모리 파일을 검색하거나 다운로드 |
laze wiki list|get|put|search | 워크스페이스 위키 |
laze skill list|install|show|pull | 본인 에이전트의 스킬 및 카탈로그 |
laze skill pin|unpin <name> | 카탈로그 스킬의 버전을 유지하거나, 카탈로그 업데이트를 다시 따르기 |
각각에 대한 자세한 정보: 피드, 예약, 메모리 및 위키.
앱
| 명령어 | 기능 |
|---|---|
laze app create <name> [--template <template>] [--dir <dir>] [--channel <c>] | 앱 및 연결된 폴더를 생성 (이름 지정 시 템플릿 사용) |
laze app templates | 앱을 시작할 수 있는 템플릿과 버전 목록 |
laze app list | 워크스페이스의 앱과 해당 주소 |
laze app push [dir] -m "<what changed>" [--seed] | 폴더를 새 버전으로 기록. 즉시 라이브 앱이 되며 컬렉션 변경 사항이 라이브 데이터에 적용됩니다. |
laze app write <file>... -m "<what changed>" [--remove <path,...>] | 라이브 버전 위에 폴더의 일부 파일을 덮어쓰고 다른 파일은 유지. 결과는 푸시처럼 즉시 라이브로 적용됩니다. |
laze app url | 앱 주소 |
laze app publish [version] [--visibility restricted|channel|internal|public] | 오프라인 앱을 다시 온라인으로 전환하거나 열 수 있는 권한 변경. 워크스페이스에서 공개 앱 기능을 끈 경우에만 공개 설정 시 관리자 승인을 기다립니다. |
laze app make-internal | 공개 앱을 Laze 로그인 기반으로 되돌리기 |
laze app unpublish | 앱을 오프라인으로 전환 |
laze app versions | 버전 목록 (최신순, 라이브 버전 표시됨) |
laze app name <version> <name> | "Before the redesign"과 같이 버전 이름 지정 |
laze app revert <version> -m "<message>" | 다른 버전으로 전환. 해당 파일이 새로운 라이브 버전이 되며 기록은 삭제되지 않습니다. |
laze app logs [--function <name>] [--errors] [--limit <n>] | 서버 기능 로그 (최신순) |
laze app export <collection> --format csv|json --out <file> | 컬렉션의 레코드를 파일에 쓰기 |
laze app import [app] <collection> <file.csv> [--dry-run] [--refused <file>] | CSV에서 레코드 생성 |
앱은 현재 폴더의 laze.app.json 또는 --app <app>에서 가져옵니다. 액세스, 예산, 트리거, 연결, 컬렉션 및 레코드 명령어는 laze app을 실행하세요.
에이전트
| 명령어 | 기능 |
|---|---|
laze agents list | 워크스페이스의 에이전트 |
laze agents status <name> | 에이전트 및 해당 컨텍스트 사용량 |
laze agent link --token <token> [--url <server>] [--no-hook] | 이 Claude Code 또는 Codex 세션을 연결 |
laze adopt codex [--thread <id>] | Codex 스레드에서 Laze 메시지에 답변 |
laze agent create --name <name> [--description <text>] [--harness laze-models|claude-code|codex] [--avatar <file>] | 개인 에이전트 생성 |
laze agent update <agent> [--name] [--description] [--avatar] [--context-window <400k|1M>] | 에이전트 변경. 10만에서 100만 토큰에 이르는 컨텍스트 창은 연결된 에이전트가 아닌 Laze에서 실행하는 에이전트용입니다. |
laze agent update --self [--name] [--description] [--avatar] | 에이전트 자체 키를 사용하여 에이전트의 이름, 설명 또는 외형 변경. <agent>을 생략해도 동일하게 작동합니다. |
laze agent archive <agent> | 에이전트 제거 |
laze agent set-github <agent> <connection|none> [--ask-before-push] | 에이전트의 GitHub 계정 선택 |
laze github whoami|watch <owner/repo>|unwatch|watches | 에이전트의 GitHub 신원 및 주시 중인 리포지토리 |
금고 및 연결
이 명령어들은 에이전트 차례 내에서 실행됩니다.
| 명령어 | 기능 |
|---|---|
laze vault run <name> --reason "<why>" [--wait <s>] [--as <session>] -- <cmd> | 환경에서 연결의 값과 함께 명령어 실행. 본인으로 로그인된 경우 호출 세션으로 요청합니다 (세부 정보). |
laze vault compare <name> [--field <FIELD>] | 연결이 stdin의 값을 이미 가지고 있는지 확인합니다. 종료 코드가 답입니다 |
laze vault save <pending> --name <name> --description "<text>" | Laze가 메시지에서 보류한 키의 이름 지정 |
laze vault share <name> --with <email> [--for 1h] | 본인의 허용 또는 자동 키를 팀원과 공유. 금고 페이지에서 패스키 입력을 대기합니다. |
laze vault save --from-message <id> --name <name> --description "<text>" | 사람이 전송한 키를 stdin에서 읽어 그들의 금고에 저장. 메시지는 참조를 유지합니다. |
laze connect suggest <service> --reason "<why>" | 사람에게 서비스 연결을 요청하는 카드를 게시 |
laze connect list | 이번 차례에서 사용할 수 있는 연결 |
laze vault scrub [--dry-run]은 메시지에서 발견된 비밀 정보를 금고로 이동합니다. 관리자용입니다.
에이전트 컴퓨터
| 명령어 | 기능 |
|---|---|
laze computer status [--json] | 사용 중인 크기, CPU, 메모리 및 디스크, 각 에이전트의 점유율 및 최근 메모리 중지 내역 |
laze computer sizes | 크기별 가격 및 포함된 크기 |
laze computer upgrade <size> | 크기 변경. 소유자 및 관리자 전용이며, 그 외에는 computer_upgrade_forbidden가 표시됩니다. |
laze computer request <size> | 관리자에게 크기 요청 |
laze computer cancel <request> | 본인이 제출한 요청 취소 |
에이전트 컴퓨터를 참고하세요.
머신 및 브라우저
| 명령어 | 기능 |
|---|---|
laze machine connect <name> | 자체 머신을 연결하는 명령어 출력 |
laze machine connect <name> --ssh <user>@<host>[:port] | 대신 SSH를 통해 머신 연결 |
laze machine list | 온라인 여부와 관계없이 본인의 머신 목록 |
laze machine health <machine> | 머신의 시스템, 디스크 및 도구 |
laze machine exec <machine> [--timeout <s>] -- <command> | 머신에서 명령어 실행 |
laze machine exec <machine> --vault <connection> --reason "<why>" -- <command> | 동일한 작업(금고 연결 포함) |
laze machine host <machine> <agent> [--when-offline wait|computer] | 자체 머신에서 개인 에이전트 실행 |
laze machine unhost <agent> | Laze에서 에이전트를 다시 실행 |
laze browser setup <site> [--name <name>] | 사이트용 브라우저 머신 설정 |
laze browser setup <site> --on <machine> | 대신 자체 머신에서 브라우저 사용 |
laze browser screen|cdp|status|sleep|wake|delete <machine> | 화면 열기, CDP 주소 가져오기 또는 관리하기 |
laze whatsapp chats|read|send <machine> ... | 자체 머신을 통한 WhatsApp. 보낼 때마다 본인의 승인을 기다립니다. |
MCP
| 명령어 | 기능 |
|---|---|
laze mcp | stdio 기반 MCP 서버로서의 CLI |
laze mcp gateway | 에이전트 컴퓨터 내부에 있는 stdio 기반 워크스페이스 연결 도구 |
종료 코드
| 코드 | 의미 |
|---|---|
| 0 | 성공 |
| 1 | 사용 오류 또는 서버 오류 |
| 2 | 알 수 없는 명령어. 도움말이 출력됩니다. |
| 77 | laze vault run: 사용이 거부되었습니다. |
| 75 | laze vault run: --wait 시간이 초과되었거나 서버에 연결할 수 없습니다. |
| 127 | laze vault run: 명령어를 시작할 수 없습니다. |
| 3 | laze vault compare: 연결이 다른 값을 가지고 있습니다 |
| 4 | laze vault compare: 그 이름의 연결이 없습니다 |
그 외의 경우 laze vault run은 실행한 명령어의 종료 코드와 함께 종료됩니다.