openrig：Claude Code与Codex的AI编码工作台搭建指南-北京尧图网络

1. 从openrig这个名字说起它到底想解决什么问题第一次看到openrig这个词我脑子里蹦出来的不是某个具体软件而是一种开放式工作台的意象。rig 在英文里除了装备、装置在工程语境下常指搭建、装配一套可运行的系统。把它和 open 组合在一起再结合热搜词里高频出现的 Claude Code、Codex、Node.js、tmux 这几个关键词我基本能判断出这个方向的核心诉求把散落在终端里的 AI 编码工具整合成一套可复用、可切换、可远程托管的开放工作环境。为什么会有这种需求因为现在用 AI 写代码的人早就不是打开一个网页对话框那么简单了。一个稍微认真点的开发者本地可能同时装着 Claude Code、Codex CLI可能还接了本地模型比如通过 LM Studio 跑推理可能要在 VS Code 里用插件也可能要在纯终端里跑长任务。这些工具各自有各自的安装方式、配置目录、认证流程、模型端点互相之间还会打架——比如代理配置冲突、模型名不被支持、组织权限被禁用等等。热搜词里那一堆报错本质上都是工具太多、环境太乱的副作用。所以 openrig 这类项目的价值不在于发明了什么新算法而在于把环境治理这件事工程化。它要回答的是几个非常实际的问题Node.js 装哪个版本才不踩坑Claude Code 和 Codex 能不能共用一个代理层tmux 在里面扮演什么角色本地模型怎么接进来这些问题单看都很琐碎但合在一起就是一套完整的AI 编码工作台搭建方法论。这篇文章我会按环境底座 → 工具接入 → 会话托管 → 故障排查这条主线来拆尽量把每个环节的为什么讲透。适合两类人看一类是刚接触 Claude Code / Codex、被安装和配置卡住的新手另一类是已经能跑起来、但想让整套环境更稳定、更可复用的老手。下面进入正题。2. Node.js 底座版本选择决定了后面一半的坑2.1 为什么 Node.js 版本是第一个必须锁死的东西Claude Code 和 Codex CLI 这类工具绝大多数是 Node.js 生态的产物通过 npm 全局安装。这意味着你的 Node.js 版本直接决定了npm 的解析行为、原生模块能否编译、以及某些新语法特性是否可用。热搜词里有一条特别典型——error installing 24.21.0: node.js v24.21.0 is not yet released or is not available。这个报错的意思是你试图安装一个根本还不存在的版本号或者某个工具声明的引擎版本和你本地不匹配。我的经验是不要追最新的大版本锁 LTS。Node.js 的偶数版本是 LTS长期支持奇数版本是实验性的。当前稳定可用的 LTS 线在 20.x 和 22.x 之间20.x 兼容性最广22.x 性能更好但对某些老包可能有兼容问题。如果你只是要跑 Claude Code / Codex选 20 LTS 基本不会错。在 Ubuntu 上装 Node.js 20我不推荐直接用apt install nodejs因为系统源里的版本往往偏旧。更稳的做法是用 NodeSource 的源或者用 nvm 做版本管理。nvm 的好处是你可以随时切换版本出问题了回滚成本极低。# 用 nvm 安装并锁定 Node.js 20 LTS curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.bashrc nvm install 20 nvm use 20 nvm alias default 20 node -v # 应输出 v20.x.x npm -v装完之后一定要验证node -v和npm -v都能正常输出。很多人装完 nvm 忘了source导致新开终端又回到系统自带的老版本然后全局装的 CLI 找不到报一堆莫名其妙的错。2.2 npm 全局目录与权限别用 sudo 硬刚新手最容易踩的第二个坑是权限。直接sudo npm install -g会把包装到 root 的目录下后续普通用户运行时找不到或者升级时权限混乱。正确做法是把 npm 的全局目录指到用户目录下mkdir -p ~/.npm-global npm config set prefix ~/.npm-global echo export PATH~/.npm-global/bin:$PATH ~/.bashrc source ~/.bashrc这样以后所有npm install -g都装在你自己的目录里不需要 sudo升级、卸载都干净。这一步看起来小但它决定了你后面装 Claude Code、Codex 时会不会反复被权限问题打断。提示如果你之前已经用 sudo 装过东西建议先sudo npm uninstall -g卸掉再用新 prefix 重装避免新旧两份共存导致命令指向混乱。2.3 网络与镜像安装慢和安装失败是两回事热搜词里node.js下载、node.js官网下载、node.js lts下载出现频率很高说明很多人卡在下载环节。这里要区分两种情况一种是纯粹慢一种是直接失败。慢的话可以换国内镜像源加速 npm 包下载npm config set registry https://registry.npmmirror.com但要注意镜像源只加速 npm 包不加速 Node.js 二进制本身的下载。如果你用 nvm 装 Node 很慢可以设置NVM_NODEJS_ORG_MIRROR环境变量指向镜像。至于安装失败多半是版本号写错、系统架构不匹配比如在 ARM 机器上装了 x64 包或者磁盘空间不足。排查时先看报错最后几行通常会有明确的ENOTFOUND、EACCES、404之类的关键词对症下药比盲目重装快得多。3. Claude Code 与 Codex 的接入姿势装得上只是开始3.1 两个工具的定位差异决定了配置思路不同Claude Code 和 Codex 虽然都是终端里的 AI 编码助手但设计哲学不太一样。Claude Code 更强调直接在项目目录里对话、执行终端命令、读写文件它的强项是 agent 式的连续操作Codex CLI 则更偏向命令行调用结构化输出适合脚本化和批处理。理解这个差异很重要因为它影响你怎么配置它们。Claude Code 的安装通常是全局 npm 包装完后在项目目录里直接运行即可。它需要认证认证方式可能是订阅账号登录也可能是 API Key。热搜词里your organization has disabled claude subscription access for claude code这个报错说的就是组织层面把订阅访问关了这种情况你只能改用 API Key 方式或者找管理员开权限本地怎么折腾都没用。Codex 的安装类似但它的配置更依赖一个配置文件通常是~/.codex/config之类里面要写模型名、端点、认证信息。热搜词里codex is ignoring 1 unrecognized configuration setting. check for typos就是配置文件里写了它不认识的字段工具会忽略并警告。这种警告一般不影响运行但如果你发现某个配置写了没生效第一件事就是检查字段名拼写和缩进。3.2 模型端点与模型不被支持的报错怎么破热搜词里有一条很典型{detail:the gpt-5.6-sol model is not supported when using codex with a...}。这类报错的本质是你在配置里指定的模型名和你实际调用的端点不匹配。可能是模型名拼错了可能是这个端点根本不提供这个模型也可能是你用的第三方中转层做了模型名映射但映射表里没有这一项。处理这类问题的思路是分三步第一确认你调用的端点到底支持哪些模型名不要凭记忆写第二确认配置里的模型名和端点文档完全一致大小写、连字符都不能差第三如果用了中转层去中转层的配置里看模型映射规则。很多人一看到模型不支持就以为是账号问题其实八成是名字写错了。3.3 接入本地模型LM Studio 这类方案的注意点热搜词里claude code 调用lmstudio的本地模型说明不少人想让 Claude Code 走本地推理。这个思路是可行的核心是把本地模型服务暴露成一个兼容的 API 端点然后在 Claude Code 或 Codex 的配置里把 base URL 指过去。但这里有几个现实问题要提前想清楚。第一本地模型的上下文窗口通常比云端小Claude Code 这种 agent 式工具会塞进去大量文件内容很容易超限表现为说着说着就忘了前面。第二本地模型的工具调用function calling能力参差不齐如果模型不支持结构化工具调用Claude Code 的执行终端命令功能可能直接失效。第三本地推理速度取决于你的硬件长任务会非常慢。我的建议是本地模型适合做轻量问答、代码解释、单文件改写不适合跑复杂的多步 agent 任务。配置时把 base URL 指向 LM Studio 的本地端口默认通常是http://localhost:1234/v1这类模型名填 LM Studio 里加载的那个模型标识符然后先用一个简单请求验证连通性再上复杂任务。# 先验证本地端点是否可用 curl http://localhost:1234/v1/models # 返回模型列表说明服务正常再把它填进 Claude Code / Codex 配置4. tmux 在整套环境里的真实角色会话托管而非装饰4.1 为什么 AI 编码工作流离不开 tmux很多人第一次听说 tmux 被放进 AI 编码工具链里会疑惑一个终端复用器跟 AI 有什么关系关系大了。Claude Code 和 Codex 经常要跑长任务——比如让它读一整个项目、批量改文件、跑测试。这些任务可能几分钟到几十分钟。如果你直接在 SSH 会话里跑网络一断任务就没了。tmux 解决的正是这个问题它把会话和你的连接解耦断线重连后任务还在跑。更实际的用法是分屏。我通常一个 tmux 窗口分三块左边跑 Claude Code 做交互右上跑一个npm run dev或日志监控右下留给 git 操作和临时命令。这样 AI 在改代码的同时我能实时看到构建结果和报错不用来回切窗口。这种AI 干活、人盯反馈的协作模式效率比单开一个终端高很多。# 常用 tmux 操作 tmux new -s aiwork # 新建名为 aiwork 的会话 tmux attach -t aiwork # 重新连接 # 会话内Ctrlb % 左右分屏Ctrlb 上下分屏 # Ctrlb 方向键切换面板Ctrlb d 脱离会话4.2 会话命名与日志留存别让成果随会话消失tmux 有个容易被忽略的点会话默认在服务器重启后就没了。如果你跑的是重要任务建议配合日志重定向把 AI 的输出和命令结果落盘# 在 tmux 里跑任务时同时写日志 claude-code 21 | tee ~/logs/claude-$(date %F-%H%M).log这样即使会话丢了你还能从日志里找回 AI 给出的方案和它执行过的命令。我踩过的坑是有一次让 AI 批量重构跑了二十分钟结果手滑关了终端tmux 会话也没了只能重来。从那以后我养成了长任务必开 tmux 必写日志的习惯。4.3 tmux 与工具认证的配合还有一个细节Claude Code 和 Codex 的认证状态通常存在用户目录的配置里和 tmux 无关所以你在 tmux 里登录一次之后新开面板不用重复登录。但如果你在 tmux 里切换了用户比如su到别的账号配置目录就变了会要求重新认证。这一点在多人共用的机器上要特别注意别在错误的用户下折腾半天认证。5. 代理层与多工具共存cc switch 这类方案的取舍5.1 为什么需要一层切换器热搜词里cc switch local proxy failed while handling codex endpoint /responses和使用cc switch 接入 deepseek v4, qwen, glm等模型指向同一个需求在多个模型供应商、多个工具之间灵活切换。你可能有 Claude 的订阅、有 DeepSeek 的 API、有本地模型还想让 Claude Code 和 Codex 都能用。如果每个工具都单独配一遍改一次模型要动好几个文件非常痛苦。cc switch 这类工具的思路是在本地起一个代理层所有工具都指向这个本地代理代理再根据你的配置把请求转发到真正的后端。这样切换模型只需要改代理的配置工具侧不用动。这个设计很聪明但也引入了新的故障点——热搜里那个local proxy failed while handling codex endpoint /responses就是代理在处理 Codex 的/responses端点时挂了。5.2 代理层故障的排查顺序遇到代理报错我一般按这个顺序查排查步骤检查内容常见问题1. 代理是否在跑curl localhost:端口/health进程没起来、端口被占2. 端点路径是否匹配对比工具请求路径与代理路由/responses没配、路径前缀错3. 后端是否可达直接 curl 后端 APIKey 失效、额度耗尽、网络不通4. 模型名映射检查代理的模型映射表映射缺失、名字拼写不一致5. 请求体格式看代理日志里的原始请求工具发的格式代理不认这个顺序的逻辑是从近到远先确认本地代理活着再确认它认识这个请求再确认它能连上后端最后才怀疑格式问题。很多人一上来就怀疑后端结果发现是本地代理根本没启动。5.3 多工具共存的配置隔离原则如果你同时用 Claude Code 和 Codex我强烈建议配置隔离每个工具用独立的配置文件、独立的认证、独立的日志。不要图省事让它们共享一个配置因为两者的字段名、端点路径、模型命名习惯都不一样共享必然冲突。代理层可以做统一转发但工具侧的配置要各管各的。另外代理层不要配得太聪明。有些切换器会自动改写请求、自动重试、自动降级模型这些功能在稳定时很爽出问题时极难排查。我的偏好是代理只做最朴素的转发和模型名映射其他逻辑一律不要这样任何异常都能一眼定位。6. 那些高频报错的根因与处置清单6.1 认证与权限类报错your organization has disabled claude subscription access for claude code和codex无法加载组织设置属于同一类账号层面的策略限制。这类问题的特点是——你本地环境再干净也没用因为限制在服务端。处置方式只有两条路改用 API Key 认证绕过订阅策略或者联系组织管理员调整策略。别在本地反复重装那是浪费时间。codex登录不上则可能是本地问题网络不通、认证回调端口被占、浏览器没弹出。可以先看 CLI 输出的登录 URL手动复制到浏览器完成再回到终端确认。如果一直卡在等待回调检查本地是否有防火墙拦了回调端口。6.2 配置与模型类报错codex is ignoring 1 unrecognized configuration setting是警告不是错误但值得处理因为它意味着你的某个配置没生效。逐字核对字段名特别注意 YAML/TOML 的缩进和大小写。the gpt-5.6-sol model is not supported则是模型名或端点不匹配按第 3.2 节的思路排查。6.3 安装与版本类报错error installing 24.21.0: node.js v24.21.0 is not yet released是版本号问题换成实际存在的 LTS 版本即可。codex安装包、codex下载、codex官网下载这类搜索背后往往是下载源不对或安装方式选错。建议统一走官方文档给出的安装命令不要从第三方站点下安装包版本和完整性都没保障。注意所有工具的安装命令、配置字段、端点路径都以你所用版本的官方文档为准。网上教程有时效性尤其是模型名和端点变化很快。7. 一套可复用的工作台搭建顺序把前面所有内容串起来我实际搭一套环境时的顺序是这样的供你参考先装 Node.js 20 LTS用 nvm 管理配好 npm 全局目录和镜像源。这一步是所有后续操作的地基。装 Claude Code 和 Codex各自独立配置先跑通最简单的你好级别对话确认认证和端点没问题。按需接入本地模型或第三方模型通过代理层统一管理代理只做转发和映射。用 tmux 托管长任务分屏监控日志落盘。建立排查习惯任何报错先看最后几行按本地进程 → 端点路径 → 后端可达 → 模型映射 → 请求格式的顺序查。这套顺序的核心逻辑是从底到上、从简到繁。很多人一上来就搞代理、接本地模型、配多供应商结果底层 Node.js 版本就是错的后面全是连锁反应。先把地基打牢再往上叠出问题时才能快速定位是哪一层的问题。最后分享一个我自己的小习惯每配好一个工具就把它能跑通的最小命令记到一个setup-notes.md里包括版本号、配置路径、验证命令。下次换机器或者环境崩了照着笔记十分钟就能重建比重新翻教程快得多。这套笔记本身其实就是你自己的openrig。

