免费使用 Codex CLI及安装避坑指南:免费 API、本地模型分别需要什么?

现在最火的codex ，安装Codex CLI或Codex APP运行，必须安装Node.js、Ollama、这三个工具吗？啥情况下用安装，啥情况下用不上安装?用免费的API密钥必须装哪几个工具？

这个问题很多人都搞混了，我给你画一个最简单的关系。

Node.js 是运行 Codex CLI 的环境。
Ollama 是本地运行 AI 模型的软件。
CCSwitch 只是 Codex 的一个中转站
也就是说：
Node.js = 软件（需要安装）
Ollama = 软件（需要安装）
CCSwitch = 软件（用安装）

一、如果使用 OpenAI API（官方 API）
例如：
* GPT-5
* GPT-5.5
* GPT-4.1
需要：
✅ Node.js
不用：
❌ Ollama
❌ CCSwitch
运行：
```bash
codex
然后配置
OPENAI_API_KEY
即可。([OpenAI Help Center][2])

二、如果使用免费的本地 AI（Ollama）
例如
* gpt-oss
* Qwen Coder
* DeepSeek
* Gemma
需要：
✅ Node.js
✅ Ollama
运行：
bash
codex --oss
这里
--oss
就是 CCSwitch
只是告诉 Codex：
> 不要连接 OpenAI，
> 去连接本地 Ollama。

三、如果用免费的 API（不是 OpenAI）
例如
* Gemini API
* DeepSeek API
* SiliconFlow API
* OpenRouter API
这种情况一般需要：
✅ Node.js
不用：
❌ Ollama
❌CCSwitch
因为这些都是云端 API。

四、什么时候必须装 Ollama？
只有这一种情况：
> **想在自己电脑本地运行 AI，不用任何云端 API。**
例如：
codex --oss
那么必须：
安装 Ollama
下载模型
启动 ollama serve
否则就会出现你之前那个错误：
No running Ollama server detected.
就是因为没有运行 Ollama 服务。([Ollama][1])

五、如果你准备使用免费的 API 密钥，需要装什么？
如果你的免费 API 来自：
* Gemini API
* DeepSeek API
* OpenRouter
* SiliconFlow
通常只需要：
| 工具 | 是否安装 |
| --------- | ----- |
| Node.js | ✅ 必须 |
| Codex CLI | ✅ 必须 |
| Ollama | ❌ 不需要 |
| CCSwitch 需要 |

六、如果使用本地免费模型（完全不要 API）
需要：
| 工具 | 是否安装 |
| --------- | --------------------- |
| Node.js | ✅ 必须 |
| Codex CLI | ✅ 必须 |
| Ollama | ✅ 必须 |
| CCSwitch | ✅ 启动时使用 `--oss` |

你电脑是 **Windows 11**，主要是做网站（HTML、CSS、JavaScript）、SEO 和 GitHub Pages，并且希望**尽量免费**。

推荐方案：
✅ 安装 Node.js（必须）
✅ 安装 Codex CLI
❌ 暂时不要安装 Ollama（除非以后想离线运行本地模型）
✅ 使用免费的 API（如 Gemini 或其他兼容 API）来驱动 Codex
这样配置最简单，占用磁盘最少，也不需要下载十几 GB 甚至几十 GB 的本地模型。

如果以后你想完全免费、离线、不依赖任何 API，再安装 Ollama，并使用 `codex --oss` 即可。

先记住一句话
> Node.js 是运行 Codex CLI 的环境。
> Ollama 是本地运行 AI 模型的软件。
> 只是 Codex 的一个中转站软件。([Ollama][1])
也就是说：
* Node.js = 软件（需要安装）
* Ollama = 软件（需要安装）
* CCSwitch = 软件（用安装）

📌 如果你也在考虑自己安装免费的codex CLI，或者想了解codex免费那些事儿，欢迎来我网站坐坐 👉 https://anrjai.com