gitwtfhub

wtf is claude-cli-translator?

zhaoge8888/claude-cli-translator — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · developer

TL;DR

A Windows side-pane tool that translates manually selected Claude Code terminal text into Chinese using a DeepSeek or OpenAI-compatible API.

Mindmap

mindmap
  root((claude-cli-translator))
    What it does
      Split-pane translator
      Hotkey triggered
      No Claude Code file changes
    Tech stack
      Python
      PowerShell
      Windows Terminal
      DeepSeek API
    Use cases
      Read output in Chinese
      One-command split pane
      Custom glossary
    Audience
      Developers
      Non-English speakers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Read Claude Code CLI output in Chinese without leaving the terminal.

REASON 2

Set up a one-command split-pane workflow for coding with live translation.

REASON 3

Manually translate selected terminal text via a hotkey instead of copy-pasting elsewhere.

REASON 4

Use a custom glossary to keep Claude Code terminology accurate in translation.

What's in the stack?

PythonPowerShellWindows TerminalAutoHotkeyDeepSeek API

How it stacks up

zhaoge8888/claude-cli-translator0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultyhardhard
Complexity4/54/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

Wtf does this do

This tool is a Windows helper that adds a translation pane next to the Claude Code terminal, without changing any of Claude Code's own files. It is not an official Anthropic project. It only translates text that you manually select in the terminal, it does not read the screen automatically. The setup uses a split Windows Terminal window: the left pane runs Claude Code as usual, and the right pane runs a small Python script that shows translated text. When you select English text on the left and press Ctrl+Alt+T, a Python hotkey program copies that selection and sends it to the translation pane. Double tapping Ctrl also works as a backup trigger. In menus, command pickers, or the rewind screen inside Claude Code, you need to hold Shift while dragging to select text, because otherwise Windows Terminal cannot make a normal selection there. The translation pane itself calls a DeepSeek or other OpenAI compatible API and displays the result in Chinese in a compact view. The repo includes the main translator script, two versions of the hotkey trigger (one in Python, one as an AutoHotkey backup), several PowerShell scripts to launch the split pane setup with one command, install a desktop shortcut, adjust pane sizes, or send clipboard contents manually, a configuration template, and a glossary file of Claude Code specific terms to improve translation accuracy. Setup requires Windows Terminal, Python 3.9 or newer, and an API key for a service like DeepSeek, entered as an environment variable rather than stored in the repo. The README includes an offline dry run mode for testing the translation pipeline without calling the API. It also includes a privacy warning: any text you select and send gets forwarded to your configured API provider, so you should avoid selecting secrets, private source code, or sensitive data unless you trust that provider. Known limits include that it cannot preserve terminal colors or cursor position, translation quality depends on the model and glossary used, and the hotkeys are global rather than limited to this one application.

Yoink these prompts

Prompt 1
Walk me through setting up translator-pane.py and config.json for the first time on Windows.
Prompt 2
Explain how the Ctrl+Alt+T hotkey trigger in this repo captures and sends selected text.
Prompt 3
Help me customize glossary.json to add more Claude Code terms for translation.
Prompt 4
How do I switch this project from DeepSeek to another OpenAI-compatible API provider?

Frequently asked questions

wtf is claude-cli-translator?

A Windows side-pane tool that translates manually selected Claude Code terminal text into Chinese using a DeepSeek or OpenAI-compatible API.

What language is claude-cli-translator written in?

Mainly Python. The stack also includes Python, PowerShell, Windows Terminal.

Who is claude-cli-translator for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.