Codex 接入 Kimi K2 与 GLM-4.6 环境配置指南 (Windows/macOS/Ubuntu)

Codex 接入 Kimi K2 与 GLM-4.6 环境配置指南

前言

智谱发布了 GLM-4.6，被称为其最强的代码 Coding 模型。主要特性包括：

代码能力对齐 Claude Sonnet 4，部分榜单对齐 Claude Sonnet 4.5。
上下文长度增加到 200K。
推理能力提升，增加图像识别与搜索能力。
token 消耗较 GLM-4.5 节省 30% 以上。

本指南将引导您完成安装 Codex，并通过 API 方式配置 Kimi K2、GLM-4.6 模型，以进行 AI 编程辅助。

1、安装 Node.js

在开始之前，您的系统需要安装好 Node.js。

验证安装：安装完成后，打开终端（Terminal）或命令提示符（CMD），运行以下命令来验证。

node -v

如果成功安装，将会显示 Node.js 的版本号。

下载与安装：请前往 Node.js 官方网站下载并安装最新版本的 Node.js（建议使用 v18 或更高版本）。根据您的操作系统下载对应的安装包。

2、安装 Codex

接下来，我们将全局安装 Codex NPM 包。此步骤在不同操作系统下的主要区别在于是否需要管理员权限。

2.1、Windows

以 管理员身份 打开 命令提示符（CMD） 或 PowerShell。
输入并运行以下安装命令：

npm install -g @openai/codex

2.2、macOS / Ubuntu

打开 终端（Terminal）。
由于全局安装 npm 包需要系统权限，需要在命令前加上 sudo。
输入并运行以下安装命令（过程中会提示输入电脑登录密码）：

sudo npm install -g @openai/codex

2.3、验证安装 (所有系统通用)

安装完成后，在 新的终端窗口 中运行以下命令来验证。

codex --version

如果终端成功返回版本号，则代表 Codex 已成功安装。

3、获取 API Key

Codex 安装成功后，需要配置模型厂商的 API Key 才能工作。

3.1、获取 GLM-4.6 API Key

前往智谱 AI 开放平台：智谱 AI 开放平台
创建账号并登录，系统通常会赠送试用额度。
生成 API Key：登录后点击右上角头像 -> API key -> 添加新的 API key -> 输入名称 -> 确定。
复制生成的 Key 备用。

3.2、获取 Kimi K2 API Key

前往 Moonshot AI 开放平台：Moonshot AI 开放平台
注册与登录：如果没有账户，请先注册。
创建 API Key：在平台仪表盘中找到创建 API Key 选项。
保存 Key：API Key 创建后只会显示一次，请务必立即复制并妥善保存。

4、配置环境变量

为了让 Codex 能够连接到 Kimi K2 和 GLM-4.6，需要配置环境变量。

4.1、Windows

方法一：使用命令提示符 打开命令提示符（无需管理员），执行以下两条命令。请将占位符替换为真实的 API Key。

setx GLM_API_KEY "你的 GLM_API_Key"
setx KIMI_API_KEY "你的 Kimi_API_Key"

注意：使用 setx 设置的变量需要 重启终端 才会生效。建议关闭所有终端，然后再打开一个新的。

方法二：使用系统属性面板

在 Windows 搜索栏中输入'环境变量'，选择'编辑系统环境变量'。
在'系统属性'窗口中，点击'环境变量…'。
在'系统变量'区域，点击'新建…'，添加两个新变量。

4.2、macOS / Ubuntu

在 macOS 和 Ubuntu 系统中，环境变量通常配置在 Shell 的配置文件中。

确定您的 Shell 类型：运行 echo $SHELL。
- 如果输出包含 zsh，配置文件是 ~/.zshrc。
- 如果输出包含 bash，配置文件是 ~/.bashrc。
编辑配置文件：使用文本编辑器打开对应文件。

# 如果您使用 Zshnano ~/.zshrc
# 如果您使用 Bashnano ~/.bashrc

添加环境变量：在文件末尾添加以下内容。

export GLM_API_KEY="你的 GLM_API_Key"
export KIMI_API_KEY="你的 Kimi_API_Key"

使配置生效：运行以下命令让配置立即生效。

source ~/.zshrc
# 或者 source ~/.bashrc

5、运行并配置 Codex

启动 Codex 进行测试。

打开一个新的终端窗口，输入 codex。如果收到回复，证明配置正确。
退出 Codex，重新进入，确保加载了新的配置。
打开 ~/.codex/config.toml 文件（Windows 路径为 C:\Users\你的用户名\.codex\config.toml）。
编辑配置文件，示例内容如下（根据需求注释掉不使用的模型）：

model_provider = "glm"
model = "glm-4.6"
# model_provider = "kimi"
# model = "kimi-k2-0905-preview"

[model_providers.glm]
name = "zai"
base_url = "https://open.bigmodel.cn/api/coding/paas/v4"
env_key = "GLM_API_KEY"

[model_providers.kimi]
name = "kimi"
base_url = "https://api.moonshot.cn/v1"
env_key = "KIMI_API_KEY"

保存文件后，再次运行 codex。
当提示选择登录方式时，按方向键切换到 2. Provide your own API key，回车确认。

6、FAQ

6.1、登录报错

检查第 4 步配置环境变量是否正确。Windows 命令行需要全部关闭，后续新开的终端才会生效。
如果使用的是包月计划对应的 base_url，但未订阅包月套餐可能会报错。可尝试将 GLM 的 base_url 改为标准接口地址：

base_url = "https://open.bigmodel.cn/api/paas/v4/"

6.2、使用 Kimi K2 对话报错或警告

使用免费额度时，请求速率可能受限。如果超过每秒访问次数限制，会提示错误或警告。建议充值解锁更高的请求速率以获得流畅体验。

6.3、其他模型可以通过 API 接入吗

可以，例如 DeepSeek。去官网申请对应的 API Key 并按照本文教程配置即可。

6.4、官方配置文档参考

config 配置：https://github.com/openai/codex/blob/main/docs/config.md
mcp 配置：https://github.com/openai/codex/blob/main/docs/advanced.md#model-context-protocol-mcp

Codex 接入 Kimi K2 与 GLM-4.6 环境配置指南 (Windows/macOS/Ubuntu)