快速开始
完成安装、初始化项目、创建第一个 proposal，并跑通第一次 Conflux 运行。
这份指南的目标，是让你用最短路径完成第一次真正有价值的 Conflux 运行。
重要
Conflux 不是编码代理本身。它是编排层，用来启动并协调 Claude Code、Codex、OpenCode 等外部 CLI。
前置条件
先确认这三件事：
- 已安装 Rust / Cargo
- 你有一个 git 管理的项目，或者可以新建一个
- 至少一个外部编码代理 CLI 已安装并完成认证
cargo --version claude --version claude -p 'hi'如果你使用的不是 Claude Code，请把示例命令替换成自己的代理 CLI。
安装 CLI
最常见的安装方式是直接从 crates.io 获取。
cargo install cflx cflx --version准备项目目录
因为 Conflux 依赖 git worktree，目标项目必须在 git 下。
mkdir -p ~/myproject cd ~/myproject git init如果你已经有现成仓库，直接进入对应目录即可。
安装 bundled skills
第一个实用动作，是给你的代理安装 cflx-* 技能。
cflx install-skills --claude这会把技能放到当前项目下的 ./.claude/skills/。
生成配置文件
Conflux 使用 .cflx.jsonc。
cflx init第一次运行通常直接使用生成模板即可。如果需要，也可以使用 --template codex 或 --template opencode。
创建第一个 change proposal
Conflux 处理的是 OpenSpec change。最短路径是在你的编码代理会话里调用 proposal 技能。
/cflx-proposal display hello world in python
至少检查下面这些文件：
proposal.mdtasks.mdspecs/.../spec.md
如果 proposal 没问题，就把它提交到 git。
git add openspec/changes/add-hello-world git commit -m 'proposal:
add-hello-world'
运行 Conflux
运行前先确保工作区是干净的。
git status常用运行方式有三种：
| 模式 | 命令 | 适合场景 |
|---|---|---|
| TUI | cflx | 本地交互式运行 |
| Headless | cflx run | 非交互式、脚本化执行 |
| Server | cflx server | 浏览器仪表盘与 API 访问 |
如果你使用 TUI，最短操作路径是：
- 选择目标 change
- 按
Space标记执行 - 按
F5开始运行
什么算第一次成功
初次评估时，最好至少确认这些点：
- change 能够通过 apply 和 acceptance 的主要流程
- 你能从日志看懂发生了什么
- 你知道生成的 diff 是可以 merge，还是需要继续跟进
建议
第一次尝试时，不必追求完全自动化。cflx server 能通过仪表盘显著降低理解成本。
首次运行常见问题
代理命令立刻失败
先在 Conflux 之外确认 CLI 本身能工作。如果 claude -p 'hi' 失败，优先解决代理环境，而不是先怀疑 Conflux。
proposal 太大
请把工作拆成更小的 OpenSpec change。Conflux 在范围清晰时会稳定得多。
运行前工作区就是脏的
请先清理无关本地修改。否则很难判断结果到底来自 Conflux 还是来自已有改动。