企业官网建设流程全解析

1. 从“openrig”说起：一个把 Claude Code 和 Codex 装进同一台机器的实战思路

第一次看到openrig这个词，我脑子里蹦出来的不是某个具体软件，而是一种“把工具架起来”的感觉——rig 在英文里本来就有“装配、搭台子”的意思，open 则点明了它的气质：开放、可拼装、不绑定某一家。放到当下这个时间点，它最合理的落点，就是围绕Claude Code和Codex这两类终端里的 AI 编程助手，搭一套自己能掌控的本地工作台。热词里反复出现的Claude Code、Codex、Node.js、tmux，其实已经把这条链路的关键节点全暴露了：Node.js 是运行时底座，Claude Code 和 Codex 是跑在上面的两个“大脑”，tmux 则是让它们能长时间稳定驻留、随时切回来继续干活的“容器”。

我自己的使用场景很典型：一台 Ubuntu 开发机，偶尔切到 Windows 桌面版做演示，VS Code 里写代码，终端里同时挂着 Claude Code 和 Codex，一个负责大范围重构和读代码，一个负责快速补全和跑命令。这套东西听起来简单，真装起来坑不少——Node.js 版本对不上、Codex 登录卡住、Claude Code 提示地区不可用、tmux 会话被误杀、第三方 API 接入后模型名写错……热词里那些error installing 24.21.0、cc switch local proxy failed、codex is ignoring 1 unrecognized configuration setting，全是真实踩过的雷。

这篇内容适合谁看？如果你是刚听说 Claude Code 和 Codex、想在自己机器上跑起来的新手，它能帮你把 Node.js、安装、配置、登录、接入本地模型这条线一次理顺；如果你已经装过但总在某个环节翻车，比如 Codex 无法加载组织设置、Claude Code 在 VS Code 里不生效、tmux 里跑着跑着会话没了，那这篇里的排查表和避坑经验应该能直接抄。我不打算把它写成官方文档的复读机，而是按一个真实从业者的顺序，把“为什么这么装、装完怎么用、坏了怎么修”讲透。

2. 整体设计与思路拆解：为什么是 Node.js + tmux + 双助手

2.1 为什么底座选 Node.js，而不是别的运行时

Claude Code 和 Codex 的 CLI 形态，目前主流分发方式都是 npm 包。这意味着你机器上必须有一个能跑 npm 的 Node.js 环境。热词里node.js是干什么的、node.js安装、node.js官网下载、node.js lts下载出现频率极高，说明大量新手卡在第一步：不知道 Node.js 是干嘛的，也不知道该下哪个版本。

Node.js 本质上是把 JavaScript 运行时从浏览器里搬出来，让 JS 能在操作系统上直接跑，npm 则是它的包管理器。Claude Code 和 Codex 的安装脚本、更新机制、插件体系都依赖 npm，所以 Node.js 不是可选项，是硬前提。我建议直接用LTS 版本，不要追最新。热词里那个error installing 24.21.0: node.js v24.21.0 is not yet released or is not ava就是典型教训——有人照着某个教程写了版本号，结果那个版本根本还没正式发布，npm 直接报“未发布或不可用”。LTS 版本经过长时间验证，和 npm 生态兼容性最好，Claude Code、Codex 这类工具在 LTS 上跑最稳。

提示：Node.js 版本管理我强烈建议用 nvm 或 fnm，而不是系统包管理器直接装。系统自带的 Node.js 往往版本老旧，且和 npm 全局包权限纠缠不清，后面升级会非常痛苦。

2.2 为什么需要 tmux：让 AI 助手“驻留”而不是“一次性”

很多人第一次用 Claude Code 或 Codex，是在普通终端里敲一条命令，问一句答一句，关掉终端就没了。这种用法适合尝鲜，不适合真实开发。真实场景是：你让 Claude Code 读一个大模块、让它慢慢分析，同时你自己去改另一个文件；或者 Codex 正在跑一个长任务，你想切出去查个文档再切回来。这时候tmux就是刚需。

