STARTEK
附件 BPOLARIS · 北極星商圈
HANDOUT B · 2026.05.28

終端機設定 ─ 讓 Claude Code 更好用

裝完 Claude Code 後，這 5 分鐘的設定會讓你之後幾百個小時都更舒服：畫面不閃爍、滑鼠能用、輸入 cc 一鍵啟動。

目錄
  1. 為什麼要設這個
  2. 前置確認 · 你用什麼 shell
  3. macOS / Linux 設定
  4. Windows PowerShell 設定
  5. 驗證
  6. 必學的 3 個快捷鍵
  7. 狀態列 · 隨時看 token 用量
  8. 卡關排查
  9. 下一步 · 接附件 C

1 · 為什麼要設這個

Claude Code 從某個版本（v2.1.89+）開始支援「不閃爍模式」── 用環境變數 CLAUDE_CODE_NO_FLICKER=1 開啟。預設沒開，原因是它需要你的終端機支援滑鼠回報，怕新手不知道怎麼處理錯誤。但對日常使用的差距非常大：

項目預設模式不閃爍模式
畫面閃爍每個字都整螢幕重畫只更新有變化的字元
滑鼠滾輪回看無法使用可以滾上去看歷史
滑鼠選取複製無法使用拖選 / 雙擊選字 / 三擊選行
輸入框位置會跟著輸出移動固定在底部
記憶體佔用越聊越多（可達 800 MB+）恆定低用量

另外加一個 cc 的快捷指令，就不用每次打 CLAUDE_CODE_NO_FLICKER=1 claude 這麼長一串。

2 · 前置確認 · 你用什麼 shell

在終端機輸入：

$ echo $SHELL

下面 macOS 範例會用 ~/.zshrc，如果你是 bash，把指令裡的 ~/.zshrc 改成 ~/.bashrc 即可。

3 · macOS / Linux 設定

方案 A · 純快速啟動（推薦給今天的工作坊）

打開終端機，複製貼上這一行：

$ echo "alias cc='CLAUDE_CODE_NO_FLICKER=1 claude'" >> ~/.zshrc && source ~/.zshrc

方案 B · 綁定預設專案資料夾（適合天天用同一個專案）

把 ~/你的專案路徑 換成你的實際路徑（例如 ~/Documents/my-project）：

$ echo "alias cc='cd ~/你的專案路徑 && CLAUDE_CODE_NO_FLICKER=1 claude'" >> ~/.zshrc && source ~/.zshrc

之後不管你在哪個資料夾，輸入 cc 都會自動切到你的專案再啟動 Claude。

補充 · 滾輪太慢？

如果預設滾輪速度太慢，可以加這條（範圍 1–20，預設偏慢）：

$ echo "export CLAUDE_CODE_SCROLL_SPEED=3" >> ~/.zshrc && source ~/.zshrc

4 · Windows PowerShell 設定

Windows 沒有 alias，要用 function 包起來。流程稍微長一點，但一樣一次設好終身受用。

4.1 開啟 PowerShell（一般使用者權限即可）

按 Win 鍵，輸入「PowerShell」開啟。不需要管理員權限 ── $PROFILE 寫到使用者個人設定檔，一般權限就能改。提示符應該長這樣 PS C:\Users\YourName>，有 PS 前綴才是 PowerShell。

4.2 允許執行自訂腳本（如果還沒做過）

PS> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

跳出確認時輸入 Y。

4.3 確認 PowerShell 設定檔存在（不存在就建一個）

PS> if (!(Test-Path $PROFILE)) { New-Item -ItemType File -Path $PROFILE -Force }

4.4 加入 cc function

方案 A · 純快速啟動：

PS> Add-Content $PROFILE "`nfunction cc { `$env:CLAUDE_CODE_NO_FLICKER = '1'; claude @args }"

方案 B · 綁定專案目錄（把 C:\你的專案路徑 換成實際路徑）：

