跳到主要内容
feedback
feedback

Codex

Codex 是一款基于 OpenAI API 的 AI 编程助手工具。跟着这个教程，你可以轻松在自己的电脑上安装并使用 Codex。

模力方舟提供对 Codex 的原生支持，你可以使用模力方舟的任一编码模型，享受更优质的中文支持和更低的调用成本。
推荐使用 GUI：建议优先使用 Codex 桌面版（GUI）。GUI 更适合日常使用，安装后可直接在图形界面中选择项目并开始对话。

安装 Codex​

Codex CLI 支持官方独立安装程序和包管理器安装。独立安装程序不需要提前安装 Node.js；如果使用 npm，则需要先安装 Node.js。

安装方式​

官方独立安装不需要提前安装 Node.js，推荐优先使用。npm 安装需要 Node.js，Homebrew 适用于 macOS：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

安装方式和系统要求可能随版本更新，最新信息请以 Codex CLI 官方安装文档 为准。

验证 Codex CLI 安装​

安装完成后，重新打开终端并运行：

codex --version

如果显示版本号，说明安装成功了！

获取访问令牌​

开发者首先需要访问 工作台 -> 设置 -> 访问令牌 中获取访问令牌，没有购买 Serverless API 的开发者，可以使用免费体验访问令牌（仅供体验，每日调用次数有限），复制想要使用的令牌即可。

访问令牌页面

配置 Codex​

为了让 Codex 连接到模力方舟的服务，需要进行配置文件设置。

手动配置文件设置​

请确保以下内容位于 config.toml 文件的开头部分。

在 ~/.codex/config.toml 文件中添加以下配置。在 WSL 中运行 Codex 时，也使用 WSL 发行版内的此路径：

model_provider = "Moark"
model = "DeepSeek-V4-Pro"
review_model = "DeepSeek-V4-Pro"
model_reasoning_effort = "high"
model_context_window = 1000000
disable_response_storage = true
network_access = "enabled"

[model_providers.Moark]
name = "Moark"
wire_api = "responses"
base_url = "https://ai.gitee.com/v1"
experimental_bearer_token = "你的 API 密钥"
记得将 config.toml 中的“你的 API 密钥”替换为上方“获取访问令牌”步骤中获取的实际密钥。请勿将包含真实密钥的文件提交到 Git 仓库。

使用 CC Switch 自动配置（推荐）​

CC Switch 可以通过图形界面管理 Codex 的服务商、API Key 和模型配置，并支持一键切换。

在 CC Switch 中选择 Codex，添加并启用模力方舟供应商配置即可。包含下载安装、访问令牌、请求地址、模型映射及验证的完整操作，请参阅 CC Switch 快速配置。

Codex 的请求地址、上游格式和模型参数，可通过 工具配置参考 快速获取。

配置覆盖提示

启用或切换 Codex 供应商时，CC Switch 会写入 ~/.codex/config.toml 和 ~/.codex/auth.json。原有手动配置可能被覆盖，使用前请先备份；需要保留的共享设置应放入 CC Switch 的 通用配置。

验证配置​

完全退出并重新启动 Codex 或重新打开终端后，运行：

codex --version

然后在 Codex 中输入：

开始使用 Codex​

配置完成后，你就可以开始使用 Codex 了！在任何目录下运行：

codex

这将启动 Codex 交互界面，你可以开始与 AI 编程助手进行对话了。

更多资源​

常见故障排查​

  • codex 命令不存在：如果使用 npm 安装，请确认 Node.js 和 npm 已正确安装，然后重新打开终端并运行 npm install -g @openai/codex。
  • 认证失败或无法连接：检查 config.toml 中的 experimental_bearer_token、base_url 是否为 https://ai.gitee.com/v1、wire_api 是否为 responses。
  • 模型未显示或无法选择：确认模型 ID 为 DeepSeek-V4-Pro，并完全退出 Codex 后重新启动。
  • 配置未生效：完全退出 Codex 后重新启动，并确认 WSL 使用的是发行版内的 ~/.codex 路径。
Copyright © 2026 模力方舟京ICP备2025119063号京公网安备11011502039387号京公网安备11011502039387号