1. 从“openrig”这个名字说起它到底想解决什么问题第一次看到“openrig”这个词我脑子里蹦出来的不是某个具体软件而是一种“开放式工作台”的意象。rig 在英文里本意是“装配、搭建”在工程语境里常指一套成套的设备或支架比如采矿用的钻井架、舞台的灯光架。前面加个 open意思就很明确了——这是一套开放的、可自由拼装的工具组合。结合热搜词里高频出现的 Claude Code、Codex、Node.js、tmux 这几个关键词我基本能判断出 openrig 的定位它大概率是一个围绕 AI 编程助手Claude Code、Codex 这类 CLI 工具搭建的本地开发环境脚手架或配置集合目标是把散落在各处的安装、配置、模型接入、终端复用这些琐事打包成一套可复用的方案。为什么我敢这么判断因为热搜词几乎把当前 AI 编程工具链的痛点全暴露了。你看这些词“cc switch local proxy failed while handling codex endpoint /responses”、“codex is ignoring 1 unrecognized configuration setting”、“your organization has disabled claude subscription access”、“error installing 24.21.0: node.js v24.21.0 is not yet released”。这些全是实打实的报错信息是无数人在配置 Claude Code 和 Codex 时踩过的坑。openrig 要做的就是把这些坑提前填平让你不用再一个个去搜“codex安装教程”“claude code windows”“ubuntu 安装claude code”。我个人的理解是openrig 不是一个单一软件而更像一套“约定俗成的目录结构 配置模板 启动脚本”的组合。它可能包含几个部分一个统一的 Node.js 环境管理方案因为 Claude Code 和 Codex 都依赖 Node.js一套 tmux 会话配置用于同时跑多个 AI 助手而不互相干扰以及针对不同模型后端本地 LM Studio、DeepSeek、Qwen、GLM 等的接入配置。这套东西的价值在于它把“安装 Claude Code”“安装 Codex”“配置本地模型”这些重复劳动标准化了你拿到手就能用不用从零开始折腾。适合谁来参考我觉得有三类人最需要第一类是刚接触 AI 编程助手的新手面对一堆安装教程和报错信息完全不知道从哪下手第二类是在多台机器比如公司台式机、家里笔记本、远程服务器上都要配置环境的开发者每次重装系统都要重新折腾一遍第三类是喜欢折腾本地模型、想把 Claude Code 接到 LM Studio 或 DeepSeek 上的进阶用户需要一套灵活的配置框架来管理不同的模型端点。如果你属于这三类中的任何一类接下来的内容应该能帮你省下不少时间。2. Node.js 环境一切折腾的起点也是最容易翻车的地方2.1 为什么 Node.js 版本选择是个“隐形杀手”Claude Code 和 Codex 这两个 CLI 工具都是基于 Node.js 生态构建的这意味着你的 Node.js 版本直接决定了它们能不能跑起来。热搜词里有一条特别扎眼“error installing 24.21.0: node.js v24.21.0 is not yet released or is not available”。这个报错说明什么说明有人在安装时指定了一个根本不存在的版本号或者用了某个版本管理工具去拉取一个还没正式发布的版本。这种情况在新手身上特别常见因为网上教程里写的版本号可能已经过时或者教程作者用的是测试版你照着抄就翻车了。我的经验是永远不要盲目追新。Node.js 的发布节奏是偶数版本号如 18、20、22是 LTS长期支持版奇数版本号如 19、21、23是短期实验版。LTS 版本会获得长达 30 个月的安全更新和维护而奇数版本只维护几个月就停止支持了。对于 openrig 这种需要稳定运行的环境你必须用 LTS 版本。目前截至我写这篇内容时比较稳妥的选择是 Node.js 20 LTS 或 22 LTS。热搜词里出现的“node.js lts下载”“node.js官网下载”也印证了大家都在找 LTS 版本。那怎么管理 Node.js 版本直接去官网下载安装包是最简单的方式但如果你需要在多个项目间切换不同 Node.js 版本或者经常重装系统我强烈建议用版本管理工具。Windows 上可以用 nvm-windowsmacOS 和 Linux 上可以用 nvm 或 fnm。以 nvm 为例安装好之后你可以这样操作# 查看当前可用的 LTS 版本 nvm ls-remote --lts # 安装 Node.js 20 LTS nvm install 20 # 设置为默认版本 nvm alias default 20 # 验证安装 node -v npm -v这样装出来的 Node.js 是干净的不会污染系统全局环境。而且当你需要切换到其他版本时一条nvm use 18就搞定了不用卸载重装。2.2 npm 全局安装的权限陷阱与镜像加速Node.js 装好之后下一步就是安装 Claude Code 和 Codex。这两个工具通常是通过 npm 全局安装的命令大概是npm install -g anthropic-ai/claude-code和npm install -g openai/codex具体包名以官方文档为准。但这里有个坑在 Linux 和 macOS 上如果你直接用系统自带的 Node.js全局安装可能会因为权限问题失败报一堆 EACCES 错误。这是因为 npm 默认会把全局包装到/usr/local/lib/node_modules这种需要 root 权限的目录。解决办法有两个一是用 nvm 管理 Node.js这样全局包会装到用户目录下不需要 sudo二是手动配置 npm 的全局目录。我推荐第一种因为更干净。如果你已经用 nvm 了那全局安装基本不会遇到权限问题。另一个坑是网络问题。npm 默认从官方源拉包在国内网络环境下可能会很慢甚至超时。这时候可以切换镜像源# 查看当前源 npm config get registry # 切换到国内镜像 npm config set registry https://registry.npmmirror.com # 如果需要恢复官方源 npm config set registry https://registry.npmjs.org注意镜像源虽然快但有时候同步会有延迟如果某个包刚发布不久镜像上可能还没有。遇到这种情况临时切回官方源装完再切回来就行。2.3 验证 Node.js 环境是否真的“干净”装完 Node.js 和 npm 之后别急着装 Claude Code 和 Codex先做几个检查。第一确认node -v和npm -v输出的版本号符合预期。第二确认which node和which npm指向的是你刚装的那个版本而不是系统自带的旧版本。第三跑一个最简单的 Node.js 脚本确认运行时没问题node -e console.log(Node.js is working, version:, process.version)如果这行命令能正常输出说明 Node.js 环境是健康的。如果报错那就要回头检查 PATH 环境变量是不是没配好。在 Linux 和 macOS 上nvm 会在你的 shell 配置文件如.bashrc、.zshrc里加一段初始化脚本确保新开的终端能自动加载 nvm。如果你发现每次新开终端都要手动 source 一下 nvm 才能用那就是这段脚本没加对。3. Claude Code 与 Codex 的安装那些教程不会告诉你的细节3.1 Claude Code 安装从“country not available”到成功运行热搜词里有一条很显眼“note: claude code might not be available in your country. check supported co”。这个提示说明 Claude Code 在某些地区可能无法直接使用。遇到这种情况我的建议是先确认你的网络环境是否满足官方要求如果确实不支持可以考虑使用国内可访问的替代方案比如通过第三方 API 接入 DeepSeek、Qwen、GLM 等模型。热搜词里也出现了“使用cc switch 接入 deepseek v4, qwen, glm等模型”说明已经有人在做这种适配了。假设你的环境没问题安装 Claude Code 的流程大概是这样的# 全局安装 Claude Code npm install -g anthropic-ai/claude-code # 验证安装 claude --version安装完成后第一次运行claude会引导你进行登录或配置 API Key。如果你用的是官方服务可能需要通过浏览器完成 OAuth 授权。如果你用的是第三方 API就需要在配置文件里指定 API 端点和密钥。Claude Code 的配置文件通常位于~/.claude/目录下你可以手动编辑config.json或类似文件来指定模型和端点。这里有个细节热搜词里出现了“your organization has disabled claude subscription access for claude code”。这个报错说明你的账号所属组织禁用了 Claude Code 的订阅访问权限。如果你是在公司环境下使用可能需要联系管理员开通权限如果是个人账号检查一下订阅状态是否正常。3.2 Codex 安装配置项拼写错误是头号杀手Codex 的安装流程和 Claude Code 类似也是通过 npm 全局安装。但热搜词里有一条特别典型的报错“codex is ignoring 1 unrecognized configuration setting. check for typos or d”。这个报错的意思是Codex 在读取配置文件时发现了一个它不认识的配置项于是忽略掉了并提醒你检查拼写。这种情况通常是因为你抄了某个教程里的配置但那个配置项在新版本里已经被重命名或移除了。我的经验是Codex 的配置文件通常是~/.codex/config.toml或类似路径里的每一项都要对照官方文档确认。不要盲目复制网上的配置因为 Codex 更新很快配置格式可能几个月就变了。如果你不确定某个配置项是否有效可以先注释掉然后逐步启用来排查。另一个常见问题是“codex无法加载组织设置”。这个报错通常和账号权限或网络环境有关。如果你用的是企业账号可能需要管理员在后台开启相应权限。如果是个人账号检查一下 API Key 是否有效、是否过期。3.3 安装后的首次运行检查清单装完 Claude Code 和 Codex 之后别急着写代码先做一轮基础检查。我整理了一个清单你可以照着过一遍检查项命令预期结果Node.js 版本node -v输出 LTS 版本号如 v20.x.xnpm 版本npm -v输出对应版本号Claude Code 版本claude --version输出版本号无报错Codex 版本codex --version输出版本号无报错配置文件存在ls ~/.claude/ ~/.codex/能看到配置文件API 连通性运行一个简单对话能正常返回结果如果某一步报错就针对性地去搜报错信息。热搜词里那些报错基本都是在这一步暴露出来的。4. tmux让多个 AI 助手同时干活而不打架4.1 为什么 openrig 离不开 tmuxtmux 是一个终端复用工具它允许你在一个终端窗口里创建多个会话、窗口和面板。对于 openrig 这种需要同时运行 Claude Code、Codex、本地模型服务、日志监控等多个进程的场景tmux 几乎是必备的。没有 tmux你就得开一堆终端窗口切换起来很麻烦而且一旦 SSH 断开所有进程都会被杀掉。有了 tmux你可以把 Claude Code 跑在一个面板里Codex 跑在另一个面板里本地 LM Studio 服务跑在第三个面板里随时切换查看而且即使断开 SSH这些进程也会继续在后台运行。热搜词里出现了“claude code如何直接执行终端命令”这其实和 tmux 的使用场景很契合。Claude Code 本身可以执行终端命令但如果你让它在一个 tmux 会话里跑它就能在一个隔离的环境中操作不会影响你当前的工作目录和会话。这种隔离性对于调试和实验特别有用。4.2 tmux 基础操作从零到能用的最小知识集如果你从来没接触过 tmux下面这些命令足够你起步# 创建一个名为 openrig 的新会话 tmux new -s openrig # 在会话中创建一个新窗口默认快捷键是 Ctrlb 然后按 c # 切换窗口Ctrlb 然后按数字键或 n/p # 水平分割面板Ctrlb 然后按 # 垂直分割面板Ctrlb 然后按 % # 在面板间切换Ctrlb 然后按方向键 # 脱离会话Ctrlb 然后按 d # 重新连接会话 tmux attach -t openrig # 列出所有会话 tmux ls # 杀掉会话 tmux kill-session -t openrig这些命令看起来不多但组合起来就能搭建一个高效的工作环境。我的习惯是创建一个名为 openrig 的会话然后开三个窗口。第一个窗口跑 Claude Code第二个窗口跑 Codex第三个窗口跑本地模型服务和日志监控。每个窗口里再根据需要用面板分割比如在第一个窗口里左边跑 Claude Code右边跑一个 shell 用来查看文件变化。4.3 把 tmux 配置成 openrig 的“控制台”tmux 的默认配置比较朴素你可以通过编辑~/.tmux.conf来定制。对于 openrig 场景我建议加几个配置# 把前缀键改成 Ctrla比默认的 Ctrlb 更顺手 set -g prefix C-a unbind C-b bind C-a send-prefix # 开启鼠标支持方便用鼠标切换面板和调整大小 set -g mouse on # 设置窗口编号从 1 开始 set -g base-index 1 setw -g pane-base-index 1 # 设置状态栏显示更多信息 set -g status-left [#S] set -g status-right #{?client_prefix,PREFIX,} %H:%M这些配置能让 tmux 用起来更顺手。特别是鼠标支持对于不习惯键盘快捷键的人来说能大幅降低上手难度。5. 接入本地模型LM Studio、DeepSeek、Qwen、GLM 的配置思路5.1 为什么要把 Claude Code 接到本地模型上热搜词里有一条“claude code 调用lmstudio的本地模型”。这说明很多人想把 Claude Code 接到本地运行的模型上而不是用官方 API。原因可能有很多一是成本考虑本地模型不花钱二是隐私考虑代码不想传到云端三是实验需求想对比不同模型的效果。不管什么原因把 Claude Code 接到本地模型上都是可行的关键是要理解 Claude Code 的 API 调用机制。Claude Code 本质上是一个 CLI 客户端它通过 HTTP 请求和模型服务通信。默认情况下它请求的是 Anthropic 的官方端点。但如果你在配置文件里把端点改成http://localhost:1234/v1LM Studio 的默认地址它就会把请求发到本地。前提是你的本地模型服务兼容 OpenAI 的 API 格式因为 Claude Code 和 Codex 通常都支持 OpenAI 兼容的接口。5.2 LM Studio 的配置要点LM Studio 是一个图形化的本地模型运行工具支持加载各种开源模型如 Llama、Qwen、DeepSeek 等并提供一个 OpenAI 兼容的 API 端点。配置步骤如下在 LM Studio 中加载一个模型比如 Qwen2.5-Coder-7B-Instruct。启动本地服务器默认端口是 1234。在 Claude Code 的配置文件中把 API 端点指向http://localhost:1234/v1API Key 随便填一个LM Studio 通常不验证。把模型名称改成你在 LM Studio 中加载的模型名称。这里有个坑LM Studio 的 API 端点路径是/v1/chat/completions但 Claude Code 可能默认请求的是/v1/messagesAnthropic 的格式。如果遇到 404 错误检查一下 Claude Code 是否支持 OpenAI 兼容模式。有些版本需要额外配置api_format: openai之类的选项。5.3 DeepSeek、Qwen、GLM 的接入差异如果你不想跑本地模型也可以接入国内的云端模型服务。DeepSeek、Qwen、GLM 都提供 OpenAI 兼容的 API配置方式和 LM Studio 类似只是端点地址和 API Key 不同。以 DeepSeek 为例{ api_base: https://api.deepseek.com/v1, api_key: your-deepseek-api-key, model: deepseek-chat }Qwen 和 GLM 的配置也大同小异关键是找到正确的 API 端点。热搜词里提到的“cc switch”可能是一个用于切换不同模型后端的工具它的作用就是让你在不同模型之间快速切换而不用手动改配置文件。如果你经常需要在多个模型之间对比这类工具能省不少事。6. 踩坑实录那些让我折腾到半夜的报错6.1 “cc switch local proxy failed while handling codex endpoint /responses”这个报错是我见过最让人头疼的之一。它的意思是cc switch 这个工具在处理 Codex 的/responses端点时本地代理失败了。可能的原因有几个一是代理端口被占用二是 Codex 的配置里端点地址写错了三是 cc switch 本身的版本和 Codex 不兼容。我的排查思路是这样的先确认 cc switch 是否在运行用ps aux | grep cc-switch看看进程在不在。然后检查端口占用用lsof -i :端口号看看是不是被其他程序占了。接着检查 Codex 的配置文件确认端点地址和 cc switch 的监听地址一致。最后如果都不行就升级 cc switch 和 Codex 到最新版本或者回退到已知稳定的版本组合。6.2 “codex is ignoring 1 unrecognized configuration setting”这个报错相对简单就是配置文件里有个拼写错误或者过时的配置项。Codex 会忽略它并给出提示。解决办法是打开配置文件逐项对照官方文档检查。常见的错误包括把model_provider写成model-provider把api_key写成apikey或者用了旧版本才有的配置项。如果你不确定哪个配置项有问题可以先把所有配置注释掉然后逐项取消注释每取消一项就重启 Codex 看是否报错这样就能定位到具体是哪一项。6.3 “your organization has disabled claude subscription access”这个报错通常出现在企业账号上。如果你用的是公司邮箱注册的账号管理员可能在后台禁用了 Claude Code 的访问权限。解决办法是联系管理员开通或者换用个人账号。如果是个人账号出现这个提示检查一下订阅是否过期或者是否违反了使用条款。6.4 Node.js 版本不匹配导致的“玄学”问题有时候 Claude Code 或 Codex 能装上但运行时报一些莫名其妙的错误比如模块找不到、语法不支持等。这往往是因为 Node.js 版本太旧或太新。我的经验是遇到这种“玄学”问题先检查 Node.js 版本切换到 LTS 版本再试。如果还不行就删掉node_modules和package-lock.json重新安装依赖。7. 把 openrig 变成日常习惯我的工作流分享7.1 一键启动脚本折腾完所有配置之后我写了一个简单的启动脚本放在~/bin/openrig.sh#!/bin/bash # 启动 openrig 工作环境 # 检查 tmux 会话是否已存在 tmux has-session -t openrig 2/dev/null if [ $? ! 0 ]; then # 创建新会话第一个窗口跑 Claude Code tmux new-session -d -s openrig -n claude tmux send-keys -t openrig:claude claude C-m # 第二个窗口跑 Codex tmux new-window -t openrig -n codex tmux send-keys -t openrig:codex codex C-m # 第三个窗口跑本地模型服务和日志 tmux new-window -t openrig -n local tmux send-keys -t openrig:local lms server start C-m fi # 连接到会话 tmux attach -t openrig这个脚本的好处是如果会话已经存在就直接连接如果不存在就创建并启动所有服务。你可以在.bashrc或.zshrc里加一个别名alias openrig~/bin/openrig.sh以后只要敲openrig就能进入工作环境。7.2 配置文件版本管理Claude Code 和 Codex 的配置文件~/.claude/config.json、~/.codex/config.toml以及 tmux 配置~/.tmux.conf都值得用 Git 管理起来。我建了一个私有仓库把这些配置文件都放进去换机器的时候直接 clone 下来软链接到对应位置就行。这样即使重装系统也能在几分钟内恢复整个工作环境。7.3 日常使用中的小技巧第一个技巧在 tmux 里用Ctrlb [进入复制模式可以用方向键滚动查看历史输出。对于 Claude Code 和 Codex 这种输出很长的工具这个功能特别有用。第二个技巧给 Claude Code 和 Codex 分别设置不同的终端颜色主题这样一眼就能看出当前在哪个窗口。第三个技巧定期清理~/.claude/和~/.codex/下的日志文件否则时间长了会占很多磁盘空间。8. 关于 openrig 的一些个人体会折腾 openrig 这套东西最大的感受是AI 编程工具本身很强但环境配置的复杂度被严重低估了。很多人卡在安装这一步就放弃了根本没机会体验到工具的真正价值。openrig 这类方案的意义就是把配置的复杂度封装起来让开发者能专注于写代码本身。我自己的做法是把 openrig 当成一个“可复现的开发环境”来维护。每次遇到新的报错就把它记录下来更新到配置模板里。时间长了这套配置就越来越健壮换机器、带新人、做演示都能直接用。如果你也在用 Claude Code 和 Codex建议你也建一个自己的 openrig 仓库把踩过的坑和解决方案都沉淀下来。这比每次遇到问题现搜要高效得多。最后分享一个我最近发现的细节tmux 的remain-on-exit选项可以让面板在进程退出后保留输出方便查看崩溃日志。在~/.tmux.conf里加上set -g remain-on-exit on然后配合respawn-pane命令就能实现“进程崩溃后自动重启并保留现场”的效果。对于需要长时间运行的 AI 助手来说这个配置能省不少心。