# @ccode-si/cli 中文文档

规范地址：https://npmcn.com/package/%40ccode-si/cli/

版本：1\.3\.0
npm 元数据更新时间：2026-10-31T17:05:53.204Z
中文译文更新时间：2026-10-31T18:19:30.008Z
软件包许可：SEE LICENSE IN LICENSE

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

原始 npm 页面：https://www.npmjs.com/package/%40ccode-si/cli
原文对照：https://npmcn.com/package/%40ccode-si/cli/?lang=original

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

- 包体积（解压后）：130 kB，5 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-10-12T20:52:46.838Z
- 最新版本发布：2026-10-31T17:05:53.075Z
- 已发布版本数：20（近 12 个月 20 个）

## 中文简介

CCode -终端的编码代理。

## 安装

```sh
npm install @ccode-si/cli
```

也可以使用：`pnpm add @ccode-si/cli`、`yarn add @ccode-si/cli`、`bun add @ccode-si/cli`

## README

# CCode

您的终端的编码代理。用通俗易懂的语言描述你想要的东西；CCode读取您的项目，编辑文件，运行命令并检查其工作，与您选择的任何模型。

```bash
npm install -g @ccode-si/cli
ccode
```

运行在macOS（苹果芯片和英特尔），Linux （x64和arm64）和Windows （x64和arm64）上。需要Node 18或更新版本才能安装。

## 开始

1.  在项目中打开终端并运行 `ccode`.
2.  新闻 `ctrl+p`,选择 **联系供应商**，粘贴一个API密钥并选择一个模型。
3.  输入你想要做的，然后按回车键。

```bash
ccode                    # start in the current folder
ccode -c                 # continue the latest session here
ccode -r <id>            # resume a session by id
ccode -p "<prompt>"      # one answer on stdout, for scripts
ccode update             # install the newest version
```

## 功能

**任何模型**

-   Anthropic, OpenAI，谷歌Gemini， DeepSeek, OpenRouter， CoreWeave和Z.ai编码计划，从应用程序内部连接。
-   本地模型通过Ollama， LM Studio, llama.cpp， vLLM或任何openai兼容的服务器。
-   在会话中切换模型 `/model`;设置每个模型的思考努力 `/effort`.

**在您的项目中工作**

-   读取、搜索、写入和编辑文件，并运行shell命令，包括后台的长命令。
-   读取图像和pdf文件，搜索网页和获取页面。
-   计划多步骤的工作，作为一个任务列表，你可以按照它进行。
-   `@` 将文件附加到消息中， `ctrl+v` 从剪贴板粘贴图像；在它工作时输入的消息将排队。

**你能掌控一切**

-   四种权限模式，循环使用 `shift+tab`： **汽车**， **接受编辑**， **手册** 和 **计划** （只读：它探索并提出一个计划供您批准）。
-   允许或拒绝命令、路径、工具和网站的规则，保存在您自己的设置中。
-   未经您的批准，您打开的存储库不能授予自己权限、更改模型或启动服务器。

**没有什么损失**

-   每个会话都会被保存。 `/session` 浏览、搜索和恢复它们； `/fork` 复制一个来尝试其他东西。
-   `/undo` 和 `/redo` 逐步进行对话； `/rewind` 把文件和对话放回任何回合之前。
-   长时间的对话会自动总结，所以任务可以继续进行。
-   记忆：CCode会记住你的更正和不同会话的站立偏好(`/memory`）。

**扩展它**

-   **子代理** 在自己的上下文中，也在后台进行搜索和辅助任务。添加你自己的。
-   **技能**：代理在合适的时候加载打包的指令，或者作为运行的指令 `/<name>`.
-   **MCP服务器**： `ccode mcp add …`，使用与其他代理的安装行相同的语法。
-   **钩子**：在工具调用之前和之后，在每个消息上，以及在任务结束时，您自己的命令。
-   **指导文件**： `CCODE.md`， `AGENTS.md` 和 `CLAUDE.md` 在一个项目中被跟踪。

**一个不碍事的终端UI**

-   串流的答案，彩色的差异编辑，和安静的步骤折叠成一行。
-   侧边栏，包含使用的上下文、成本、任务和修改的文件。
-   一次打开几个会话的选项卡（在设置中打开“选项卡”），下次重新打开。
-   语法高亮与选择的主题；透明的或黑色的背景
-   当任务完成或需要你时，桌面通知。
-   `/usage` 显示您的令牌，活跃的日子和条纹。

## 键

| 关键 | 行动 |
| --- | --- |
| `ctrl+p` | 每个设置和命令，可搜索 |
| `shift+tab` | 循环权限模式 |
| `shift+enter` | 新行 |
| `ctrl+v` | 从剪贴板粘贴图像(`alt+v` 也适用) |
| `esc esc` | 停止响应 |
| `ctrl+b` | 将正在运行的命令移到后台 |
| `ctrl+t` / `ctrl+n` | 有标签：新标签/下一个标签 |
| `ctrl+c` 两次 | 辞职 |

## 命令

`/help` 列出每个命令。最常用的是：

| 命令 | 它是做什么的 |
| --- | --- |
| `/model` | 更改模型 |
| `/session` | 浏览和恢复会话 |
| `/new` | 开始一个新的会话 |
| `/cd <path>` | 移动到另一个文件夹 |
| `/compact` | 总结对话，以释放上下文 |
| `/btw <question>` | 问一个附带的问题，但不要把它添加到谈话中 |
| `/undo` `/redo` `/rewind` | 前后迈步 |
| `/mcp` `/skills` `/hooks` `/memory` | 什么是安装和记忆 |
| `/settings` | 首选项 |

## 设置

偏好存在于 `~/.ccode/settings.json`； `ccode config` 显示了什么是有效的，它来自哪里。API密钥与设置分开保存在只有您才能读取的文件中，或者从环境变量中获取，例如 `ANTHROPIC_API_KEY` 和 `OPENAI_API_KEY`.

CCode每天检查一次新版本，并告诉你何时有新版本。用 `"updateCheck": false`.

## 许可证

CCode是专有软件：免费安装和使用，保留所有其他权利。看到 `LICENSE`． 第三方通知送达 `THIRD_PARTY_NOTICES.txt`.

## 常见问题

### @ccode-si/cli 是什么？

CCode -终端的编码代理。

### 如何安装 @ccode-si/cli？

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

### @ccode-si/cli 支持 TypeScript 吗？

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

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

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

### @ccode-si/cli 可以商用吗？

@ccode-si/cli 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @ccode-si/cli 还在维护吗？

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