# @codexhost/cli 中文文档

规范地址：https://npmcn.com/package/%40codexhost/cli/

版本：0\.18\.0
npm 元数据更新时间：2026-11-11T17:33:51.470Z
中文译文更新时间：2026-11-11T19:16:32.774Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%40codexhost/cli
原文对照：https://npmcn.com/package/%40codexhost/cli/?lang=original
项目主页：https://github.com/BytePioneer-AI/codex-host#readme
源码仓库：https://github.com/BytePioneer-AI/codex-host

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

- 包体积（解压后）：25.3 kB，3 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.19\.0 \<23\.0\.0 \|\| \>=24\.0\.0
- 运行依赖：0 个
- 首次发布：2026-08-04T12:33:36.625Z
- 最新版本发布：2026-11-11T17:33:51.012Z
- 近 30 天下载量：4415（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：66（近 12 个月 66 个）

## 中文简介

运行 Pi 和 Claude Code 作为一等外接在 Codex Dextop 内部.

## 安装

```sh
npm install @codexhost/cli
```

也可以使用：`pnpm add @codexhost/cli`、`yarn add @codexhost/cli`、`bun add @codexhost/cli`

## README

# @ codexhost/ cli (英语)

运行 Pi 和 Claude Code 作为一等外接在 Codex Dextop 内部.

## 安装

```bash
npm install -g @codexhost/cli@0.18.0
```

npm自动安装匹配的macOS,Windows,或Linux平台包. 节点js 22.19.0或以后,需要23.x除外. 正式的ChatGPT/Codex桌面仅需要用于桌面界面;Web包含其中,没有它就工作.

## 使用量

```bash
codexhost --version
codexhost
codexhost web
codexhost status
codexhost autostart on
codexhost autostart status
codexhost stop
codexhost remote install
codexhost remote status
```

这个 `codexhost` 命令启动 Codex 桌面和背景网络;没有安装桌面则打开网络。 在macOS和Linux上,它立即返回,而被打包的启动器则在背景中继续监督. 在Windows上,该命令仍然被附加到Codex桌面退出之前,这样贝壳就可以清理已完成命令的处理树,无法丢弃主管. 重运行 `codexhost` 与同一控制实例有关.

`codexhost web` 确保主机和Web在后台运行,打印本地登录链接并打开浏览器。 超过 SSH 或者没有图形会话, 它只会打印链接 。 关闭终端,桌面或浏览器离开主机和Web运行;计算机必须保持清醒并连接. `CODEXHOST_WEB_SERVICE=0` 同时禁用网络启动 `codexhost`。 。 。 .

Web 最初监听于 `127.0.0.1:4400`。使用本地连接设备页面访问局域网和Tailscale Service,或运行 `codexhost web --host 0.0.0.0 --port 4500`选项 `--host`, (中文(简体) ), `--port`, (中文(简体) ), `--public-url` 财务报告和审定财务报表 `--trusted-proxy` 被验证并保存为以后的开始;空值清除了选项。 更改它们只重新启动Web,断开Web终端,而不是主机任务. 一个被占领的港口在不杀死其所有人或选择另一个港口的情况下失败。 LAN HTTP 未加密 .

匹配服务被再利用. 一个不同的版本或安装取代了运行中的服务;替换主机会不经确认而中断任务. `codexhost status` 仅读并显示Host/Web版本、无符号的Web地址、最后的Web失败和自动启动状态. `codexhost stop` 停止按此顺序管理桌面、 Web、 主机、 远程服务、 经纪和控制台, 报告中断主机任务, 并保存会话数据和配置 。 独立打开的桌面不关闭 。 当另一个计算机重新连接时远程服务返回; 中断的任务不会自动恢复 .

自动启动默认关闭 . `codexhost autostart on|off|status` 管理当前用户登录启动; 它启动Host和Web而不打开浏览器. Linux需要系统化的用户服务;内存由用户管理. 运行 `codexhost` 刷新启用了自动启动当前节点和 CLI 路径 .

办公室预览组件从npm注册处下载,首先使用Web计算机,而不是手机. 没有上传要转换的文件。 下载失败只影响 Office 预览; 在检查计算机网络后重试 .

## 未安装或降级

在删除此软件包或切换到没有背景Web支持的版本之前 :

```bash
codexhost stop
codexhost autostart off
npm uninstall -g @codexhost/cli
```

在停止或停止后, Tailscale 服务配置仍保留 。 检查 `tailscale serve status`;只有在 HTTPS 443 根路径仍然指向此 Web时,才用 `tailscale serve --https=443 --set-path=/ off` (取代实际的HTTPS端口). 这让其他道路完好无损。 在Web运行期间,本地连接设备页面也可以在确认后禁用Serve.

## 页:1

在macOS上, `remote install` 安装一个当前用户 Aqua Harness 代理商,这样背景 SSH 主机就可以使用本地的 Claude 代码登录而不读取,复制,或解锁密钥链证书.

如果使用安装 `--omit=optional`,不使用此选项而重新安装,所以 npm 可以选择当前架构的本地软件包 .

如果启动报告平台包版本不匹配,则关闭 Codex 桌面并在错误中运行精确的再安装命令. 这既安装了CLI,又安装了同版本的平台包,取而代之的是所独立安装的Stale有效载荷. `codexhost --version` 报告CLI软件包版本;启动时在发射前还验证了平台有效载荷.

## 常见问题

### @codexhost/cli 是什么？

运行 Pi 和 Claude Code 作为一等外接在 Codex Dextop 内部\.

### 如何安装 @codexhost/cli？

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

### @codexhost/cli 支持 TypeScript 吗？

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

### @codexhost/cli 支持 ESM 还是 CommonJS？

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

### @codexhost/cli 需要什么版本的 Node\.js？

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

### @codexhost/cli 可以商用吗？

@codexhost/cli 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @codexhost/cli 的下载量有多少？

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

### @codexhost/cli 还在维护吗？

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