# @gkorepanov/ccodex 中文文档

规范地址：https://npmcn.com/package/%40gkorepanov/ccodex/

版本：0\.5\.24
npm 元数据更新时间：2026-11-12T12:24:51.702Z
中文译文更新时间：2026-11-16T15:28:21.603Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40gkorepanov/ccodex
原文对照：https://npmcn.com/package/%40gkorepanov/ccodex/?lang=original
项目主页：https://github.com/gkorepanov/ccodex#readme
源码仓库：https://github.com/gkorepanov/ccodex

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.3 MB，170 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.13 \<27
- 运行依赖：4 个
- 首次发布：2026-07-15T16:55:51.577Z
- 最新版本发布：2026-11-12T12:24:51.043Z
- 近 30 天下载量：3459（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：80（近 12 个月 80 个）

## 中文简介

用于 Codex CLI 和 Claude Code 运行时间的非官方 Codex App 兼容桥.

## 安装

```sh
npm install @gkorepanov/ccodex
```

也可以使用：`pnpm add @gkorepanov/ccodex`、`yarn add @gkorepanov/ccodex`、`bun add @gkorepanov/ccodex`

## README

# 克劳德代码x

**Codex App中的克洛德模型,相邻的为GBT.**

![A Codex App chat moving from GPT-6 to Claude Opus 5.5](https://npmcn.com/package/%40gkorepanov/ccodex/docs/screenshots/desktop-model-switch.png)

CCodex让你在Codex App的模型取材机中挑选克洛德. Claude的聊天是真实的 Claude Code 与你自己的 Claude 订阅, GPT 聊天继续运行在您的 Codex 上 和以前一样 它在桌面应用程序中,在您打开的 SSH 服务器上,以及从 手机上的ChatGPT应用程序.

**安装**

```sh
curl -fsSL https://github.com/gkorepanov/ccodex/releases/latest/download/install.sh | sh
```

**更新**

```sh
ccodex update && codex app-server daemon restart
```

然后退出并重新打开 ChatGPT 桌面应用 .

> \[注\] 一个非官方的社区项目,不隶属于OpenAI或Anthropic. 还年轻, 期待虫子,请 [报告他们](https://github.com/gkorepanov/ccodex/issues)。 。 。 .

## 你得到的东西

-   **克劳德在GPT旁边** 在模型取取器, 与克洛德的努力水平和快模式.
-   **切换模式中聊天.** 从 GPT 移动聊天到 Claude 或返回, 它继续 在那个地方.
-   **App像往常一样工作** 在克劳德聊天:批准,计划模式,子代理,图像, `/goal`,边聊边编辑并伪造消息.
-   **你的手机也一样.** 通过远程控制, ChatGPT 移动应用程序驱动 Claude 聊天 像GPT一样.
-   **一个历史与 `claude` CLI(英语:CLI).** 从 App 开始聊天 `claude --resume`,你的CLI会话出现在App.
-   **`/cc`** 显示聊天模式、上下文使用以及您的 Claude 和 Codex 限制.

## 如何运作

![CCodex on your computer and on a remote server, between the Codex App and Claude Code or Codex](https://npmcn.com/package/%40gkorepanov/ccodex/docs/how-it-works.png)

在您聊天的每台机器上安装 CCodex: 您的电脑用于本地应用程序, 和您打开的每个服务器 。 没有CCodex服务器,也没有遥测.

## 设置

在苹果硅或Linux上需要macOS(x64或arm64,glibc 2.31+),有Node.js 22–26. 安装器如果缺失则会添加Codex,而克洛德代码(Claude Code)则会与CCodex相接.

1.  **安装** 带有以上命令,或 `npm install -g @gkorepanov/ccodex && ccodex setup`作为普通用户运行,而不是 与 `sudo`。 。 。 .
2.  **登录** 无论你还没有登录到什么 `ccodex auth codex`, (中文(简体) ), `ccodex auth claude`。 。 。 .
3.  **重新开始.** 打开新 shell并运行 `codex app-server daemon restart`。然后:
    -   应用程序在 SSH 上连接: 重新连接到服务器 ;
    -   本地应用程序在Mac上:用QQ退出,再打开;
    -   linux 上的本地应用程序: 以 `CODEX_CLI_PATH=~/.ccodex/bin/codex`。 。 。 .

## 如果出了问题

-   `ccodex doctor` 检查安装并告诉你如何运行.
-   `ccodex uninstall` 删除 CCodex (添加) `--purge --yes` 删除 `~/.ccodex` 也一样.
-   您的机器、 设置、 日志和已知突触的设置 : [`docs/details.md`](https://npmcn.com/package/%40gkorepanov/ccodex/docs/details.md)。 。 。 .

* * *

[技术细节](https://npmcn.com/package/%40gkorepanov/ccodex/docs/details.md) • 妇女 [发展](https://npmcn.com/package/%40gkorepanov/ccodex/docs/details.md#development) • 妇女 [许可证](https://npmcn.com/package/%40gkorepanov/ccodex/docs/details.md#license)

## 常见问题

### @gkorepanov/ccodex 是什么？

用于 Codex CLI 和 Claude Code 运行时间的非官方 Codex App 兼容桥\.

### 如何安装 @gkorepanov/ccodex？

在项目目录运行 npm install @gkorepanov/ccodex，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 ccodex，可以用 npx ccodex 直接运行。

### @gkorepanov/ccodex 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/gkorepanov\_\_ccodex 是否存在。

### @gkorepanov/ccodex 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @gkorepanov/ccodex 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.13 \<27。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @gkorepanov/ccodex 可以商用吗？

@gkorepanov/ccodex 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @gkorepanov/ccodex 的下载量有多少？

根据 npm 官方下载统计，@gkorepanov/ccodex 在 2026/10/17 – 2026/11/15 这 30 天内被下载 3,459 次，日均约 115 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @gkorepanov/ccodex 还在维护吗？

最新版本 0\.5\.24 发布于 2026/11/12（4 天前）；至今共发布 80 个版本，其中过去 12 个月发布了 80 个；首次发布于 2026/07/16。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

