Claude和Codex如何切换Claude-to-IM-skill的CTI_RUNTIME三种运行模式完全指南【免费下载链接】Claude-to-IM-skillBridge Claude Code / Codex to IM platforms — chat with AI coding agents from Telegram, Discord, or Feishu/Lark.项目地址: https://gitcode.com/gh_mirrors/cl/Claude-to-IM-skillClaude-to-IM-skill是一款把 Claude Code / Codex 接入 Telegram、Discord、飞书、QQ、微信的桥接工具让你直接用手机 IM 指挥 AI 写代码。它通过一个环境变量CTI_RUNTIME决定背后由哪个 AI 引擎驱动支持claude、codex、auto三种运行模式。这篇指南将带你看懂三种模式的区别、各自的前置条件以及一键切换 Codex 或 Claude 的完整步骤。为什么需要切换 AI 引擎Claude-to-IM-skill 的核心架构是一条消息管道你 (Telegram/Discord/飞书/QQ/微信) ↕ Bot API 后台守护进程 (Node.js) ↕ Claude Agent SDK 或 Codex SDK由 CTI_RUNTIME 决定 Claude Code / Codex → 读写你的代码库同一个 IM 机器人、同一套权限审批按钮、同一流式回复体验底层引擎却可以自由选择Claude CodeAnthropic 的编码智能体功能成熟、工具调用丰富CodexOpenAI 的编码智能体适合已有 OpenAI 生态的用户好消息是切换引擎不需要改任何 IM 配置只需改一行配置。这就是CTI_RUNTIME的价值。三种运行模式一览模式值使用的引擎前置条件适用场景Claude 模式claude默认Claude Code CLI Claude Agent SDK已安装并登录claudeCLI主力用 Claude 的用户Codex 模式codexCodex SDK (openai/codex-sdk)已安装codexCLI 并完成鉴权主力用 OpenAI 的用户自动模式auto先试 Claude失败回退 Codex两者装一个即可双引擎都装、想要容错完整配置项说明见 config.env.example# Runtime backend: claude | codex | auto # claude (default) — uses Claude Code CLI anthropic-ai/claude-agent-sdk # codex — uses openai/codex-sdk (auth: codex auth login, or OPENAI_API_KEY) # auto — tries Claude first, falls back to Codex if CLI not found CTI_RUNTIMEclaude 配置统一存放在~/.claude-to-im/config.env权限chmod 600守护进程启动时由 src/config.ts 读取并校验非法值会自动回退为claude。claude 模式默认选择启动即校验claude是缺省模式也是默认写入配置文件的值。启动时守护进程会做两件事见 src/main.ts 的resolveProvider()查找 Claude CLI依次尝试CTI_CLAUDE_CODE_EXECUTABLE环境变量、/usr/local/bin/claude、/opt/homebrew/bin/claude等常见路径Preflight 预检运行claude --version验证版本 ≥ 2.x并检查--help中是否包含 SDK 所需的关键参数⚠️ 关键点在claude模式下CLI 找不到或预检失败会直接让守护进程退出而不是等到第一条消息才报错——这样错误更容易诊断。如果报找不到claude你可以安装 Claude Code CLI 并执行claude auth login登录或者把CTI_RUNTIME改成codex/auto如果你同时存在多个版本的claude比如 npm 装的 1.x 和原生 2.x可以用CTI_CLAUDE_CODE_EXECUTABLE/path/to/claude显式指定。codex 模式切换 OpenAI 引擎的完整步骤想完全用 Codex 驱动按下面三步走① 安装 Codex CLInpm install -g openai/codex② 完成鉴权二选一codex auth login # 交互式登录推荐或在config.env中配置 API Key优先级为CTI_CODEX_API_KEYCODEX_API_KEYOPENAI_API_KEY# CTI_CODEX_API_KEY # CTI_CODEX_BASE_URL③ 修改配置并重启桥接CTI_RUNTIMEcodex然后重启守护进程使配置生效Claude Code 中/claude-to-im stop→/claude-to-im startCodex 中直接说stop bridge再说start bridge⚙️ 两个 Codex 专属开关值得了解实现见 src/codex-provider.tsCTI_CODEX_SKIP_GIT_REPO_CHECKtrue允许 Codex 在非受信 Git 仓库目录运行默认关闭出于安全考虑建议保持关闭CTI_DEFAULT_MODEL在 Codex 模式下默认不透传给 Codex CLI它使用自己的默认模型另外 Codex 会把桥接的权限模式映射为审批策略code模式 →on-failure自动批准大部分操作plan/ask模式 →on-request执行前询问审批入口依然是你 IM 里的按钮或/perm命令。auto 模式智能容错双引擎自动切换auto是两边都装、谁好用谁的省心模式也是官方在 claude 模式报错时推荐的排障出路。它的决策逻辑src/main.ts 中第 43-62 行先解析 Claude CLI 路径找到后执行 preflight 预检预检通过→ 使用 Claude日志打印Auto: using Claude CLI at ...CLI不存在或预检失败→ 打印警告并回退到 Codex而不是静默使用一个坏掉的 CLI这种设计让auto模式在团队共用场景很实用有人电脑上只装了 Codex桥接依然能跑。如何切换一条 reconfigure 搞定切换引擎的最快方法是用交互式重配置而不是手动改文件环境命令Claude Code/claude-to-im reconfigureCodexreconfigure / 修改配置向导会显示当前配置表密钥脱敏到后 4 位只需回答 Runtime 这一项选择claude/codex/auto然后原子更新配置文件并重新验证。⚠️ 改完记得先stop再start守护进程不会热加载新运行时。首次配置则用/claude-to-im setup向导Runtime 也是其中一步见 SKILL.md Step 3。切换后怎么验证doctor 一键体检切换引擎后建议跑一次诊断它会根据当前CTI_RUNTIME只检查对应引擎的依赖逻辑见 scripts/doctor.shclaude/auto模式检查 Claude CLI 版本、Claude Agent SDK 的cli.js是否存在codex/auto模式检查codexCLI 是否在 PATH、openai/codex-sdk是否安装、鉴权是否可用API Key 或codex auth status显示已登录/claude-to-im doctor # Claude Code doctor / 诊断 # Codex一个贴心的细节auto模式下某一边缺依赖只会显示OK for auto/xxx mode不会误报失败——因为它只作备用。切换后常见症状原因解决守护进程直接退出目标引擎 CLI 缺失/预检失败按错误提示安装 CLI 或改回autoCodex 报 SDK 未安装缺少openai/codex-sdk在 skill 目录执行npm installCodex 鉴权失败未登录且无 API Keycodex auth login或配置OPENAI_API_KEYCodex 拒绝在工作目录运行非受信 Git 仓库确认目录正确或显式设CTI_CODEX_SKIP_GIT_REPO_CHECKtrue 更多排障步骤参考 references/troubleshooting.md日常使用命令见 references/usage.md。三种模式怎么选决策清单✅只用 Claude→claude默认校验最严格问题暴露最早✅只用 OpenAI / Codex→codex记得完成codex auth login✅不确定、或团队环境参差不齐→auto有 Claude 用 Claude没有自动切 Codex容错性最强✅临时排障→ 若claude模式报 CLI 错误且暂时装不好先切auto让 Codex 顶班不中断桥接服务小结CTI_RUNTIME是 Claude-to-IM-skill 中最值得先搞懂的配置项一行claude/codex/auto决定你的 IM 机器人背后是哪颗AI 大脑。记住三个要点——改配置要重启stop→ 修改 →start切完先体检doctor会按当前模式精准检查依赖拿不准选auto自动预检 优雅回退是省心之选配置好之后从手机发一句帮我重构这个函数你的 AI 编码智能体就开始干活了。【免费下载链接】Claude-to-IM-skillBridge Claude Code / Codex to IM platforms — chat with AI coding agents from Telegram, Discord, or Feishu/Lark.项目地址: https://gitcode.com/gh_mirrors/cl/Claude-to-IM-skill创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
