终端里的 AI 编码助手。它连上任何 OpenAI 兼容的 Chat Completions API，在本地帮你读代码、改文件、跑命令。零遥测，本地优先。
TUI（单体 ccode / 分离 ccode-tui）与 CLI 共用同一套 agent 核心；默认构建/安装只产出 ccode-cli（见下），TUI 手动构建，有 pty 集成测试覆盖（make test-tui-real）。
- 交互式对话（REPL）或单条提问，二选一
- 纯 CLI 命令行（
ccode-cli）；TUI（单体ccode/ 分离ccode-tui）默认不构建，手动make ccode ccode-tui - 一个
str_replace_editor看文件/改文件（含创建）、搜代码（glob/grep）、跑命令、抓网页、搜网页，还能派子代理干活 - Minimal 模式（
--minimal）：学 deepseek-harness 极简精神——固定一句话系统提示 + 只有编辑器和 bash 两个工具，最小化请求前缀 - Markdown 渲染成带颜色的终端输出
- 会话保存、列表、恢复
- 模型列表、搜索、切换
- 独立的 thinking / reasoning_effort 控制
纯 C、零运行时的收益最后落在开销上：在 harness-perf-benchmark 的同一份脚本化 mock、同样 100 个工具轮下，ccode 的整段资源开销（CU）是全场最低的——比第二名的 peri 低 5.3×，比 OpenCode v1 低约 170×；内存峰值 4.4 MB，另外 13 家在 96 MB 到 888 MB 之间。公开的 macOS 那批里还没有 ccode，这是同一套口径下它的第一份有效读数。
CU = 1.0 × 核·秒 + 1.0 × GB·秒：进程树口径的 CPU 与 RSS 对时间积分，1:1 折算；每家用 3 次运行里端到端时长居中的那一次。机器是 Core Ultra 7 265K（8P+12E，20 线程，62 GB，Debian 13，内核 6.12），10 ms 采样、含后代进程；数据是 2026-09-22 那一批，表里的版本号就是当时装到的版本。
| Harness | 版本 | CU ↓ | CPU 峰值（100 ms 窗） | CPU p95 | 内存均值 | 内存峰值 | 100 轮端到端 | 请求数 |
|---|---|---|---|---|---|---|---|---|
| ccode（本仓库源码构建） | c8fb352 · gcc 14.2 | 0.114 | 28% | 98% | 3.8 MB | 4.4 MB | 0.26 s | 100 |
| peri | 3.17.7 | 0.606 | 92% | 196% | 80.9 MB | 96.1 MB | 0.61 s | 102 |
| pi | 0.86.1 | 1.417 | 154% | 196% | 181.5 MB | 239.3 MB | 1.73 s | 135 |
| Claude Code | 2.1.278 | 2.680 | 158% | 196% | 283.1 MB | 319.1 MB | 2.24 s | 101 |
Antigravity CLI（agy） |
1.2.7 | 3.602 | 202% | 394% | 262.9 MB | 291.3 MB | 2.02 s | 105 |
Kimi Code（kimi） |
2.0.0 | 4.564 | 218% | 216% | 459.2 MB | 565.8 MB | 2.84 s | 101 |
| Codex CLI | 0.155.1 | 5.050 | 100% | 108% | 359.7 MB | 465.9 MB | 8.18 s | 101 |
OpenCode v2（opencode2） |
2.0.12 | 5.392 | 198% | 218% | 364.3 MB | 608.2 MB | 4.80 s | 102 |
Hermes Agent（hermes） |
0.21.3 | 7.519 | 147% | 99% | 135.1 MB | 158.6 MB | 20.91 s | 104 |
ZCode（zcode） |
0.16.9 | 8.487 | 254% | 198% | 594.2 MB | 887.7 MB | 5.39 s | 101 |
Cline（cline） |
3.0.62 | 9.784 | 200% | 196% | 401.4 MB | 630.4 MB | 5.89 s | 102 |
DeepSeek Harness（dsh） |
0.1.5-rc.2 | 10.555 | 184% | 109% | 249.2 MB | 344.1 MB | 12.20 s | 101 |
MiniMax Code（mcode） |
0.5.1 | 14.212 | 228% | 198% | 540.3 MB | 714.2 MB | 9.33 s | 101 |
OpenCode v1（opencode） |
1.18.31 | 19.228 | 327% | 293% | 722.1 MB | 842.1 MB | 8.79 s | 101 |
粗体是每列最省的一格。口径说明，免得数字被读过头：
- CU 是绝对量，可以跨机器比；0–100 的相对分只能批内比，所以这里不列分数。跨机器时 CU 会把机器一起带过来：同一份 peri 剧本在 8 线程的 T420 上是 3.406 CU，这台是 0.606 CU。
- ccode 0.26 秒就跑完 100 轮，10 ms 采样只拿到 24 拍，所以它的 CPU 峰值（包括这一列的 100 ms 滑窗）只当参考，主指标是 CU（面积）；单拍最大值不要引用。
- ccode 那 100 条请求 = 100 个工具轮（
--max-turns 100到顶即止，没有收尾请求）；别家 101–135 条里多出来的是各自的标题生成、上下文压缩、收尾请求，剧本按各家补齐，工具轮数都是同一个 100。 - Cline 的 CU 是下界（它的孙进程 shell 太短命，采样器读不到）；其余各家的后代 CPU 取「采样到的后代」与「已回收子进程计数器」的较大者，不相加。
- 复现与产物都在本地的 harness-perf-benchmark 检出里（含我加的 Linux procfs 采样后端与跑批器
run-batch.sh）：批次名265k-linux，每次运行的run.json/samples.csv/perf.log落在它的data/runs/下，图表数据由gen-chart-data.ts现算。
只需要一个 C 编译器（gcc 或 clang 都行）。TLS 库是内置的（mbedTLS 静态编译进二进制，retro 构建用 PolarSSL），构建时不依赖任何系统库。
make # 默认，带 HTTPS，只构建 ccode-cli
make ccode-cli # 只构建纯 CLI 后端
make ccode # 手动构建：单体 ccode（含 TUI，不进默认构建）
make ccode-tui # 手动构建：分离的 TUI 前端
make HTTP_ONLY=1 # 不要 TLS，纯 HTTP（内网/开发用）默认构建产物：
ccode-cli—— 纯 CLI 后端（REPL / 单条提问 / JSON Lines 服务），也能被其他前端（IDE 插件、脚本）复用。
手动构建（make ccode ccode-tui，不进默认构建与安装）：
ccode—— 单体二进制，TUI 和 CLI 都在里面。直接ccode进 TUI（agent 就在当前进程里跑，不 fork 子进程），ccode -p "..."当 CLI 用。ccode-tui—— 分离的 TUI 前端，会自动拉起同目录下的ccode-cli当后端。
二进制是自包含的：拷到任何机器上，只要有个 libc 就能跑 HTTPS，不需要那台机器上装有 OpenSSL / mbedTLS 之类的库。
生产可用：Linux riscv64。
已验证（构建+测试通过）：
- Linux x86_64（v1/v2/v3/v4）：gcc / clang 14
- Linux i386/i586（retro 真机已验）、arm64、riscv64：gcc
- Linux armv7（Kindle Paperwhite 3 真机 + armv7 测试套件）：gcc，静态 musl —— 见 Kindle 适配记录
- macOS arm64：clang（能用）
理论支持（src/platform/ 代码已就位，按目标三元组自动挑选，未做真机矩阵）：
Linux、macOS、PureDarwin（走 Darwin 路径，未验证）、FreeBSD / NetBSD / OpenBSD / DragonFlyBSD、Haiku、GNU Hurd、illumos / Solaris、MINIX 3、Windows（Cygwin / MSYS2）。
说明：写沙箱只有 Linux 上有（用内核的 Landlock）；其他平台退回到命令级过滤。CPU 架构层面代码无相关性（纯 C89 + POSIX），理论覆盖 gcc 和 clang 能到的全目标（x86、ARM、MIPS、PPC、s390x、LoongArch 等）。
export CCODE_API_BASE="https://api.deepseek.com"
export CCODE_API_KEY="sk-..."
export CCODE_MODEL="deepseek-v4-flash"
./ccode-cli --write -p "解释一下这个项目" # 单条提问（当前用法）
./ccode-cli --default # 交互 + 读写工具 + thinking
./ccode-cli --minimal --default # 极简模式：一句话提示 + 编辑器/bash 双工具其他兼容服务商同理，比如通义千问、智谱 GLM、MiniMax、OpenAI、或者 OpenCode Zen 网关，改一下 CCODE_API_BASE 和 CCODE_MODEL 就行。
会话名称以 .json 结尾。含空格的名称用引号包住：
/session new "project one.json"
/sessions rename "project one.json" "project two.json"
/sessions export "project two.json" md
/resume "project two.json"
导出文件写到当前工作区，三个前端都会返回文件名；省略格式时使用 JSON，其他可选格式为 md 和 txt。导出写入失败时保留已有完整文件。
两个 TUI 都把多行粘贴保留为一份草稿，按 Enter 后一起发送；Ctrl-U 清空草稿。单体 ccode 在请求期间按 Ctrl-C 取消，取消后可以继续聊天，空闲时按 Ctrl-C 退出；分离式 ccode-tui 的 Ctrl-C 会退出并停止后端。设置 CCODE_SESSION_AUTO_SAVE=0 只关闭自动落盘，当前聊天仍保留多轮记忆。
默认只连 https://。http:// 只放行本机回环（loopback，方便本地调试）；要连远程的明文 http，得显式打开 --allow-http 或设 CCODE_ALLOW_HTTP=1。这条规则在所有构建方式下都一样。
make test # 全套测试
make HTTP_ONLY=1 test # 纯 HTTP 构建下再跑一遍
make RETRO=1 test-json test-agent test-permissions test-markdown # retro 兼容层冒烟
bash scripts/make_ghost_disk.sh # 重建 BasicLinux 整盘镜像
make retro-test # QEMU 里构建冒烟（老 gcc）
make ccode ccode-tui ccode-cli && make test-tui-real # TUI 真实场景 pty 测试（两前端）
make test-tui-commands # 进程内 TUI slash 命令 pty 测试- 架构与部署 — 代码怎么组织、怎么构建部署
- 功能现状与路线图 — 已经做了什么、接下来做什么
- 开发原则 — 给改代码的人看的契约
- BasicLinux 3.5.1 适配 — 老系统移植的记录和踩坑
- Kindle Paperwhite 3 适配 — 往电子书阅读器上塞：ARM 静态构建、1.5 MB 内存上限、墨水屏 TUI
- 代码审计与技术债 — 可维护性结论、并发现状、技术债清单和收敛方向