20以下是一個[多行狀態列](#display-multiple-lines)的範例,在第一行顯示 git 資訊,在第二行顯示顏色編碼的 context 列。20以下是一個[多行狀態列](#display-multiple-lines)的範例,在第一行顯示 git 資訊,在第二行顯示顏色編碼的 context 列。
21 21
22<Frame>22<Frame>
23 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-multiline.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=60f11387658acc9ff75158ae85f2ac87" alt="多行狀態列,在第一行顯示模型名稱、目錄、git 分支,在第二行顯示 context 使用進度列、成本和持續時間" width="776" height="212" data-path="images/statusline-multiline.png" />23 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-multiline.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=a9d0a2fe8e446d80b1abc46da3f93270" alt="多行狀態列,在第一行顯示模型名稱、目錄、git 分支,在第二行顯示 context 使用進度列、成本和持續時間" width="1224" height="262" data-path="images/statusline-multiline.png" />
24</Frame>24</Frame>
25 25
26本頁面介紹[設定基本狀態列](#set-up-a-status-line)、說明[資料如何從 Claude Code 流向您的指令碼](#how-status-lines-work)、列出[您可以顯示的所有欄位](#available-data),並提供[常見模式的現成範例](#examples),例如 git 狀態、成本追蹤和進度列。26本頁面介紹[設定基本狀態列](#set-up-a-status-line)、說明[資料如何從 Claude Code 流向您的指令碼](#how-status-lines-work)、列出[您可以顯示的所有欄位](#available-data),並提供[常見模式的現成範例](#examples),例如 git 狀態、成本追蹤和進度列。
93這些範例使用 Bash 指令碼,適用於 macOS 和 Linux。在 Windows 上,請參閱 [Windows 設定](#windows-configuration)以取得 PowerShell 和 Git Bash 範例。93這些範例使用 Bash 指令碼,適用於 macOS 和 Linux。在 Windows 上,請參閱 [Windows 設定](#windows-configuration)以取得 PowerShell 和 Git Bash 範例。
94 94
95<Frame>95<Frame>
96 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-quickstart.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=696445e59ca0059213250651ad23db6b" alt="狀態列顯示模型名稱、目錄和 context 百分比" width="726" height="164" data-path="images/statusline-quickstart.png" />96 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-quickstart.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=88a7eab9c1038dd098ee8e284d96b7e6" alt="狀態列顯示模型名稱、目錄和 context 百分比" width="1224" height="224" data-path="images/statusline-quickstart.png" />
97</Frame>97</Frame>
98 98
99<Steps>99<Steps>
444顯示目前模型和 context window 使用情況,帶有視覺進度列。每個指令碼從 stdin 讀取 JSON,提取 `used_percentage` 欄位,並建立一個 10 字元的列,其中填充的塊(▓)代表使用情況:444顯示目前模型和 context window 使用情況,帶有視覺進度列。每個指令碼從 stdin 讀取 JSON,提取 `used_percentage` 欄位,並建立一個 10 字元的列,其中填充的塊(▓)代表使用情況:
445 445
446<Frame>446<Frame>
447 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-context-window-usage.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=15b58ab3602f036939145dde3165c6f7" alt="狀態列顯示模型名稱和帶有百分比的進度列" width="448" height="152" data-path="images/statusline-context-window-usage.png" />447 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-context-window-usage.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=f3918a549912dc47e90f2b69e68bc847" alt="狀態列顯示模型名稱和帶有百分比的進度列" width="1224" height="224" data-path="images/statusline-context-window-usage.png" />
448</Frame>448</Frame>
449 449
450<CodeGroup>450<CodeGroup>
513顯示 git 分支,帶有暫存和修改檔案的顏色編碼指示器。此指令碼使用 [ANSI 逃逸碼](https://en.wikipedia.org/wiki/ANSI_escape_code#Colors)表示終端顏色:`\033[32m` 是綠色,`\033[33m` 是黃色,`\033[0m` 重設為預設值。513顯示 git 分支,帶有暫存和修改檔案的顏色編碼指示器。此指令碼使用 [ANSI 逃逸碼](https://en.wikipedia.org/wiki/ANSI_escape_code#Colors)表示終端顏色:`\033[32m` 是綠色,`\033[33m` 是黃色,`\033[0m` 重設為預設值。
514 514
515<Frame>515<Frame>
516 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-git-context.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=e656f34f90d1d9a1d0e220988914345f" alt="狀態列顯示模型、目錄、git 分支和暫存和修改檔案的彩色指示器" width="742" height="178" data-path="images/statusline-git-context.png" />516 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-git-context.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=f13c190724d9ec7188c17cd2f98b7bf4" alt="狀態列顯示模型、目錄、git 分支和暫存和修改檔案的彩色指示器" width="1224" height="224" data-path="images/statusline-git-context.png" />
517</Frame>517</Frame>
518 518
519每個指令碼檢查目前目錄是否是 git 儲存庫,計算暫存和修改檔案,並顯示顏色編碼的指示器:519每個指令碼檢查目前目錄是否是 git 儲存庫,計算暫存和修改檔案,並顯示顏色編碼的指示器:
611每個指令碼將成本格式化為貨幣,並將毫秒轉換為分鐘和秒:611每個指令碼將成本格式化為貨幣,並將毫秒轉換為分鐘和秒:
612 612
613<Frame>613<Frame>
614 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-cost-tracking.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=e3444a51fe6f3440c134bd5f1f08ad29" alt="狀態列顯示模型名稱、工作階段成本和持續時間" width="588" height="180" data-path="images/statusline-cost-tracking.png" />614 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-cost-tracking.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=925f7024c3b38be0f0eca63564bfb52f" alt="狀態列顯示模型名稱、工作階段成本和持續時間" width="1224" height="224" data-path="images/statusline-cost-tracking.png" />
615</Frame>615</Frame>
616 616
617<CodeGroup>617<CodeGroup>
672您的指令碼可以輸出多行以建立更豐富的顯示。672您的指令碼可以輸出多行以建立更豐富的顯示。
673 673
674<Frame>674<Frame>
675 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-multiline.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=60f11387658acc9ff75158ae85f2ac87" alt="多行狀態列,在第一行顯示模型名稱、目錄、git 分支,在第二行顯示 context 使用進度列、成本和持續時間" width="776" height="212" data-path="images/statusline-multiline.png" />675 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-multiline.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=a9d0a2fe8e446d80b1abc46da3f93270" alt="多行狀態列,在第一行顯示模型名稱、目錄、git 分支,在第二行顯示 context 使用進度列、成本和持續時間" width="1224" height="262" data-path="images/statusline-multiline.png" />
676</Frame>676</Frame>
677 677
678此範例結合了多種技術:基於閾值的顏色(70% 以下為綠色,70-89% 為黃色,90%+ 為紅色)、進度列和 git 分支資訊。每個 `print` 或 `echo` 陳述式建立單獨的行:678此範例結合了多種技術:基於閾值的顏色(70% 以下為綠色,70-89% 為黃色,90%+ 為紅色)、進度列和 git 分支資訊。每個 `print` 或 `echo` 陳述式建立單獨的行:
781此範例建立指向您的 GitHub 儲存庫的可點擊連結。按住 Cmd(macOS)或 Ctrl(Windows/Linux)並點擊以在瀏覽器中開啟連結。781此範例建立指向您的 GitHub 儲存庫的可點擊連結。按住 Cmd(macOS)或 Ctrl(Windows/Linux)並點擊以在瀏覽器中開啟連結。
782 782
783<Frame>783<Frame>
784 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-links.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=4bcc6e7deb7cf52f41ab85a219b52661" alt="狀態列顯示指向 GitHub 儲存庫的可點擊連結" width="726" height="198" data-path="images/statusline-links.png" />784 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-links.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=4778a144a28cb498c99d5fa018bb374a" alt="狀態列顯示指向 GitHub 儲存庫的可點擊連結" width="1224" height="224" data-path="images/statusline-links.png" />
785</Frame>785</Frame>
786 786
787每個指令碼取得 git 遠端 URL,將 SSH 格式轉換為 HTTPS,並將儲存庫名稱包裝在 OSC 8 逃逸碼中。Bash 版本使用 `printf '%b'`,它比 `echo -e` 更可靠地跨不同 shell 解釋反斜杠逃逸:787每個指令碼取得 git 遠端 URL,將 SSH 格式轉換為 HTTPS,並將儲存庫名稱包裝在 OSC 8 逃逸碼中。Bash 版本使用 `printf '%b'`,它比 `echo -e` 更可靠地跨不同 shell 解釋反斜杠逃逸: