diff --git a/README.md b/README.md
index 8bf464c..29c1030 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,49 @@
 # hermes
+
+Hermes Agent 部署與使用筆記。
+
+## 部署位置
+
+| 項目 | 值 |
+|------|----|
+| 主機 | `192.168.42.109` (root) |
+| 安裝路徑 | `/root/.hermes` |
+| 版本 | hermes-agent v0.17.0 |
+| 進入點 | `/usr/local/bin/hermes` → `/root/.hermes/hermes-agent/venv/bin/hermes` |
+
+## 模型 / API
+
+走 Z.AI GLM（設定於 `/root/.hermes/config.yaml`）：
+
+```yaml
+model:
+  default: glm-5.1
+  provider: zai
+  base_url: https://api.z.ai/api/paas/v4
+```
+
+API key 存於 `/root/.hermes/.env` 的 `GLM_API_KEY`（同步進 `auth.json` 的 zai credential pool）。
+
+## 使用
+
+```bash
+ssh root@192.168.42.109
+hermes                 # 進互動 chat
+hermes -z "你的問題"    # 一次性問答
+hermes model           # 換模型 / provider
+hermes status          # 狀態
+hermes --help          # 所有子指令
+```
+
+## 本機 Claude Code（此 repo）
+
+在這個 repo 目錄用 Claude Code 時，模型也走同一個 GLM 端點（Anthropic 相容）：
+
+- `.claude/settings.json` — `ANTHROPIC_BASE_URL=https://api.z.ai/api/anthropic`
+- `.claude/settings.local.json` — `ANTHROPIC_AUTH_TOKEN`（機密，已 gitignore）
+
+env 在啟動時讀取，改完需重開 Claude Code 生效。
+
+## 已知問題
+
+- `.tirith-install-failed`（download_failed）：非核心元件下載失敗，不影響 chat。