Claude Arabic Terminal
VS Code의 터미널(xterm.js)은 오른쪽에서 왼쪽(RTL) 스크립트를 렌더링할 수 없습니다. 아랍어가 연결되지 않은 문자와 뒤바뀐 단어 순서로 표시되며, 어떤 설정으로도 고칠 수 없습니다. 이 스킬은 작은 VS Code 확장 프로그램을 설치하여 Claude Code를 의사 터미널에서 실행하고, 화면을 헤드리스 터미널 에뮬레이터에 유지한 후, HTML로 렌더링하여 VS Code 내부에 표시합니다. — 브라우저 엔진이 마치 claude.ai처럼 아랍어 형태 구성과 양방향 텍스트를 처리합니다.
레포지토리: https://github.com/JamalMohafil/claude-arabic-terminal
해야 할 일
사용자 OS에 맞는 설치 프로그램을 실행하고, 정상 작동을 확인한 후, 앞으로 사용할 단일 명령어를 알려주세요: arabic claude
단계
1. 사전 요구 사항 확인 (누락된 항목이 있으면 사용자에게 알리고 중단)
git,node(18+),npm—git --version,node -v,npm -v- Claude Code CLI —
claude --version - VS Code와
codeCLI —code --version(macOS에서code가 없으면: VS Code → Cmd+Shift+P → "Shell Command: '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-<버전>이 표시되어야 함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 -
첫 번째 실행 시 "Allow 'Claude Arabic Terminal' to open this URI?" 대화상자가 나타나면 — **"Do not ask me again for this extension"**을 체크하고 Open을 클릭하세요.
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