Codex CLI 是一个开源的AI编程助手，可在本地终端运行，同时通过API连接远程AI模型。它基于Rust构建，兼顾性能与安全性，能够读取、修改和执行你指定目录中的代码，同时保持严格的沙箱保护。
本指南将向你展示如何通过Novita AI配置Codex CLI以使用高级AI模型，包括专为编程优化的Qwen Coder、专注推理的DeepSeek，以及支持智能体工作流的Kimi K2等模型。
什么是Codex CLI？
Codex CLI 是基于终端的编程智能体，结合了本地执行能力与云端AI能力。与仅生成代码片段的代码生成工具不同，Codex CLI 能够理解你的整个项目，执行它创建的代码，调试问题，并反复迭代直到解决方案正常运行。
核心特性
本地优先架构：在本地机器上全量运行，仅通过API调用AI模型。你的代码保留在本地，同时可借助强大的云端AI能力。
项目理解能力：可读取整个代码库，理解现有模式、依赖和编码风格，生成与项目无缝契合的代码。
自主运行能力：可长时间独立工作，将复杂任务拆解并系统执行，无需过多监督。
灵活审批模式：
- 建议模式：每一步操作都需审批确认（默认模式）
- 自动编辑模式：自动编辑文件，但运行命令前会请求确认
- 全自动模式：完全自主运行，无需任何提示
安全特性：在禁用网络、目录沙箱化的环境中运行，在保障完整功能的同时保护你的系统安全。
Codex CLI 与 Claude Code 的核心差异
在深入配置Codex CLI之前，了解它与另一款热门AI编程助手Claude Code的区别非常重要：
Codex CLI
- 模型支持：支持OpenAI模型及OpenAI兼容API，同时支持多个服务商
- 架构：本地智能体，在终端运行，通过API调用远程模型
- 开源属性：完全开源，支持社区贡献
Claude Code
- 模型支持：聚焦Anthropic的Claude模型及Anthropic兼容API
- 架构：覆盖网页、桌面和IDE平台的集成化体验
- 开发模式：核心为闭源，仅提供API访问权限
Codex CLI 在精准度和处理复杂任务（尤其是现有代码库场景）方面表现更优。Claude Code 则通常在用户体验和初始项目搭建方面更受青睐。部分用户发现同时使用两款工具能获得最佳效果。如果你需要Claude专属工作流，可以查看我们的使用Novita AI运行Claude Code指南。
为什么要在Codex CLI中使用第三方API？
虽然Codex CLI原生支持OpenAI的模型，但Novita AI等第三方API具备以下核心优势：
专用模型：可访问DeepSeek V3.1等前沿推理模型、Qwen Coder等编程专用模型，以及Kimi K2等智能体工作流模型。
成本与性能：具备竞争力的定价，提供针对特定任务优化的模型，覆盖从轻量响应到复杂问题求解的全场景。
自定义模型：通过Novita AI，你甚至可以在Codex CLI中快速使用自有自定义模型，满足专属需求。
可靠性：备用服务商可降低速率限制影响，在服务中断或区域限制期间保障稳定访问。
如何在Codex CLI中使用Novita AI模型
前置要求
- 注册账号：访问Novita AI官网注册账号。
- 生成API密钥：登录后，进入密钥管理页面生成你的API密钥。
- 选择模型名称：你需要从Novita AI的模型库中复制要使用的模型名称，部分可用模型包括：
deepseek/deepseek-v3.1qwen/qwen3-coder-480b-a35b-instructmoonshotai/kimi-k2-0905openai/gpt-oss-120bzai-org/glm-4.5google/gemma-3-12b-it
- 安全保存：后续配置时需要用到该密钥。
安装
通过npm安装（推荐）
npm install -g @openai/codex
通过Homebrew安装（macOS系统）
brew install codex
验证安装
codex --version
配置Novita AI模型
创建配置文件
Codex CLI 使用TOML配置文件，位置如下：
- macOS/Linux：
~/.codex/config.toml - Windows：
%USERPROFILE%\.codex\config.toml
基础配置模板
model = "MODEL_NAME"
model_provider = "novitaai"
[model_providers.novitaai]
name = "Novita AI"
base_url = "https://api.novita.ai/openai"
http_headers = {"Authorization" = "Bearer YOUR_NOVITA_API_KEY"}
wire_api = "chat"
可用模型及适用场景
| 模型 | 适用场景 | 优势 |
|---|---|---|
deepseek/deepseek-v3.1 |
复杂算法与架构设计 | 推理与问题解决能力出众 |
qwen/qwen3-coder-480b-a35b-instruct |
代码生成与重构 | 专为编程任务优化 |
moonshotai/kimi-k2-0905 |
智能体工作流与自动化 | 执行速度快，长上下文处理能力强 |
openai/gpt-oss-120b |
通用开发任务 | 稳定的基准性能 |
zai-org/glm-4.5 |
工具集成与调试 | 工具调用成功率极高 |
google/gemma-3-12b-it |
轻量开发任务 | 响应高效快速 |
快速开始
启动Codex CLI
codex
基础用法示例
代码生成：
> Create a Python class for handling REST API responses with error handling
项目分析：
> Review this codebase and suggest improvements for performance
问题修复：
> Fix the authentication error in the login function
测试生成：
> Generate comprehensive unit tests for the user service module
在现有项目中使用
启动Codex CLI前先进入你的项目目录：
cd /path/to/your/project
codex
Codex CLI 会自动理解你的项目结构，读取现有文件，并在整个会话中保留代码库的上下文。
总结
搭配Novita AI模型使用的Codex CLI 提供了强大的灵活开发环境，结合了本地控制权与云端AI能力。通过为不同任务选择合适的模型、正确配置环境，你可以在保障代码质量与安全性的同时，大幅提升开发效率。建议先从使用Qwen Coder处理通用开发任务的基础配置开始，随着需求变化再逐步尝试DeepSeek等专用模型处理复杂推理，或使用Kimi K2处理自主工作流。
关于Novita AI
Novita AI 是一个AI云平台，为开发者提供简洁的API来部署AI模型，同时提供高性价比、可靠的GPU云服务，用于AI模型的构建与扩展。
推荐阅读
