JamalMohafil/claude-skills

Claude 阿拉伯語終端機

VS Code 的終端機（xterm.js）無法正確渲染從右到左書寫的腳本：阿拉伯語會以斷開的字母和顛倒的單字順序顯示，而且設定中沒有任何選項可以修正。 這個技能會安裝一個小型 VS Code 擴充功能，該擴充功能在偽終端機中執行 Claude Code，將畫面保留在無頭終端機模擬器中，然後以 HTML 形式在 VS Code 內部渲染——這樣瀏覽器引擎就能處理阿拉伯語的字型連接和雙向文字（bidi）排版，效果與 claude.ai 完全一致。

倉庫：https://github.com/JamalMohafil/claude-arabic-terminal

你的任務

為使用者的作業系統執行安裝程式，驗證安裝是否成功，最後告訴他們從現在起只需要記住一條指令：arabic claude。

步驟

1. 檢查先決條件（如果缺少任何一項，請停止並告知使用者）

• git、node（18+）、npm——執行 git --version、node -v、npm -v
• Claude Code CLI——執行 claude --version
• 已安裝 code CLI 的 VS Code——執行 code --version （如果在 macOS 上缺少 code：VS Code → Cmd+Shift+P → 「Shell Command: Install 'code' command in PATH」）

2. 執行安裝程式

macOS / Linux：

curl -fsSL https://raw.githubusercontent.com/JamalMohafil/claude-arabic-terminal/main/install.sh | bash

Windows（PowerShell）：

irm https://raw.githubusercontent.com/JamalMohafil/claude-arabic-terminal/main/install.ps1 | iex

安裝程式會將倉庫複製到 ~/.claude-arabic-terminal，執行 npm install，將擴充功能連結到 ~/.vscode/extensions/，並將 arabic 啟動器放入 ~/.local/bin（如有需要，會加入 PATH）。重新執行安裝程式會更新現有安裝。

如果 curl/irm 被阻擋，請手動複製倉庫，然後在該目錄內執行 ./install.sh 或 . install.ps1。

3. 驗證

• ls ~/.vscode/extensions | grep claude-arabic（Windows：dir $env:USERPROFILE\.vscode\extensions）應顯示 jamal.claude-arabic-terminal-<version>
• command -v arabic（Windows：Get-Command arabic）應能解析——如果不行，使用者必須開啟一個新的終端機，以便 PATH 重新整理
• ls ~/.claude-arabic-terminal/node_modules/node-pty/prebuilds 應列出 darwin-* / win32-*

4. 準確地告訴使用者以下內容

1. 重新載入 VS Code：Cmd/Ctrl+Shift+P → 「Developer: Reload Window」

2. 從現在起，在任何 VS Code 終端機中執行：

   arabic claude
   

   所有 Claude Code 旗標都會原封不動地傳遞： arabic claude --dangerously-skip-permissions、arabic claude --resume、arabic claude --model opus

3. 第一次啟動時會顯示「允許「Claude Arabic Terminal」開啟此 URI？」—— 勾選**「不再詢問此擴充功能」，然後點選開啟**。

Claude Code 會以支援阿拉伯語的面板形式，在 VS Code 終端機區域內開啟，並在啟動該指令的資料夾中執行。

故障排除

症狀	解決方法
arabic: command not found	開啟一個新的終端機（PATH 剛剛更新），或執行 ~/.local/bin/arabic claude
URI 對話框出現但沒有任何反應	VS Code 在安裝後尚未重新載入——請執行 Developer: Reload Window
立即顯示「claude exited with code 1」	先在一般終端機中執行 claude 以完成登入 / 信任該資料夾
macOS 上擴充功能無法載入（posix_spawnp failed）	執行 chmod +x ~/.claude-arabic-terminal/node_modules/node-pty/prebuilds/*/spawn-helper
希望以編輯器分頁而不是終端機區域顯示	指令面板 → 「Claude Arabic Terminal: Open in Editor Tab」

解除安裝

rm -rf ~/.claude-arabic-terminal ~/.vscode/extensions/jamal.claude-arabic-terminal-* ~/.local/bin/arabic