Skip to content

focuxdot/codex-zh

Repository files navigation

Codex + 微信 = C叉叉 · 在微信里面,随时随地使用Codex

C叉叉是 OpenAI Codex 的插件增强版,做三件事:

  1. 说中文、国内能连:默认中文界面,内置中转站配置向导(Wokey / OpenRouter / 自定义),免改 config.toml 就能在国内 API Key 场景下启用 Browser、Chrome、Computer Use 等本地能力。
  2. 手机远程:扫码配对后,微信变成电脑上 Codex 的遥控器——看进度、批命令、随时返工,人离开工位任务不停。
  3. 会话围观:一条只读链接,把你和 AI 协作的完整过程分享到群里,微信点开即看,无需安装。这是 Codex 生态(包括官方 App)目前没有的能力。

关键词:Codex 中文版、Codex 汉化、Codex 国内怎么用、Codex 手机远程控制、Codex 会话分享、Codex 中转站配置、Codex Windows 安装包、Codex Mac 版、Browser / Computer Use 地区不可用。

微信扫码直接使用:人离开电脑,任务不停

C叉叉手机端:任务看板与浮窗返工、多电脑切换、实时会话

Codex 跑长任务时,你不必守在电脑前:

  • 一眼看清全局:首页大字看板直接回答“几个任务在跑、几个在等审批”。任务进行时不用盯,浮窗随时点开返工。
  • 审批不回工位:普通命令可“批准,且本会话内不再询问”。
  • 完整的会话能力:发消息、打断、接管、新建会话(常用目录点选即建)、Codex 回复 markdown 渲染、命令与 diff 逐条可查。
  • 多台电脑:家里、公司各一台?顶栏菜单一键切换,工作、私活做斜杠小登。
  • 主动通知:任务完成或需要审批时,推送到 Bark / Server酱 / 企业微信 / 钉钉(国内可用,不依赖 Web Push),通知带深链直达对应会话。

手机端是网页(PWA,可添加到主屏幕),微信扫码直接使用,无需安装 App,微信添加到悬浮窗,随时点开返工。

安全设计(细节见 remote/PROTOCOL.md):

手机远程内置在 macOS 版里:点菜单栏的 Codex 图标 →「扫码配对手机」,手机扫码就连上了(首次扫码即自动开启远程,无需先手动启用);不用则完全不运行。Windows 版的集成在排期中。开发者也可以直接从源码运行,见 remote/README.md(含中继自部署文档)。

会话围观:一条链接,请人看你和 AI 干活

会话是这个时代新的作品。C叉叉 把一个会话变成可分享的只读链接:

  • 跑完的会话从头回放:精彩的重构、排障、从零到一,可以当作品集挂出去;小团队把项目会话给甲方看进度。
  • 正在跑的会话实时围观:同一条链接,会话在跑时自然变成直播——不是两个功能,是同一个视图的两种状态。
  • 观众零门槛:微信里点开就能看,不用安装任何东西;可以喝彩、复制你的 prompt、转发链接。
  • 收放自如:链接分 24 小时 / 永久两档,随时撤销,撤销瞬间全场踢出。

中文界面与国内可用

不需要手动改 config.toml,也不需要理解 provider、wire_api 这些配置项。下载、安装、填 Key、测试连接,然后启动 Codex。

需求 C叉叉 的处理方式
想让 Codex 默认显示中文 安装后默认启用简体中文界面
想接入中转站 提供 Wokey、OpenRouter、自定义中转站模板
不会改配置文件 首次启动进入配置向导,填地址、Key、模型名即可
怕配置被覆盖 写入前自动备份,只合并 C叉叉 管理的字段
Browser / Computer Use 地区不可用 内置本地能力配置,让入口可见、可安装、可启用
人不在电脑前 手机远程看进度、批命令、随时返工
想把会话分享给别人看 生成只读围观链接,点开即看

下载

当前最新版:v0.4.0

你的系统 下载哪个版本
Windows 10 / Windows 11(64 位) 下载 Codex-叉叉 0.4.0 Windows x64 安装包
macOS(Apple 芯片 / arm64) 下载 Codex-叉叉 0.4.0 macOS arm64 安装包

macOS 版打开时如果提示文件“已损坏”或无法安装,属正常现象,按常见问题里的说明处理即可。

快速开始

Windows

  1. 在上面的“下载”表格里下载 .exe 安装包,双击安装并打开 Codex-叉叉
  2. 在配置向导里选择模板,填写中转站地址、API Key、模型名。
  3. 点击“测试连接”,通过后点击“保存并启动”。

macOS(Apple 芯片)

  1. 下载 .dmg,打开后把 Codex-叉叉 拖进「应用程序」。
  2. 首次打开如果提示“已损坏”或“无法验证开发者”,打开「终端」执行一次 xattr -dr com.apple.quarantine /Applications/Codex-叉叉.app 即可(原因和图形界面办法见常见问题)。
  3. 打开 Codex-叉叉,配置向导与 Windows 相同:选模板、填地址和 Key、测试连接。
  4. 想用手机远程:点菜单栏的 Codex 图标 →「扫码配对手机」,手机扫码即连上(首次扫码自动开启远程)。

仅支持 Apple 芯片(arm64),Intel Mac 不支持。

Wokey 模板会预填公开测试 Key,方便第一次验证流程。长期使用或生产使用,请换成自己的中转站 Key。