tmux 是终端复用器，你可以把它理解成“终端里的窗口管理器”。它让一个终端会话在后台持续存在，你断开 SSH、关掉窗口、切到别的任务，会话里的进程照样跑。热词里tmux和Claude Code、Codex并列出现，说明大家已经意识到：AI 编程助手不是“问一句就完”，而是需要长时间驻留的协作对象。我通常开三个 tmux 窗口：一个跑 Claude Code 做代码理解，一个跑 Codex 做快速执行，一个留给自己敲命令和看日志。切换用快捷键，几秒钟的事，比反复启动省太多时间。

2.3 双助手并存的取舍：Claude Code 与 Codex 各管什么

Claude Code 和 Codex 虽然都是终端里的 AI 编程助手，但脾气不一样。Claude Code 更擅长“读懂一大片代码再动手”，你给它一个目录，它能自己翻文件、理依赖、给出改动方案，适合重构、补测试、解释陌生代码库。Codex 更偏“快问快答 + 直接执行”，你描述一个具体任务，它倾向于直接给命令、给补丁，适合修小 bug、写脚本、跑构建。

把两个都装上，不是为了炫技，而是让它们分工。我的习惯是：新项目上手先用 Claude Code 通读一遍，让它告诉我模块划分和关键路径；具体改某个函数、写个一次性脚本，切到 Codex 快速搞定。两者共用同一套 Node.js 底座，但配置目录、登录态、模型接入方式各自独立，互不干扰。这也是openrig这个思路的核心——不是二选一，而是搭一个能同时容纳两者的开放工作台。

2.4 第三方 API 与本地模型的接入考量

热词里claude code 调用lmstudio的本地模型、codex接入deepseek、使用cc switch 接入 deepseek v4, qwen, glm等模型、第三方api使用技巧这些，反映了一个真实需求：不是所有人都能用官方订阅，或者有人就是想让请求走本地模型、走第三方兼容接口。Claude Code 和 Codex 都支持通过环境变量或配置文件指定 API 端点，把请求转发到兼容 OpenAI 或 Anthropic 协议的服务上。

这里的关键是协议兼容性。Codex 走的是 OpenAI 风格的/responses或/chat/completions端点，Claude Code 走的是 Anthropic 风格的消息接口。热词里cc switch local proxy failed while handling codex endpoint /responses就是典型的代理层协议没对齐——代理以为自己在处理 Codex 的/responses，结果请求格式或鉴权头对不上，直接失败。我的经验是：接第三方或本地模型时，先确认对方暴露的是哪种协议，再用对应的环境变量去指，不要混着来。本地 LM Studio 通常暴露 OpenAI 兼容端点，那就按 Codex 的方式接；想给 Claude Code 用，就得确认它是否支持自定义 base URL 和对应协议。

3. 核心细节解析与实操要点：Node.js、安装、配置逐项拆

3.1 Node.js 安装：版本选择与常见报错

Node.js 安装本身不复杂，但热词里安装node.js、node.js下载、node.js lts下载、node.js官网下载反复出现，说明很多人连下载入口都没找对。我的建议是直接去 Node.js 官网下 LTS 的安装包，或者用版本管理器。Ubuntu 上我倾向 fnm，Windows 上可以用 nvm-windows 或者直接装 LTS 的 msi。

安装完先验证：

node -v npm -v

两条都能正常输出版本号，才算底座就绪。如果node -v报 command not found，说明 PATH 没配好；如果 npm 全局安装时报权限错误，说明你用了系统级 Node.js 且没有配全局目录，这时候要么换版本管理器，要么配置 npm 的全局前缀到用户目录。

