Carbon Code
基于 DeepSeek 的终端编码工具，自动拆解、修改并验证开发任务。
按维度查看评分与理由
材料显示常规模式下存在命令、编辑、计划检查点和沙箱外路径访问的审批机制，聊天模式不启用文件系统或 shell 工具，初始化也默认保护已有规则文件；但明确存在可自动放行命令、后台进程及路径访问的 yolo 模式，且未提供完整权限矩阵。诊断数据的默认收集、排除内容、离线队列和关闭方式较透明，密钥存放与禁止提交也有说明，但未展示配置文件权限、静态加密或密钥轮换。CI 包含最小化权限的定期 CodeQL，依赖均有声明，但没有锁文件、依赖审计或漏洞处置证据。外部效果具备审批控制，却缺少通用回滚、编辑恢复或命令撤销方案。MIT、第三方声明位置、作者和仓库信息可见，但发布者未获验证，且 LICENSE 的 Reasonix Contributors 与 package 作者 Yapie0 之间的关系未解释。
README、包元数据、CI 和所给测试对命令名称、Node.js 版本、审批行为、MCP 加载及会话记录基本一致。依赖明确声明，并在 Ubuntu、Windows 上通过 npm ci 进入验证流程，但材料没有证明外部模型、npm 包或 MCP 服务不可用时的全面降级策略。MCP 初始化和解析失败会记录错误、关闭失败客户端并继续，同时给出 setup 提示；不过仅覆盖了有限错误路径，尚不足以证明所有网络、认证、写入及 shell 失败都提供可操作信息。
目标用户和个人开发工作流描述清楚，安装、聊天、一次性任务、项目初始化、健康检查和更新等场景均有明确入口，因此受众与场景得分充分。无工具聊天模式、安全范围、第三方 MCP 责任边界及不同编辑模式体现了一定能力边界，但 yolo 的风险和 ACP/MCP 参数并未在主 README 中完整说明。命令触发较精确，测试也验证多 MCP 前缀与禁用规则，但部分测试所示命令和选项缺少面向用户的对应文档。Node.js 22 要求、PowerShell 变通方案、双平台 CI、环境变量和配置路径使环境适配较完整。
README 的安装、命令、配置、诊断、许可与进一步文档链接组织合理，但所给材料没有完整导航或全面参考手册。安装说明覆盖全局、一次性和 Windows 情况，可给满分。carboncode/ccode 命名稳定且解释了不使用 cc 的原因，但代码中仍出现 Reasonix 命名痕迹，削弱一致性。示例较多且含一个常见 PowerShell 故障处理，但没有系统 FAQ。已知限制主要散落在安全范围和模式描述中，没有专门、完整的限制清单。MIT 正文和包元数据一致，第三方许可路径明确。仅看到 0.2.14 版本号，未见变更日志或兼容政策。维护渠道只有仓库 issues 和向所有者私报的笼统说明，没有明确维护团队、响应承诺或已验证身份。
命令设计、计划审批、验证流程、简洁会话轨迹以及带工具参数、用量和成本字段的 transcript 测试表明输出具有一般开发用途。自动任务、MCP、多代理和多提供商能力带来潜在增量价值，部分机制有测试佐证，但所给测试集中在 ACP/MCP 和审批边缘行为，不能充分支持整体自主开发能力。超过 90% Token 成本节省及接近 Claude Sonnet 4.6 的说法没有基准、方法、数据集或结果支撑，因此成本收益只能获得薄弱分。
部分操作性主张可由 package scripts、CI 和测试追溯，例如跨平台验证、MCP 失败继续、审批模式和 transcript 字段；但核心营销主张没有基准或实验记录，主张可追溯性有限。README、package.json、工作流、安全政策和测试对若干事实形成交叉印证，因此交叉佐证达到普通水平。材料没有清楚地区分已测试事实、设计意图和推测性比较，特别是“首个”“节省 90% 以上”和“接近 Sonnet 4.6”，故事实与推断分离较弱。
- yolo 模式会自动放行 shell 命令、后台进程和沙箱外路径访问；在含凭据、生产配置或重要未提交更改的仓库中启用前，应明确评估风险。
- 默认错误诊断会收集经脱敏的错误、fatal 元数据和堆栈；敏感环境应核查实际脱敏实现、队列文件权限与传输目的地，或先关闭该功能。
- 不要将“Token 成本节省 90% 以上”“中国第一个”或“接近 Claude Sonnet 4.6”视为已验证结论；所给材料没有相应基准证据。
- 配置文件被定义为凭据存储，但未展示权限强化或静态加密；应限制 ~/.carboncode/config.json 的访问并优先采用受控环境变量或密钥管理方案。
- 第三方 MCP 服务器被明确排除在安全政策范围之外；安装前需单独审查其代码、权限和数据流。
这个 Agent 能做什么，适合哪些场景？
Carbon Code 是一个以 TypeScript 开发、通过终端 CLI 使用的编码智能体，默认模型预设面向 DeepSeek V4。它在项目目录中读取和搜索代码，提出修改方案，以 diff 展示变更，并在获得确认后运行 shell 命令和测试。产品提供交互式编码、无文件系统和 shell 权限的纯聊天、单次非交互任务以及项目规则初始化等入口。CLI 支持 `carboncode` 和 `ccode`，用户配置保存在 `~/.carboncode/config.json`，项目规则可放在 `AGENTS.md` 或 `CARBON.md`。桌面端还支持标准 OpenAI 兼容提供方，可读取 `/models` 并适配 Responses API 与 Chat Completions API。它适合愿意让智能体在本地代码库中辅助修改和验证、同时希望保留命令执行确认环节的开发者。
典型流程是运行 carboncode 或 carboncode code [dir] 进入项目，随后由智能体读取并搜索代码、拆分任务、提出修改方案，并把拟议变更显示为 diff。需要执行 shell 命令时，它先征求用户确认，再按需运行测试验证结果，并为每次会话留下简洁记录。carboncode run "task" 可非交互执行一次任务，carboncode chat 提供不带文件系统和 shell 工具的聊天模式，carboncode init [dir] 则只读取 manifest、目录和工具配置来生成 CARBON.md，不调用模型。其他明确提供的操作包括 carboncode doctor 环境检查、carboncode update 更新 CLI、MCP 测试，以及与 Claude、Codex 等智能体协作。模型预设中，flash 使用 deepseek-v4-flash，pro 使用 deepseek-v4-pro，auto 从 Flash 开始并在困难回合一次性升级到 Pro。
- 使用 DeepSeek API、希望在本地仓库中交互式搜索代码、审阅 diff 并执行修改的开发者。
- 需要把明确的开发任务交给 CLI 单次非交互处理，并通过
carboncode run "task"接入脚本流程的团队。 - 接手已有 Node.js 或其他带 manifest 的项目，需要通过
carboncode init --dry-run预览并生成CARBON.md项目指南的维护者。 - 希望智能体运行测试和 shell 命令，但要求执行前保留人工确认的安全敏感型开发者。
- 需要测试 MCP，或尝试让 Carbon Code 与 Claude、Codex 协作的多智能体工作流使用者。
- 只需要模型对话、不希望会话拥有文件系统或 shell 工具权限的用户，可选择
carboncode chat。
这个 Agent 有哪些优点和局限？
- 覆盖从代码搜索、任务拆分、diff 审阅到命令确认和测试验证的完整本地开发流程。
- 同时提供交互式编码、纯聊天和
carboncode run非交互任务模式，适配手工与脚本化使用场景。 carboncode init不调用模型，并提供--dry-run和默认不覆盖现有规则文件的保护机制。- 桌面端支持标准 OpenAI 兼容提供方，可发现
/models并适配 Responses API 与 Chat Completions API。 - 文档明确提供 MCP 测试及与 Claude、Codex 协作的能力。
- CLI 要求 Node.js 22 或更新版本，旧版 Node.js 环境需要升级。
- 默认模型配置依赖 DeepSeek API Key；仓库宣称节省 90% 以上 Token 成本，但所给材料没有基准、测试方法或实际账单数据。
- 桌面端的安装和部署步骤未在所给材料中说明，只有模型提供方配置方式。
- 与 Claude、Codex 的多智能体协作及 MCP 测试缺少具体配置步骤、支持范围和验收示例。
- 默认上传经脱敏的 error/fatal 错误元数据和堆栈；有严格遥测政策的团队需要显式关闭，并留意离线事件暂存目录。
如何安装或部署这个 Agent？
前提是安装 Node.js 22 或更新版本，并准备 DeepSeek API Key。
全局安装并在项目中启动：
npm install -g @carboncode/cli
cd path/to/project
export DEEPSEEK_API_KEY=sk-...
carboncode也可以运行短命令 ccode，或不全局安装而直接执行 npx @carboncode/cli。Windows PowerShell 如果阻止 npm.ps1，可改用 npm.cmd install -g @carboncode/cli。首次运行向导也可以配置 DeepSeek API Key；持久配置文件位于 ~/.carboncode/config.json。
如何使用这个 Agent？
在当前项目中运行 carboncode，或用 carboncode code [dir] 指定目录。检查智能体展示的修改方案和 diff；当它申请运行 shell 命令时确认或拒绝，并让它按需执行测试。单次任务使用 carboncode run "task"，无文件系统和 shell 权限的聊天使用 carboncode chat，环境排查使用 carboncode doctor。初始化项目规则时先运行 carboncode init --dry-run 查看差异，再运行 carboncode init；已有规则文件默认不会覆盖，确需覆盖时使用 carboncode init --force --yes。检查和安装最新 CLI 可运行 carboncode update。桌面端如需使用 OpenAI 兼容提供方，可在“设置 -> 模型 -> 添加模型提供方”中填写 Base URL 和 API Key。
这个 Agent 与同类方案有什么区别？
项目将 Carbon Code 定位为类似 Claude Code 的工具，并称其能力接近 Claude Sonnet 4.6；同时强调默认使用 DeepSeek、Token 成本节省 90% 以上。所给材料没有提供统一任务、质量评测、延迟数据或成本计算方法，因此这些能力和成本对比应视为项目方陈述，而不是经过材料验证的基准结果。与只提供单一模型路径的终端工具相比，Carbon Code 的桌面端还记录了标准 OpenAI 兼容提供方支持。
常见问题
运行 Carbon Code 需要哪些凭据？
DEEPSEEK_API_KEY 环境变量提供。桌面端使用 OpenAI 兼容提供方时，需要相应的 Base URL 和 API Key。它会未经允许执行本地命令吗？
carboncode chat。会上传代码或对话吗？
CARBONCODE_DIAGNOSTICS=off，或在配置中使用 {"diagnostics":{"enabled":false}} 关闭。网络中断时诊断数据如何处理？
~/.carboncode/diagnostics/pending/，并受数量和大小上限约束；材料没有给出具体上限数值。初始化项目会覆盖现有规则文件或调用模型吗？
carboncode init 只读取仓库中的 manifest、目录和工具配置，不调用模型。现有规则文件默认不会被覆盖；可先使用 --dry-run，需要覆盖时再显式传入 --force。