STARTEK
附件 BWORKSHOP HANDOUT · COMET
HANDOUT B · 2026.05.15

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

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

目錄
  1. 為什麼要設這個
  2. 前置確認 · 你用什麼 shell
  3. macOS / Linux 設定
  4. Windows PowerShell 設定
  5. 驗證
  6. 必學的 3 個快捷鍵
  7. 卡關排查
  8. 下一步 · 接附件 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/huixin-workshop):

$ 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 + X,選「Terminal(系統管理員)」或「Windows 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 + OV 用編輯器打開完整對話 對話很長,想存起來分享給同事
Ctrl + O/ 對話內搜尋關鍵字 n 跳下一個、N 跳上一個

7 · 卡關排查

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

8 · 下一步 · 接附件 C

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

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