@ccode-si/cli

中文文档
1.3.0发布于 2026/11/01SEE LICENSE IN LICENSE零依赖

CCode -终端的编码代理。

中文使用文档
文档目录6 节
  1. 开始
  2. 功能
  3. 键
  4. 命令
  5. 设置
  6. 许可证

CCode

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

npm install -g @ccode-si/cli
ccode

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

开始

  1. 在项目中打开终端并运行 ccode.
  2. 新闻 ctrl+p,选择 联系供应商,粘贴一个API密钥并选择一个模型。
  3. 输入你想要做的,然后按回车键。
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 共发布 20 个版本,首次发布于 2026/10/13;过去 12 个月发布了 20 个版本。

版本发布日期距今
1.3.0latest2026/11/012 天前
1.2.22026/10/313 天前
1.2.12026/10/304 天前
1.2.02026/10/304 天前
1.1.12026/10/295 天前
1.1.02026/10/295 天前

关于 @ccode-si/cli 的常见问题

@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 和提交记录判断。