注意：热词里那个error installing 24.21.0的教训是——不要手动指定一个你没确认存在的版本号。安装 Claude Code 或 Codex 时，如果文档里写了npm install -g @xxx@24.21.0，先去 npm 仓库确认这个版本真的发布了。更稳妥的做法是不带版本号，让它装 latest 或 LTS 兼容版本。

3.2 Claude Code 安装与首次配置

Claude Code 的安装通常是通过 npm 全局包。装之前确认 Node.js 版本满足要求，然后执行全局安装。装完第一次运行会引导你登录或配置 API。热词里claude code安装、claude code下载安装、claude code 安装、安装claude code全是同一件事，但真正卡人的是登录和地区限制。

热词里note: claude code might not be available in your country. check supported co和your organization has disabled claude subscription access for claude code这两条，说明两类问题：一是地区可用性提示，二是组织策略禁用了订阅访问。前者通常和账号所在区域有关，后者是企业管理员在后台关了权限。遇到这两类提示，先确认自己的账号状态和订阅类型，再决定是换接入方式还是找管理员开通。

如果你打算接第三方或本地模型，Claude Code 支持通过环境变量指定 base URL 和 API key。典型做法是在 shell 配置里导出：

export ANTHROPIC_BASE_URL="你的兼容端点" export ANTHROPIC_API_KEY="你的密钥"

然后重新开终端再启动 Claude Code。这里的关键是端点必须兼容 Anthropic 的消息协议，否则会出现请求格式错误。

3.3 Codex 安装、登录与配置排错

Codex 的安装同样是 npm 全局包，热词里codex安装、codex安装教程、codex安装包、codex下载、codex官网下载、codex安装 windows桌面版覆盖了各平台。Windows 桌面版和 CLI 版是两条路径，桌面版适合不习惯终端的用户，CLI 版适合和 tmux、脚本配合。我两个都试过，最终留在 CLI，因为和 tmux 配合最顺。

Codex 登录常见问题是codex登录卡住或codex无法加载组织设置。前者多半是网络或鉴权回调问题，后者通常是账号所属组织没有正确配置。热词里codex is ignoring 1 unrecognized configuration setting. check for typos or d是配置文件的典型报错——你在 config 里写了一个它不认识的键，它会忽略并警告。这时候逐字检查键名拼写，别自己发明配置项。

Codex 接入第三方模型时，热词里codex接入deepseek是高频需求。做法是在配置里指定 model provider 和 base URL，把请求指向兼容 OpenAI 协议的端点。注意 Codex 对端点路径敏感，/responses和/chat/completions不是一回事，代理层如果只实现了其中一个，另一个就会报local proxy failed。

3.4 VS Code 集成：让助手在编辑器里也能用

热词里vscode配置claude code、vscode接入claude code、claude code for vs code、vs code使用方法说明很多人希望不离开编辑器就能用。Claude Code 和 Codex 都有 VS Code 扩展或集成方式。装扩展后，通常需要在设置里指定 CLI 路径或 API 配置。如果扩展装了但没反应，先确认 CLI 本身在终端里能跑通，再检查扩展的设置项是否指向了正确的可执行文件。

我的经验是：VS Code 集成适合轻量交互，重活还是回终端 + tmux。因为编辑器里的面板空间有限，长输出滚动不方便，而且 tmux 会话的持久性在编辑器里体现不出来。

3.5 tmux 会话管理：让助手长期驻留

tmux 的基本操作就几个：新建会话、分离、重连、切窗口。我通常这样起：

tmux new -s ai

然后在里面开多个窗口，一个跑 Claude Code，一个跑 Codex，一个留 shell。分离用Ctrl+b d，重连用tmux attach -t ai。这样即使 SSH 断了，会话里的助手还在跑。

提示：tmux 里跑 AI 助手时，注意终端类型和颜色支持。有些助手在screen或dumb终端下输出会乱，确保TERM设成xterm-256color之类。

4. 实操过程与核心环节实现：从零到双助手并跑

4.1 环境准备清单与版本确认

