# coderemote 中文文档

规范地址：https://npmcn.com/package/coderemote/

版本：0\.3\.12
npm 元数据更新时间：2026-11-03T06:31:27.551Z
中文译文更新时间：2026-11-03T09:04:11.008Z
软件包许可：AGPL-3\.0-or-later

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

原始 npm 页面：https://www.npmjs.com/package/coderemote
原文对照：https://npmcn.com/package/coderemote/?lang=original
项目主页：https://coderemoteapp.github.io/web/
源码仓库：https://github.com/CodeRemoteApp/coderemote

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

- 包体积（解压后）：386 kB，5 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：3 个
- 首次发布：2026-10-26T02:59:22.609Z
- 最新版本发布：2026-11-03T06:31:27.219Z
- 已发布版本数：19（近 12 个月 19 个）

## 中文简介

使用你的电脑从你的iPhone：文件，git和一个真正的终端通过一个安全的微软开发隧道。没有SSH，没有端口转发，没有VPN。

## 安装

```sh
npm install coderemote
```

也可以使用：`pnpm add coderemote`、`yarn add coderemote`、`bun add coderemote`

## README

![Code Remote icon](https://raw.githubusercontent.com/CodeRemoteApp/coderemote/main/docs/images/icon.png)

# coderemote

**使用iPhone上的电脑。**  
浏览文件，用git检查和提交，在你的开发机器上运行一个真正的终端， 通过安全的微软开发隧道。没有SSH密钥，没有端口转发，没有VPN。

[![npm version](https://img.shields.io/npm/v/coderemote)](https://www.npmjs.com/package/coderemote) [![license: AGPL-3.0-or-later](https://img.shields.io/npm/l/coderemote)](https://github.com/CodeRemoteApp/coderemote/blob/main/LICENSE) ![node version](https://img.shields.io/node/v/coderemote)

[**网站**](https://coderemoteapp.github.io/web/) · [**文档**](https://coderemoteapp.github.io/web/docs/)

* * *

`coderemote` 是电脑这边的吗 **代码远程**这是一款用于远程开发的iOS应用程序。 在项目文件夹中运行一个命令，用iPhone扫描二维码，该文件夹就是 在你的口袋里：

-   **文件:** 浏览，打开和编辑共享文件夹中的文件，创建，重命名和删除。
-   **代理聊天:** 在适当的聊天视图中与Claude Code和Codex交谈，而不是原始视图 终端。跟踪代理正在做什么，并回答其许可提示和问题 从你的手机里。
-   **Git:** 更改和差异，阶段，提交，拉，推和历史，在每个repo在文件夹中。
-   **终端:** 一个真正的外壳，可以在你的手机休眠时继续运行 `vim`， `htop` 或者一个 长期构建能在应用切换中存活下来。
-   **港口:** 在某个本地端口上启动后端或前端？这个应用程序对这个端口进行隧道化，所以你 可以在手机上打开它，测试API或预览web UI，而无需部署。
-   **浏览器中的VS代码（可选）：** `coderemote up --web`。

## 快速启动

```sh
npm install -g coderemote
cd ~/projects/my-app && coderemote up
```

用你的iPhone相机或手机扫描二维码 **+** 按钮，第一次运行 下载微软的Dev Tunnels CLI，并要求你登录GitHub。

其他安装方式（当你没有Node.js时脚本会下载）：

```sh
brew install coderemoteapp/tap/coderemote                                                      # Homebrew
curl -fsSL https://raw.githubusercontent.com/CodeRemoteApp/coderemote/main/install.sh | sh    # macOS, Linux
```

```powershell
irm https://raw.githubusercontent.com/CodeRemoteApp/coderemote/main/install.ps1 | iex         # Windows
```

## 克劳德法典和法典

运行一次，让应用程序跟随并回答您的代理会话：

```sh
coderemote setup claude    # Claude Code plugin
coderemote setup codex     # Codex plugin, then trust its hooks once with /hooks in Codex
```

在Claude Code中你也可以运行 `/plugin install coderemote --marketplace CodeRemoteApp/coderemote`。

## 需求

-   Node.js 22+在macOS或Windows 10/11 （Linux预计工作，未经测试）
-   GitHub或微软账户
-   这个 **代码远程** iOS应用（app Store即将发布）

命令、选项和详细信息都在 [文档](https://coderemoteapp.github.io/web/docs/)。

## 常见问题

### coderemote 是什么？

使用你的电脑从你的iPhone：文件，git和一个真正的终端通过一个安全的微软开发隧道。没有SSH，没有端口转发，没有VPN。

### 如何安装 coderemote？

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

### coderemote 支持 TypeScript 吗？

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

### coderemote 支持 ESM 还是 CommonJS？

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

### coderemote 需要什么版本的 Node\.js？

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

### coderemote 可以商用吗？

coderemote 使用 AGPL-3\.0-or-later 许可。最严格的 Copyleft：除分发外，通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括，不构成法律意见，请以许可原文为准。

### coderemote 还在维护吗？

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