用途:VS Code 终端(xterm.js)无法渲染从右到左文字,阿拉伯语会出现字母断开、词序颠倒,且设置中无法修复。该技能安装一个 VS Code 扩展,把 Claude Code 运行在伪终端中,屏幕内容保留在无头终端模拟器内并以 HTML 在 VS Code 中渲染,由浏览器引擎完成阿拉伯语塑形和双向排版,效果类似 claude.ai。
前置条件:git、node(18+)、npm、Claude Code CLI(claude --version)以及带 code 命令的 VS Code。macOS 若缺少 code 命令,可在 VS Code 中按 Cmd+Shift+P 执行 “Shell Command: Install 'code' command in PATH”。
安装: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。若 curl/irm 被拦截,可手动克隆仓库后运行 ./install.sh 或 .\install.ps1。重复运行会更新已有安装。
验证:检查扩展目录中存在 jamal.claude-arabic-terminal-<版本>,command -v arabic 能解析(否则需新开终端刷新 PATH),并确认 node-pty 预构建存在。随后重载 VS Code(Developer: Reload Window),在任意 VS Code 终端运行 arabic claude。所有 Claude Code 参数原样透传,例如 arabic claude --resume、arabic claude --model opus。首次启动会弹出 URI 授权对话框。
限制:需要上述前置条件与网络访问安装脚本;仅面向 VS Code 终端场景;如遇 arabic: command not found 需新开终端,若启动后立刻退出可先在普通终端运行 claude 完成登录或信任文件夹,macOS 上扩展无法加载时可对 spawn-helper 执行 chmod +x。卸载可删除相关安装目录与启动器。