动手前先把清单列清楚：一台 Ubuntu 或 Windows 机器、Node.js LTS、npm、tmux（Linux/macOS）、Claude Code CLI、Codex CLI、可选的 VS Code。版本确认命令：

node -v npm -v tmux -V

三个都有输出且版本合理，再往下走。如果 Node.js 版本太老，先升级；如果 tmux 没装，Ubuntu 上sudo apt install tmux，macOS 上brew install tmux。

4.2 安装 Claude Code 并完成首次登录

全局安装后直接运行启动命令，按提示走登录流程。如果走官方订阅，登录后确认订阅状态；如果走 API key，提前把环境变量配好。首次启动后建议先问一个简单问题验证链路，比如让它解释当前目录下的某个文件。能正常返回，说明安装和鉴权都通了。

4.3 安装 Codex 并处理配置警告

Codex 安装后首次运行同样有引导。配置文件通常在用户目录下的隐藏目录里。如果启动时看到unrecognized configuration setting，打开配置文件逐行核对，把不认识的键删掉或改成正确拼写。接入第三方模型时，按官方支持的 provider 格式写，不要自创字段。

4.4 用 tmux 把两个助手挂起来

起一个 tmux 会话，开三个窗口。窗口 1 跑 Claude Code，窗口 2 跑 Codex，窗口 3 留给自己。这样你可以在窗口 3 敲命令、看 git 状态，随时切到窗口 1 或 2 继续和助手交互。分离会话后，即使关掉终端，助手进程还在。重连回来，上下文还在。

4.5 接入本地模型或第三方 API 的实操

以本地 LM Studio 为例，先在 LM Studio 里启动服务，确认它暴露的端点和端口。然后在 Codex 配置里把 base URL 指向它，模型名填 LM Studio 里加载的模型标识。启动 Codex 后发一条测试请求，看是否返回。如果报local proxy failed，检查端点路径是否匹配 Codex 期望的/responses或/chat/completions。Claude Code 接本地模型时，确认对方是否兼容 Anthropic 协议，不兼容就得加一层转换。

5. 常见问题与排查技巧实录

5.1 安装与版本类问题速查

5.2 登录与账号类问题

codex无法加载组织设置和your organization has disabled claude subscription access都属于账号策略问题。前者检查组织配置，后者确认订阅是否被管理员限制。这类问题不是本地环境能修的，得从账号侧解决。

5.3 代理与端点类问题

cc switch local proxy failed while handling codex endpoint /responses是代理层协议不匹配的典型。排查顺序：先确认代理是否实现了 Codex 需要的端点路径，再确认鉴权头格式，最后看请求体结构。三者任一不对都会失败。

5.4 我踩过的几个坑

第一个坑是 Node.js 版本追新，结果某个全局包不兼容，回退 LTS 才好。第二个坑是 tmux 里跑助手时终端类型没设对，输出乱码，改TERM解决。第三个坑是接第三方 API 时模型名写错，请求发出去了但返回模型不存在，排查半天才发现是名字对不上。这些都不是大问题，但每一个都能耗掉半小时。

6. 把 openrig 当成长期工作台来维护

装好只是开始，长期用下去还得维护。我的习惯是定期更新 Node.js LTS、更新两个 CLI 到最新稳定版、清理 tmux 里不再用的会话。配置文件我会单独备份一份，换机器时直接拷过去，省得重新配。第三方 API 的密钥不写死在配置里，走环境变量，避免泄露。

这套 openrig 思路的核心不是某个具体工具，而是“把 AI 编程助手当成常驻协作对象”来对待。Node.js 是地基，tmux 是房间，Claude Code 和 Codex 是住在里面的两个帮手。地基稳、房间不塌、帮手各司其职，日常开发效率的提升是实打实的。我自己的体会是，一旦习惯了 tmux 里随时切过去问一句、让它跑个任务再切回来，就再也回不去那种“开一次终端问一句关掉”的用法了。