Carbon Code

中文优先、DeepSeek 驱动的终端代码智能体，基于 DeepSeek-Reasonix 主体进行 Carbon Code 产品化。

Carbon Code 面向个人开发者工作流：进入一个仓库，让智能体读取和搜索代码、规划 修改、展示 diff、在执行 shell 命令前请求确认、按需运行验证，并输出简洁结果。

安装

要求 Node.js 22 或更新版本。

npm install -g @carboncode/cli
cd path/to/project
carboncode

短命令：

ccode

不全局安装也可以临时运行：

npx @carboncode/cli

常用命令

| 命令 | 用途 | | --- | --- | | carboncode / carboncode code [dir] | 以当前项目为根目录的编码智能体。 | | carboncode chat | 不带文件系统和 shell 工具的纯聊天。 | | carboncode run "task" | 非交互式执行一次任务。 | | carboncode doctor | 本地环境健康检查。 | | carboncode update | 检查并安装最新 CLI 包。 |

Carbon Code 也安装 ccode。默认不会安装 cc，因为这个名字通常是系统 C 编译器。

配置

用户配置文件位置：

~/.carboncode/config.json

可以通过首次运行向导配置 DeepSeek API Key，也可以直接导出环境变量：

export DEEPSEEK_API_KEY=sk-...

项目规则建议写在仓库里的 AGENTS.md 或 CARBON.md。

模型预设使用当前 DeepSeek V4 API ID：flash 对应 deepseek-v4-flash， pro 对应 deepseek-v4-pro，auto 默认从 Flash 开始，并在困难回合一次性升级 到 Pro。

发布

npm 发布由 GitHub Actions 的 tag 流程触发。先更新 package.json，提交发布版本， 再推送匹配的 semver tag：

git tag v0.1.0
git push origin main --tags

Publish npm package workflow 会先验证包、检查 tag 是否与 package.json 版本一致， 然后执行 npm publish --access public --provenance。

当前范围

当前策略是“导入 Reasonix 主体，然后做 Carbon Code 产品化”。第一轮产品化覆盖 包名、命令名、Carbon 配置目录、更新/安装命令、中文优先 CLI 文案、npm 发布流程 和开源许可归因。

许可与归因

Carbon Code 使用 MIT 许可证。项目基于 MIT 许可的 DeepSeek-Reasonix 派生。

上游声明保留在：

• THIRD_PARTY_NOTICES.md
• LICENSES/DeepSeek-Reasonix-MIT.txt

不要移除派生源码中的上游 copyright 或 MIT notice。