【图文】Codex接入Kimi K2/GLM-4.7 环境配置指南 (Windows/macOS/Ubuntu)

212 阅读6分钟

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

本指南将引导您完成安装 Codex ,并通过API方式配置 Kimi K2GLM-4.7 模型,以更实惠的方式来AI编程。

1、安装 Node.js

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

  • 下载与安装:请前往 Node.js 官方网站 下载并安装最新版本的 Node.js(建议使用 v18 或更高版本)。根据您的操作系统下载对应的安装包。 在这里插入图片描述

  • 验证安装:安装完成后,打开您的终端(Terminal)或命令提示符(CMD),运行以下命令来验证。

    node -v
    

    如果成功安装,将会显示 Node.js 的版本号(如图绿框中的)。 在这里插入图片描述

2、安装 Codex

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

注意:为了获得最佳的安装体验,建议连接稳定的网络环境(例如使用科学上网)运行安装命令。

2.1、Windows

    1. 管理员身份 打开您的 命令提示符(CMD)PowerShell
    1. 输入并运行以下安装命令:
      npm install -g @openai/codex
      
      在这里插入图片描述

2.2、macOS / Ubuntu

    1. 打开您的 终端(Terminal)
    1. 由于全局安装 npm 包需要系统权限,您需要在命令前加上 sudo
    1. 输入并运行以下安装命令(过程中会提示您输入电脑的登录密码):
      sudo npm install -g @openai/codex
      

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

  • 安装完成后,在 新的终端窗口 中运行以下命令来验证。(旧的窗口也许可以,建议新的哈)。
    codex--version
    
    如果终端成功返回版本号,则代表 Codex 已成功安装(绿框中的)。 在这里插入图片描述

3、获取API Key

Codex 安装成功,这时它还不能工作,因为需要登录官方或者其他模型厂商才可以。 我没有订阅GPT,因为太贵了,所以我选择了 Kimi K2和GLM-4.7的 API 来驱动Codex。 因此我们先去获取Kimi K2和GLM-4.7 的 API Key来登录。 你可以把这个API Key理解成访问密码,访问模型时需要用到这个密码哦。

3.1、获取GLM-4.7 API Key

  1. 前往 智谱AI开放平台智谱AI开放平台
  2. 创建账号并登录
  3. 登录后按顺序点击:右上角的头像 -> API key -> 添加新的API key -> 输入一个名字来标识这个key -> 确定。 在这里插入图片描述
  4. 申请成功后点击一下API key的复制按钮,把key复制到剪贴板中给后续使用。 在这里插入图片描述

3.2、获取Kimi K2 API Key

  1. 前往 Moonshot AI开放平台Moonshot AI开放平台

  2. 注册与登录:如果您没有账户,请先注册一个新账户并登录。

  3. 创建 API Key:在平台仪表盘中,找到创建 API Key 的选项。

    • 重要提示:Moonshot 的 API Key 在创建后只会显示一次,请务必立即复制并妥善保存。在这里插入图片描述

4、配置环境变量

万事俱备,只欠东风!为了让 Codex 能够成功连接到 Kimi K2和GLM-4.7,我们需要配置环境变量到Codex

4.1、Windows

您可以选择以下任一方法进行配置:

  • 方法一:使用命令提示符 打开命令提示符(无需管理员),并执行以下两条命令。请确保将 "你的GLM_API_Key""你的Kimi_API_Key" 替换为您真实的 API Key。替换后重启一下终端。

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

    注意:使用 setx 设置的变量需要 重启终端 才会生效。建议关闭所有终端,然后再打开一个新的。 注意:使用 setx 设置的变量需要 重启终端 才会生效。建议关闭所有终端,然后再打开一个新的。 注意:使用 setx 设置的变量需要 重启终端 才会生效。建议关闭所有终端,然后再打开一个新的。 在这里插入图片描述

  • 方法二:使用系统属性面板

    1. 在 Windows 搜索栏中输入“环境变量”,并选择“编辑系统环境变量”。
    2. 在“系统属性”窗口中,点击“环境变量...”。
    3. 在“系统变量”区域,点击“新建...”,并添加两个新变量。

4.2、macOS / Ubuntu

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

  1. 确定您的 Shell 类型 在终端中运行 echo $SHELL

    • 如果输出包含 zsh,您的配置文件是 ~/.zshrc
    • 如果输出包含 bash,您的配置文件是 ~/.bashrc
  2. 编辑配置文件 使用您喜欢的文本编辑器打开对应的文件。这里以 nano 为例(一个对新手友好的终端编辑器)。

    # 如果您使用 Zsh (macOS 默认)
    nano ~/.zshrc
    
    # 如果您使用 Bash
    nano ~/.bashrc
    
  3. 添加环境变量 在文件的末尾,添加以下两行。请将 你的Kimi_API_Key 替换为您真实的 API Key。

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

    添加后,按下 Ctrl + O 保存文件,然后按 Ctrl + X 退出编辑器。

  4. 使配置生效 运行以下命令让配置立即生效(或直接重启终端)。

    # 如果您修改了 .zshrc
    source ~/.zshrc
    
    # 如果您修改了 .bashrc
    source ~/.bashrc
    

5、运行并配置 Codex

好,到此所有准备工作已经完成!让我们启动 Codex 吧!

  1. 打开一个新的终端窗口。

  2. 输入codex 命令,你会看到让你选择登录方式,我们这里需要按方向键切换到2. Provide your own API key,回车确认:

    codex
    

    在这里插入图片描述

  3. 紧接着让你输入API Key,注意这里是输入的GPT官方的API Key,我们胡乱输一个确认即可:在这里插入图片描述

  4. 然后打开~/.codex/config.toml文件(windows在C:\Users\你的用户名\.codex\config.toml),这里我使用vscode来打开并编辑,直接复制粘贴以下内容并保存,这里我使用GLM-4.7的模型,你要用kimi的话就把glm注释掉,然后把kimi打开: model_provider = "glm" model = "glm-4.7"

    # 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"
    

    在这里插入图片描述

  5. 接着退出Codex,重新进入一下。一定要退出重进,因为我们刚改了配置嘛,需要让Codex重新加载~再次进入Codex,可以看到模型是GLM-4.7了:在这里插入图片描述

  6. 我们让他自我介绍一下,如果收到回复,就证明配置正确了(如图绿色框的回复)。在这里插入图片描述

6、FAQ

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

  • 可以,类似glm和kimi,比如deepseek,你可以去deepseek官网申请对应的api key并充值额度,然后按照这篇教程配置进来。deepseek传送门:DeepSeek 开方平台

6.2、官方的配置文档参考