openrig：Claude Code与Codex的AI编码工作台搭建指南

相关推荐

PicPick：设计师与程序员必备的高效截图工具

半导体掺杂技术与PN结特性解析

别让旗舰大模型当调度员：APUS 开源 Reflex Agent，4.5B 小模型管事、大模型干活

更多资讯

STM32L431待机模式双路唤醒实战：WKUP引脚与RTC闹钟配置指南

Canoe诊断无响应，提示诊断超时，但是CAN报文正常接收发送

除自身以外数组的乘积：前缀积与后缀积的两趟扫描解法

老版本摄像头驱动在Win10下的安装与DirectShow采集避坑指南

自建电气元件选型工具：从参数库到评分筛选的完整指南

Kubernetes 1.18.8 部署实战：兼容老系统与边缘场景的稳态集群搭建

今日更新

防关联浏览器哪个好？三款产品实测差异解析

2026钢铁行业AI转型系统选型对比：多基地排产、大宗原燃料采购与质量追溯，六家厂商能力差异在哪里

影刀RPA深度实战：大模型Fine-tuning定制RPA专用Prompt与指令生成

本周精选

交通拥堵预测毕设：基于Python+LSTM的车辆流量预测系统全流程解析

MATLAB/Simulink搭建10机39节点电力系统暂态稳定仿真实战

无人机航拍三维重建全流程：从SfM到网格生成的避坑指南

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？