fauxnix接入5大AI编程助手实战：Claude Code、Codex、OpenCode、Kimi、Qwen配置全解析

fauxnix 是一个运行在 Windows 上的 bash→PowerShell 确定性翻译层，专为 AI 编程助手设计：你的 Agent 继续写它最熟悉的 bash 命令（ls -la | grep foo），fauxnix 自动翻译成 PowerShell 原生执行，并返回 GNU 风格的输出。它内置 MCP 服务器，一条命令即可接入 Claude Code、Codex、OpenCode、Kimi Code、Qwen Code 五大 AI 编程助手，无需虚拟机，无需 WSL，也不需要安装完整的 bash 工具链。

一、为什么 AI 助手在 Windows 上需要 fauxnix？

大模型训练数据中 bash 远多于 PowerShell，导致模型在 Windows 上经常产出"看着对、跑不通"的命令：引号写错、curl不是真正的 curl、中文乱码、满屏看不懂的CategoryInfo错误堆栈。

fauxnix 的解法是"翻译，而不是模拟"：把 Linux 命令行中价值最高的一大子集（文件操作、文本处理、进程管理、网络基础，共 109 条命令）忠实映射到 PowerShell + .NET，遇到翻译不了的命令会大声报 bash 风格的错误，绝不让 Agent 拿到"看似正确实则错误"的结果。

二、一键安装步骤：准备工作只要 3 条命令

接入任何 AI 助手之前，先完成全局安装。环境要求：Windows + PowerShell 5.1（系统自带）+ Node.js ≥ 22.20.0。

npm install -g fauxnix-cli # 注意 npm 包名是 fauxnix-cli fauxnix doctor # 验证编码、harness 配置和 MCP 往返

💡 小坑提醒：npm 上的fauxnix名字属于另一个 2015 年的 websocket 库，所以安装命令用的是fauxnix-cli，但安装后的命令仍叫fauxnix。

装好后可以零安装试用一下效果：

npx fauxnix-cli@latest "ls -la src | head -3"

三、五大 AI 编程助手配置全解析

每个助手都有官方的一键安装命令，且幂等（重复执行安全、只打印实际变更）。下面逐一拆解配置细节，想手动改配置文件的也可以直接抄作业。

3.1 Claude Code 接入：写入 .claude.json

fauxnix install --claude

等价的 harness 原生命令是claude mcp add fauxnix -- fauxnix mcp。配置写入%USERPROFILE%\.claude.json的mcpServers.fauxnix字段（若设置了CLAUDE_CONFIG_DIR则写入该目录）。详细文档见 docs/examples/claude.md。

3.2 Codex 接入：TOML 配置 + 一个审批陷阱

fauxnix install --codex

写入%USERPROFILE%\.codex\config.toml，追加如下表段即可（docs/examples/codex.md）：

[mcp_servers.fauxnix] command = "fauxnix" args = ["mcp"]

⚠️重点坑点：在非交互的codex exec模式下，MCP 工具调用会被审批层自动拒绝。需要加--dangerously-bypass-approvals-and-sandbox参数，或者改用交互模式批准一次。

3.3 OpenCode 接入：注意两种 JSON 形态

fauxnix install --opencode

默认写入%USERPROFILE%\.config\opencode\opencode.json。这里有个容易出错的细节（docs/examples/opencode.md）：

• 默认形态是mcp.fauxnix；
• 如果你已有mcp.servers对象，应该把 fauxnix 放进mcp.servers.fauxnix，不要再额外加一个兄弟键mcp.fauxnix。

3.4 Kimi Code 接入：MCP 在 JSON 里，不在 TOML 里

fauxnix install --kimi

Kimi Code 的 MCP 服务器不放在 TOML 配置里，而是独立的 JSON 文件%USERPROFILE%\.kimi-code\mcp.json（docs/examples/kimi.md）。如果设置了KIMI_CODE_HOME则写入%KIMI_CODE_HOME%\mcp.json。

3.5 Qwen Code 接入：绝对路径启动器最省心

fauxnix install --qwen

Qwen Code 写入%USERPROFILE%\.qwen\settings.json（docs/examples/qwen.md），但它和前四个不同：安装器会生成一个绝对路径的 Node + 包入口启动器，例如：

{ "mcpServers": { "fauxnix": { "command": "C:\\Program Files\\nodejs\\node.exe", "args": ["C:\\...\\fauxnix-cli\\dist\\index.js", "mcp"] } } }

这样 Qwen 启动时不依赖工作目录和PATH顺序。注意：如果你之后移动或重装了 Node.js / fauxnix-cli，重新跑一次安装命令即可。

四、接入后如何验证：doctor + 10 条冒烟命令

所有助手装完都必须重启一次，让 harness 重新加载 MCP。然后按以下顺序验证（完整清单见 docs/examples/README.md）：

fauxnix check # 快速自检 fauxnix doctor # 报告例如 "claude : fauxnix MCP configured (...)"

再到助手里用 MCP 的bash工具（不是 PowerShell 窗口！）跑冒烟测试，全部应返回 0：

echo hi # hi printf '%s=%d\n' x 42 # x=42 echo hi | grep hi # hi true; echo $? # 0

效果到底值不值？官方用同一模型、同一批 5 个任务做了对比实测：PowerShell 直写需要 14 次工具调用、9 次意外错误、163 秒；fauxnix 只要 7 次调用、0 错误、66 秒，达到真 Git Bash 上限的 ~85% 效率，且不装任何 bash 工具链。

五、进阶技巧：像"登录过的 shell"一样用

fauxnix 的 MCP 会话不是无状态的exec——它在多次工具调用之间持久保留工作目录、环境变量、export/unset、cd -/OLDPWD 和位置参数（set --/$1/"$@"），对 Agent 来说就像一个一直登录着的终端。

此外，对于命令已知的批量工作流，MCP 服务器还暴露了bash_batch工具：一次性编译所有步骤、原子执行整个计划，一次 MCP 往返返回每步的结构化结果。详见 docs/rfc-mcp-batch-plans.md，MCP 服务器实现在 src/mcp.ts。

六、常见问题速查

七、总结

一句话总结：装一次fauxnix-cli，挑一个--harness参数，重启助手，跑fauxnix doctor确认——你的 AI 编程助手从此在 Windows 上也能丝滑地写 bash 了。