PS> Add-Content $PROFILE "`nfunction cc { Set-Location 'C:\你的專案路徑'; `$env:CLAUDE_CODE_NO_FLICKER = '1'; claude @args }"

4.5 重新載入設定檔

PS> . $PROFILE
終端機選擇建議

5 · 驗證

macOS / Linux

$ type cc
cc is an alias for CLAUDE_CODE_NO_FLICKER=1 claude

$ cc
→ Claude Code 啟動，滾輪可以回看、畫面不閃爍 = 成功

Windows PowerShell

PS> Get-Command cc
CommandType  Name  Definition
Function     cc    ...

PS> cc
→ Claude Code 啟動，畫面不閃爍 = 成功

6 · 必學的 3 個快捷鍵

進入 Claude Code 之後，這幾個快捷鍵會省你很多時間：

快捷鍵功能場景
Ctrl + O → [ 把完整對話匯出到終端機歷史 聊完之後想搜「剛剛 AI 講過什麼」，匯出後用 Cmd + F 搜
Ctrl + O → V 用編輯器打開完整對話 對話很長，想存起來分享給同事
Ctrl + O → / 對話內搜尋關鍵字 n 跳下一個、N 跳上一個

7 · 狀態列 · 隨時看 token 用量

Claude Code 畫面底部可以掛一條「狀態列」，即時顯示你正在用哪個模型、目前這段對話吃掉多少 context（百分比）── 看到快滿了就開新對話，省錢又不會變慢。這條狀態列預設不會出現，要設定一次（只要設一次，之後所有專案都有）。

方案 A · 讓 Claude 自己幫你設好（推薦，不用寫 code）

用 cc 啟動 Claude Code，在對話框直接輸入這一行斜線指令，按 Enter：

> /statusline 顯示目前用的模型名稱和 context 使用百分比

Claude 會自動幫你建立一個小腳本（~/.claude/statusline.sh）並寫進設定檔（~/.claude/settings.json）。完成後底部就會出現類似這樣：

[Opus] ▓▓▓░░░░░░░ 30% context used

看不到的話，退出 Claude（Ctrl + C 兩次）再用 cc 重開一次即可。想改顯示方式，再打一次 /statusline 加上你的新要求就好。

補充 · 手動設定（給想自己動的人）

如果你想自己貼，把下面這段加進 ~/.claude/settings.json：

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh"
  }
}

再把這個腳本存成 ~/.claude/statusline.sh（Claude Code 會把一段 JSON 透過 stdin 餵給它，裡面有 context_window.used_percentage、model.display_name 等欄位）：

#!/bin/bash
input=$(cat)
model=$(echo "$input" | jq -r '.model.display_name // "Claude"')
pct=$(echo "$input" | jq -r '.context_window.used_percentage // 0' | cut -d. -f1)
echo "[$model] ${pct}% context used"

存好後跑 chmod +x ~/.claude/statusline.sh 給它執行權限即可。

8 · 卡關排查

問題解法
iTerm2（Mac 第三方終端機）滾輪沒反應 打開 Settings → Profiles → Terminal → 勾選 Enable mouse reporting
對話聊到一半想開新模式 不能即時切換，要先退出 Claude，重新用 cc 啟動。先按 Ctrl + O → [ 把對話匯出，再退出
想讓終端機保留原生滑鼠選取（不被 Claude 接管） 加 export CLAUDE_CODE_DISABLE_MOUSE=1，但會失去 Claude 內建的點擊操作
設完 alias 但 cc 還是找不到 確認有跑 source ~/.zshrc，或乾脆關掉終端機重開

9 · 下一步 · 接附件 C

終端機設定好了，接下來要建立 Zeabur 帳號 + 開啟雲端終端機 + 把訓練資料貼進去。請接著看 附件 C · Zeabur 帳號 + 訓練資料。

另外給創辦人的 附件 D · Vault for Founders ── 從零開始建你的 AI 知識庫的完整框架，非常推薦研讀。