如果你通过 CC-switch 等外部工具切换模型,不希望 C叉叉 启动时打开中转站配置向导,可以在弹窗里勾选“以后不再显示这个配置弹窗”并点击“跳过本次”。启动器也支持 CodexZhLauncher.exe --skip-config 跳过本次配置向导;需要重新打开配置时,使用开始菜单里的“Codex 中转站配置”。

办公实战教程

Codex 高效办公实战课,原创“问补做”套路 · 真实办公案例。

先从教程总入口开始看:C叉叉 办公实战教程第一季

大纲参考快刀青衣《Codex办公实战课》,GPT-5.5 × Opus 4.8 共创完成。

教程 主题
01 开箱即用:整理混乱文件夹
02 快速提案:散装资料变方案
03 数据清洗:乱报名表变统计数据
04 高效设计:一句想法变 PPT 初稿
05 从零造工具:CSV / Markdown 本地转换器
06 批量处理:一堆活动截图一次整理好
07 知识点到短视频:会员积分讲得不生硬
08 长素材到高光:直播回放拆成剪辑清单

功能对比

Browser

原版 Codex C叉叉
原版 Browser 显示地区不可用 C叉叉 Browser 已可启用
部分地区会显示 Browser 不可用。 内置浏览器可以正常开启。

Computer Use

原版 Codex C叉叉
原版 Computer use 显示不可用 C叉叉 Computer use 已可启用
Computer use / Chrome 控制可能被地区限制挡住。 可以开启“任意应用”和 Google Chrome。

中转站怎么填

如果你不熟悉这些字段,可以按下面理解:

字段 填什么
中转站地址 服务商给你的 API 地址,例如 https://api.wokey.aihttps://openrouter.ai/api/v1
API Key 服务商后台复制出来的 Key
模型名 服务商支持的模型名,例如 autoopenai/gpt-4.1gpt-4.1

高级字段默认不用管。C叉叉 会自动使用当前 Codex Desktop 需要的 responses 协议。

它会改哪些配置

C叉叉 会写入官方 Codex 配置目录里的 config.toml,但写入前会先备份。

它只管理这些内容:

  • 当前模型
  • 当前 provider
  • 中转站 Base URL
  • 中转站 API Key
  • Codex 桌面的对话详情显示方式

你的其它 Codex 设置会保留。

常见问题

我不是开发者,可以用吗

可以。C叉叉 的目标用户就是普通用户。你不需要知道 config.toml 在哪里,也不需要理解 model_provider

没有中转站 Key 能试用吗

可以先用 Wokey 模板里的公开测试 Key 验证流程。长期使用建议换成自己的 Key。

Browser 和 Computer Use 一定能用吗

C叉叉 会让入口可见、可安装、可启用,并内置必要的本地能力配置。Chrome 控制仍然需要你本机安装 Chrome,并按界面提示连接浏览器扩展。

macOS 打开时提示“已损坏”或“无法验证开发者”

macOS 安装包目前是 ad-hoc 签名、未经 Apple 公证(项目不依赖 Apple 开发者账号)。先把 Codex-叉叉 拖进「应用程序」,然后二选一:

  • 终端法(最稳):打开「终端」执行 xattr -dr com.apple.quarantine /Applications/Codex-叉叉.app,之后正常双击打开。
  • 图形界面法:先双击一次 Codex-叉叉(会被拦,点「完成」),再到「系统设置 → 隐私与安全性」往下拉,点「已阻止 Codex-叉叉…」旁边的「仍要打开」。

只影响首次启动,不影响功能。(macOS Sequoia 起,未公证脚本无法再靠双击 .command 解隔离,故已移除该辅助文件。)

会上传我的 API Key 吗

不会。API Key 写入你本机的 Codex 配置文件。日志和错误提示不应该输出完整 Key。

手机远程会把我的代码传到别人的服务器吗

不会明文经手任何服务器。手机与电脑之间端到端加密,中继只转发密文;中继服务器也可以按文档部署到你自己的 Cloudflare 账号。功能默认关闭,不启用时电脑上没有任何相关进程。

围观链接会不会让别人动我的电脑

不会。围观链接是单会话只读:观众不能发消息、不能批命令、看不到你其他会话与审批内容。权限判定在你电脑端的设备记录上,链接随时可撤销,撤销即全场断线。

配置失败怎么办

通常是下面几类原因:

  • API Key 填错。
  • Base URL 少了 /v1,或服务商地址不兼容。
  • 模型名不存在,或账号没有开通该模型。
  • 中转站暂时不可用。

配置器会尽量给出能操作的提示,比如“检查 API Key”或“检查 Base URL”。

和原版 Codex 的关系

C叉叉 是在原版 Codex 的基础上做配置和资源定制:默认中文、预置中转站配置向导、调整本地能力入口的可用性,并附带独立的手机远程与会话围观子系统(remote/,零依赖,不修改 Codex 本体协议)。

源码仓库只保存这些定制脚本和配置,不直接提交官方 Codex 的安装包或二进制文件。

项目不做这些事:

  • 不破解官方账号。
  • 不绕过官方认证、授权或 attestation。
  • 不提供公共模型中转服务。
  • 不把第三方私有 API Key 打进安装包。

贡献

开发者和贡献者请看 CONTRIBUTING.md,发布边界请看 OPEN_SOURCE_READINESS.md

About

Codex + 微信 = C叉叉 。在手机微信里面,随时随地指挥Codex干活。

Topics

Resources

License

Contributing

Security policy

Stars

14 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors