C+ 懒人安装法

C+ 懒人安装法适合新电脑或想重新整理环境的用户。它会通过交互式向导安装 Claude Code / Codex，并写入 c-api 中转站配置。

重要：它会清理旧环境

安装器会先备份 ~/.claude 和 ~/.codex，再卸载旧的 Claude Code / Codex，并清理旧配置目录。已经有复杂自定义配置的用户，请先确认备份再继续。

适合谁看

• 第一次在电脑上配置 Claude Code 或 Codex。
• 之前装过但环境乱了，想重新安装一遍。
• 希望少复制配置文件，直接跟着终端向导走。

如果你已经装好了 Claude Code / Codex，只想导入 Key 和线路，可以直接看 ccswitch 一键配置。

开始前准备

安装前先准备三样东西：

项目	检查命令	要求
Node.js	node -v	18 或更高版本
npm	npm -v	能正常显示版本号
Git	git --version	能正常显示版本号

还需要准备你的 API Key：

• Claude Code 需要 Claude Code API Key。
• Codex 需要 Codex CLI API Key。
• 如果你选择安装 GrokSearch MCP，还需要 XAI_API_KEY。

运行安装器

Windows打开 PowerShell

推荐使用 Windows Terminal 或 PowerShell。不要在正在跑其他重要任务的终端里执行。

Windows先检查环境

依次执行 node -v、npm -v、git --version。任意一个报错，就先安装对应软件。

执行安装命令：

npx ticketpro-auto-setup

第一次运行时，npm 可能会询问是否下载并执行这个包，输入 y 后回车。Windows、macOS、Linux 的向导流程基本一致，按终端提示继续即可。

如果提示没有权限，不要急着加 sudo。先确认 Node.js 是正常安装在当前用户环境下；仍不确定时，优先到群里发截图确认。

向导里会问什么

安装器会按顺序做这些事：

1. 环境预检：检查 Node.js、npm、Git 是否可用。
2. 清理确认：说明会备份并清理旧的 Claude / Codex 配置。
3. 工具选择：可选 Claude Code + Codex、仅 Claude Code、仅 Codex。
4. API Key 输入：按你选择的工具输入对应 Key。
5. 扩展选择：选择是否安装附加能力。
6. 自动安装：安装 CLI，并写入 c-api 中转站配置。
7. 完成摘要：展示安装结果和失败项。

扩展怎么选

小白用户建议保持默认选择。看到不懂的扩展时，可以按下面理解：

扩展	用途	建议
code-abyss	编程和工程技能增强	默认保留
jshook-skill	JavaScript 逆向相关技能	做前端逆向时保留
GrokSearch MCP	接入 Grok 搜索能力	有 XAI_API_KEY 再选
HelloAGENTS	Codex 的流程化 Agent 能力	默认保留

如何确认成功

安装完成后，分别打开新终端测试：

claude --version
codex --version

如果你只安装了其中一个工具，只测对应命令即可。

然后进入任意项目目录，启动工具并发送一条简单消息：

请回复“配置已生效”。

看到正常回复就算完成

如果能收到模型回复，说明 CLI、API Key 和 Base URL 都已经接通。后续遇到报错，再去 FAQ 按现象排查。

失败时怎么办

现象	先做什么
node 或 npm 不存在	安装 Node.js LTS 后重新打开终端
git 不存在	安装 Git 后重新打开终端
API Key 输错	重新运行安装器，或改用 ccswitch / 手动配置
安装中断	重新打开终端再执行 npx ticketpro-auto-setup
安装后工具无响应	完全关闭终端，重新打开后再试

仍然无法解决时，把终端报错截图发到 QQ 群，优先包含：系统版本、执行的命令、最后 20 行报错。