实用指南5 分钟

配置基础

选择 .cflx.jsonc 位置、生成模板，并决定哪些文件应该提交到 git。

Conflux 使用 JSONC 作为配置格式。起步阶段最重要的不是做满配置，而是先拿到“可预测”的行为。

配置文件位置

Conflux 会按以下位置查找配置：

.cflx.jsonc
~/.config/cflx/config.jsonc
--config <PATH>

如果你希望配置随仓库一起复现，项目根目录下的 .cflx.jsonc 通常是最佳默认值。

生成模板

Terminal

cflx init cflx init --template opencode cflx init --template codex cflx init
--force

第一次使用时，通常直接执行 cflx init 就够了。

最小命令接线

一个面向 Claude Code 的最小模板如下：

{
  "analyze_command": "claude --dangerously-skip-permissions --verbose --output-format stream-json -p {prompt}",
  "apply_command": "claude --dangerously-skip-permissions --verbose --output-format stream-json -p '{prompt}'",
  "archive_command": "claude --dangerously-skip-permissions --verbose --output-format stream-json -p '{prompt}'",
  "acceptance_command": "claude --dangerously-skip-permissions --verbose --output-format stream-json -p '{prompt}'",
  "resolve_command": "claude --dangerously-skip-permissions --verbose --output-format stream-json -p {prompt}"
}

你可以把它替换成自己的代理 CLI，但尽量保留角色分离的结构。

提交还是忽略？

及早决定下面两类文件的策略，会让团队协作更顺畅：

./.claude/skills/cflx-*
./.cflx.jsonc

一个很实用的判断方式是：

选择	适用情况
全部提交	希望团队和多台机器行为一致
全部忽略	完全本地、一次性的个人实验

如果拿不准，通常更建议提交，但前提是不要把任何凭证直接写入 .cflx.jsonc。

建议的默认做法

第一次先尽量贴近自动生成模板
不要把实验性小技巧直接塞进团队共享配置
仓库特有行为优先放在项目本地配置中

尽量避免

不要把配置文件当成容纳所有运维怪癖的垃圾桶。如果某种做法会重复出现，更好的方式通常是补文档或提炼成可复用技能。

配置检查清单

在真正信任这份配置之前，最好确认：

对应代理 CLI 在 Conflux 之外也能单独运行
配置中的命令与你机器上实际安装的 CLI 一致
仓库已经明确生成文件的 commit / ignore 策略
.cflx.jsonc 中没有误放秘密信息