---
title: zoxide — 스마트 cd
date: 2026-10-18
time: 12:00
model: admin
category: programs
author_type: human
summary: 자주 방문한 디렉터리를 기억하는 스마트 cd. 부분 패턴만으로 바로 이동합니다.
tags: 프로그램, 모던 CLI 도구, zoxide
---

**💬 "zoxide 명령어"**

zoxide는 **자주 방문한 디렉터리를 학습하는 스마트 cd**입니다. 복잡한 전체 경로 대신 짧은 패턴만으로 원하는 디렉터리로 바로 이동합니다.

방문 빈도와 최근성을 기반으로 점수를 매겨 가장 적합한 경로를 선택합니다.

- **개념**: 방문 기록을 바탕으로 디렉터리 이동을 가속화합니다.
- **z 명령**: cd 대신 z를 쓰면 부분 패턴으로 이동합니다.
- **스마트 매칭**: 가장 자주 가던 경로를 우선 제안합니다.
- **셸 통합**: bash·zsh·fish에 자동으로 통합됩니다.
## 설치 및 다운로드

zoxide는 패키지 매니저 또는 스크립트로 설치합니다.

| 환경 | 명령 |
| --- | --- |
| Ubuntu / Debian | sudo apt install zoxide |
| Fedora / RHEL | sudo dnf install zoxide |
| Arch | sudo pacman -S zoxide |
| macOS (brew) | brew install zoxide |
| 스크립트 설치 | curl -sSfL https://raw.githubusercontent.com/ajeetdsouza/zoxide/main/install.sh | sh |
| 바이너리 다운로드 | github.com/ajeetdsouza/zoxide/releases |

설치 후 셸 설정에 `eval "$(zoxide init bash)"`를 추가해야 z 명령이 활성화됩니다.

## 자주 쓰는 옵션

| 옵션 | 설명 |
| --- | --- |
| z <pattern> | 패턴에 맞는 디렉터리로 이동합니다 |
| zi | 대상 디렉터리를 대화형으로 선택합니다 |
| z -e | 실행 파일이 있는 디렉터리만 검색합니다 |
| z -x | 방문 횟수가 적은 디렉터리를 제거합니다 |
| echo $ZOXIDE_SCORE | 점수 체계를 확인합니다 |

## 필수 명령어 조합 3가지

- `z www` — /www 패턴이 포함된 디렉터리로 이동
- `zi` — 대화형 목록에서 디렉터리 선택
- `z -x rarely-used` — 자주 안 가는 디렉터리 기록 정리
**💬 "실제 서버에서 zoxide로 디렉터리를 빠르게 이동하는 예시를 보여줘"**

실제 운영 중인 서버에서 자주 만나는 상황을 순서대로 정리했습니다.

### 1단계 · 설치 및 초기화

설치 후 셸에 통합합니다.

```
sudo apt install -y zoxide && echo 'eval "$(zoxide init bash)"' >> ~/.bashrc && source ~/.bashrc
```

### 2단계 · 디렉터리 기억

자주 가는 디렉터리를 몇 번 방문합니다.

```
cd /var/www/html && cd /etc/nginx && cd /home/ubuntu
```

### 3단계 · 빠른 이동

패턴만으로 이동합니다.

```
z www
```

## 실제 실행 화면

zoxide 설치 후 짧은 패턴으로 디렉터리에 이동한 결과입니다.

![zoxide 명령어 실행 결과](https://games.cursorai.co.kr/assets/zoxide-demo.png)

실제 운영 중인 서버

## 실무에서는 이렇게 씁니다

### 1. 프로젝트 간 전환

**상황** — 여러 프로젝트를 오갈 때 짧은 이름으로 이동합니다.

```
z sks
```

**결과** — /home/jw/coding/commands/sks로 즉시 이동합니다.

**포인트** — 짧은 패턴 하나로 전체 경로를 외울 필요가 없습니다.

### 2. 정리하기

**상황** — 자주 안 가는 디렉터리를 기록에서 제거합니다.

```
z -x old-project
```

**결과** — 기억에서 해당 디렉터리가 제거됩니다.

**포인트** — 기억이 깔끔해져 매칭 정확도가 올라갑니다.

## 실제 실행 화면

대화형 선택(zi)으로 디렉터리를 고른 결과입니다.

![zoxide 명령어 실행 결과 2](https://games.cursorai.co.kr/assets/zoxide-demo2.png)

실제 운영 중인 서버

## 주의할 점

- zoxide init을 셸 설정에 추가하지 않으면 z 명령이 인식되지 않습니다.
- 서버마다 방문 기록이 따로 쌓입니다. 공용 서버에서는 개인별 기록이 다릅니다.
- 매칭이 틀리면 zi로 대화형 목록에서 직접 고를 수 있습니다.
- 기존 cd 별칭과 충돌할 수 있습니다. ~/.bashrc에서 충돌을 확인합니다..

---
원문(HTML): https://games.cursorai.co.kr/programs/linux/modern/zoxide.html