whatisgithub

What is codex-zh-cn?

xqnode/codex-zh-cn — explained in plain English

Analysis updated 2026-05-18

30JavaScriptAudience · developerComplexity · 1/5LicenseSetup · easy

In one sentence

An unofficial patch that translates the Codex Desktop AI coding app into Simplified Chinese for Windows users.

Mindmap

mindmap
  root((repo))
    What it does
      Patches Codex Desktop UI
      Translates menus and dialogs
      Sets Chinese as default language
    Tech stack
      JavaScript
      Batch and PowerShell scripts
    Use cases
      Use Codex Desktop in Chinese
      Fix untranslated plugin labels
      Restore English if needed
    Audience
      Chinese speaking developers
    Setup
      Run installer as admin
      Auto detects install location
      Reapply after Codex updates

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

What do people build with it?

USE CASE 1

Switch the Codex Desktop interface from English to Simplified Chinese on Windows

USE CASE 2

Restore Codex Desktop to English if the translation causes problems

USE CASE 3

Reapply the translation automatically after a Codex Desktop update overwrites it

What is it built with?

JavaScriptPowerShellBatch

How does it compare?

xqnode/codex-zh-cnkappaemme-git/mengtofrontendm2station/m2_git_diff
Stars303030
LanguageJavaScriptJavaScriptJavaScript
Setup difficultyeasyeasyeasy
Complexity1/51/52/5
Audiencedevelopervibe coderdeveloper

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires Windows admin (UAC) approval to run the installer script.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

codex-zh-CN is an unofficial Simplified Chinese language pack for Codex Desktop on Windows. Codex Desktop is an AI coding assistant made by OpenAI that runs as a native application. By default it shows its interface in English, and this project patches the local application files to display menus, dialogs, and built-in plugin labels in Chinese instead. Installation is done by running a batch file that opens an interactive menu. From that menu you choose to install the translation, revert to English, verify that the patch applied correctly, or manually specify where Codex is installed if the script cannot find it automatically. The script searches several common locations including Microsoft Store app folders, standard install directories, and running processes before asking you to point it at the right place manually. The patch modifies files inside the Codex application folder on your machine. It backs up the originals first, then writes new translation files, updates menu strings that are baked directly into the main process, fills in missing Chinese strings in the web view layer, translates built-in plugin names and descriptions, and sets the language to Chinese in the Codex configuration file. For the Microsoft Store version, it cannot modify the protected install folder directly, so it copies the patched files to a folder in your user profile and provides a separate launcher you use instead of the Start menu shortcut. If Codex updates itself and overwrites the patched files, you run the same installer again. The README notes this is not affiliated with OpenAI and modifications are at your own risk. The project is released under the MIT License.

Copy-paste prompts

Prompt 1
Walk me through downloading and running install-windows.bat to translate my Codex Desktop app into Simplified Chinese.
Prompt 2
Codex Desktop reverted to English after an update, explain how to rerun the translation patch to fix it.
Prompt 3
I installed Codex Desktop from the Microsoft Store, explain how this tool's patch works around the protected install folder.
Prompt 4
Show me how to use the interactive menu in install-windows.bat to verify the patch applied correctly.

Frequently asked questions

What is codex-zh-cn?

An unofficial patch that translates the Codex Desktop AI coding app into Simplified Chinese for Windows users.

What language is codex-zh-cn written in?

Mainly JavaScript. The stack also includes JavaScript, PowerShell, Batch.

What license does codex-zh-cn use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is codex-zh-cn to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is codex-zh-cn for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.