Claude Arabic Terminal
O terminal do VS Code (xterm.js) não consegue renderizar scripts da direita para a esquerda: o árabe aparece com letras desconectadas e ordem de palavras invertida, e nenhuma configuração corrige isso. Esta skill instala uma pequena extensão do VS Code que executa o Claude Code em um pseudo-terminal, mantém a tela em um emulador de terminal headless e renderiza como HTML dentro do VS Code — assim o motor do navegador faz a formatação das letras e o bidi exatamente como no claude.ai.
Repositório: https://github.com/JamalMohafil/claude-arabic-terminal
Sua tarefa
Execute o instalador para o SO do usuário, verifique se funcionou e, no final, informe a eles o
comando único que devem usar daqui em diante: arabic claude.
Passos
1. Verifique os pré-requisitos (pare e avise o usuário se algum estiver faltando)
git,node(18+),npm—git --version,node -v,npm -v- CLI do Claude Code —
claude --version - VS Code com a CLI
code—code --version(secodeestiver faltando no macOS: VS Code → Cmd+Shift+P → "Shell Command: Install 'code' command in PATH")
2. Execute o instalador
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
O instalador clona o repositório para ~/.claude-arabic-terminal, executa npm install,
vincula a extensão em ~/.vscode/extensions/ e coloca o launcher arabic em
~/.local/bin (adicionado ao PATH se necessário). Reexecutar o instalador atualiza uma instalação existente.
Se curl/irm estiver bloqueado, clone o repositório manualmente e execute ./install.sh ou
.\install.ps1 de dentro dele.
3. Verifique
ls ~/.vscode/extensions | grep claude-arabic(Windows:dir $env:USERPROFILE\.vscode\extensions) mostrajamal.claude-arabic-terminal-<versão>command -v arabic(Windows:Get-Command arabic) resolve — se não, o usuário deve abrir um novo terminal para que o PATH seja atualizadols ~/.claude-arabic-terminal/node_modules/node-pty/prebuildslistadarwin-*/win32-*
4. Informe exatamente isto ao usuário
-
Recarregue o VS Code: Cmd/Ctrl+Shift+P → "Developer: Reload Window"
-
Daqui em diante, em qualquer terminal do VS Code, execute:
arabic claudeTodas as flags do Claude Code são passadas sem alteração:
arabic claude --dangerously-skip-permissions,arabic claude --resume,arabic claude --model opus -
Na primeira inicialização, aparecerá "Allow 'Claude Arabic Terminal' to open this URI?" — marque "Do not ask me again for this extension" e clique em Open.
O Claude Code abrirá como um painel com suporte a árabe dentro da área de terminal do VS Code, executando na pasta a partir da qual o comando foi lançado.
Solução de problemas
| Sintoma | Solução |
|---|---|
arabic: command not found | Abra um novo terminal (o PATH acabou de ser atualizado) ou execute ~/.local/bin/arabic claude |
| A caixa de diálogo URI aparece mas nada abre | O VS Code não foi recarregado desde a instalação — Developer: Reload Window |
| "claude exited with code 1" imediatamente | Execute claude em um terminal normal primeiro para concluir o login / confiar na pasta |
A extensão não carrega no macOS (posix_spawnp failed) | chmod +x ~/.claude-arabic-terminal/node_modules/node-pty/prebuilds/*/spawn-helper |
| Quer como uma aba de editor em vez da área de terminal | Paleta de Comandos → "Claude Arabic Terminal: Open in Editor Tab" |
Desinstalação
rm -rf ~/.claude-arabic-terminal ~/.vscode/extensions/jamal.claude-arabic-terminal-* ~/.local/bin/arabic