Claude 阿拉伯语终端
VS Code 的终端(xterm.js)无法渲染从右到左的脚本:阿拉伯语会显示为字符断开、单词顺序颠倒,并且任何设置都无法修复。 此技能会安装一个小的 VS Code 扩展,该扩展在伪终端中运行 Claude Code,在无头终端模拟器中保持屏幕内容,并在 VS Code 内部将其渲染为 HTML——这样浏览器引擎就能负责阿拉伯语的字形连接和双向文本排序,效果与 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 - 带有
codeCLI 的 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. 明确告知用户以下内容
-
重新加载 VS Code:Cmd/Ctrl+Shift+P → “Developer: Reload Window”
-
从现在开始,在任何 VS Code 终端中,运行:
arabic claude所有 Claude Code 标志均原样传递:
arabic claude --dangerously-skip-permissions、arabic claude --resume、arabic claude --model opus -
首次启动时会显示“允许 'Claude Arabic Terminal' 打开此 URI?”——勾选**“不再询问此扩展”并点击打开**。
Claude Code 将在 VS 终端区域内打开一个支持阿拉伯语的面板,并在启动命令所在的文件夹中运行。
故障排除
| 症状 | 解决方法 |
|---|---|
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