From 8325f88ec194aa333aa4c32f28f3a77ae6bebbe0 Mon Sep 17 00:00:00 2001
From: JungHee Lee <36289819+MarongHappy@users.noreply.github.com>
Date: Wed, 27 May 2026 04:33:41 +0900
Subject: [PATCH] Create chwd.mdx

---
 src/content/docs/ko/features/chwd/chwd.mdx | 90 ++++++++++++++++++++++
 1 file changed, 90 insertions(+)
 create mode 100644 src/content/docs/ko/features/chwd/chwd.mdx

diff --git a/src/content/docs/ko/features/chwd/chwd.mdx b/src/content/docs/ko/features/chwd/chwd.mdx
new file mode 100644
index 00000000..bce9e34e
--- /dev/null
+++ b/src/content/docs/ko/features/chwd/chwd.mdx
@@ -0,0 +1,90 @@
+---
+title: chwd로 하드웨어 관리하기
+description: CachyOS를 위한 하드웨어 감지 및 구성
+---
+
+[CachyOS Hardware Detection](https://github.com/CachyOS/chwd/)(보통 `chwd`로 더 잘 알려져 있음)는 실행 중인 시스템에 필요한 패키지와 드라이버를 설치하여 다양한 하드웨어를 사용할 수 있게 해줍니다. 여기에는 NVIDIA 그래픽 카드를 사용하는 시스템, T2 MacBook, Steam Deck 및 ROG Ally 같은 휴대용 장치가 포함됩니다.
+
+## 사용법
+
+`chwd`는 일반적으로 설치 중에 실행되어 시스템에 필요한 패키지를 제공합니다. 하지만 설치 후에도 사용할 수 있습니다.
+
+### 자동 구성
+
+`chwd`는 시스템이 최적의 조건에서 작동할 수 있도록 필요한 드라이버와 패키지의 설치 및 구성을 지원합니다.
+
+```sh
+sudo chwd -a
+```
+
+### 프로필 설치
+
+위 방법 대신 특정 프로필을 개별적으로 설치할 수도 있습니다.
+
+```sh title='사용 가능한 모든 프로필 나열'
+chwd --list-all
+> All PCI profiles:
+╭─────────────────────────┬──────────╮
+│ Name                    ┆ Priority │
+╞═════════════════════════╪══════════╡
+│ nouveau                 ┆ 18       │
+├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┤
+│ nvidia-dkms-470xx       ┆ 14       │
+├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┤
+│ nvidia-dkms-580xx       ┆ 12       │
+├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┤
+│ nvidia-open-dkms        ┆ 10       │
+├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┤
+│ macbook-t2              ┆ 9        │
+├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┤
+│ virtualmachine          ┆ 5        │
+├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┤
+│ amd                     ┆ 4        │
+├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┤
+│ intel                   ┆ 4        │
+├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┤
+│ fallback                ┆ 3        │
+├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┤
+│ handheld.intel-msi-claw ┆ 2        │
+├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┤
+│ handheld.rog-ally       ┆ 2        │
+├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┤
+│ handheld.steam-deck     ┆ 2        │
+├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┤
+│ handheld                ┆ 1        │
+├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┤
+│ broadcom-wl             ┆ 1        │
+╰─────────────────────────┴──────────╯
+```
+
+```sh title='chwd 프로필 설치'
+sudo chwd -i amd
+> Installing amd ...
+
+> Successfully installed amd
+```
+
+### 기타
+
+명령어 문법과 다른 사용법은 `chwd`의 도움말 출력을 참고하세요.
+
+```sh
+chwd --help
+Usage: chwd [OPTIONS]
+
+Options:
+  -i, --install <profile>          Install profile
+  -r, --remove <profile>           Remove profile
+  -d, --detail                     Show detailed info for listings
+  -f, --force                      Force reinstall
+      --list-installed             List installed kernels
+      --list                       List available profiles for all devices
+      --list-all                   List all profiles
+  -a, --autoconfigure [<classid>]  Autoconfigure
+      --ai_sdk                     Toggle AI SDK profiles
+      --pmcachedir <PMCACHEDIR>    [default: /var/cache/pacman/pkg]
+      --pmconfig <PMCONFIG>        [default: /etc/pacman.conf]
+      --pmroot <PMROOT>            [default: /]
+  -h, --help                       Print help
+  -V, --version                    Print version
+```