文档中心

火山方舟

接入 AI 工具

Codex

本文介绍如何在 Codex 中配置并使用方舟 Coding Plan。

核心配置

接入工具的核心参数如下：

模型配置

支持以下两种方式配置模型：

配置 Model Name (配置文件指定)

配置 ark-code-latest (控制台管理)

在工具配置文件中指定 Model Name，可实时切换模型。支持配置的 Model Name：

注意

配置 Model Name 时，支持使用全小写格式，同时也支持直接复制中的模型名称。

doubao-seed-evolving

doubao-seed-2.1-pro

doubao-seed-2.1-lite

doubao-seed-2.0-mini

glm-5.3 (glm-latest)

glm-5.3-flash

deepseek-v4.1-flash

deepseek-v4.1-flash-economy

deepseek-v4-flash

deepseek-v4-pro

kimi-k2.8-preview

kimi-k3

kimi-k3.1-pro

说明

Model Name 不支持配置为 Auto，如需使用，请通过控制台切换该模式。

Base URL

不同的工具配置的 Base URL 根据兼容的协议会有不同：

兼容 Anthropic 接口协议工具：https://ark.cn-beijing.volces.com/api/coding

兼容 OpenAI 接口协议工具：https://ark.cn-beijing.volces.com/api/coding/v3

注意

请勿使用 https://ark.cn-beijing.volces.com/api/v3 ：该 Base URL 不会消耗您的 Coding Plan 额度，而是会产生额外费用。

API Key

获取 API Key

前提条件

您已按需订阅 Coding Plan 套餐。如未订阅，请访问方舟 Coding Plan 活动按需订阅套餐。

Codex CLI

安装 Codex CLI

说明

Coding Plan 支持 Responses API，可以使用最新版 Codex CLI。

前提条件：安装 Node.js 18 或更新版本。

在命令行界面，执行以下命令安装 Codex CLI。

安装结束后，执行以下命令检查版本。

配置 Codex CLI

方式 1：一键配置（推荐）

Ark CLI 是火山方舟平台官方命令行工具，支持在本地终端快速完成认证与资源管理，并可将能力安装到常用 AI Agent 中，降低手动配置的时间成本和出错风险。

安装 Ark CLI

环境要求：Node.js 18 或更新版本。支持 macOS、Linux、Windows。

根据界面提示选择登录方式，推荐选择火山 SSO (浏览器登录)，在浏览器中完成授权即可。

一键配置 Codex

运行 ArkCLI Helper，根据界面提示完成配置。

选择 Profile：coding-plan_cn-beijing_personal。

选择默认 model：按需选择。

选择 AI Agent：Codex。

配置完成后，Codex 会自动识别配置的模型。启动 Codex 即可使用。

方式 2：手动配置

新建 ~/.codex/config.toml（Windows 路径：%USERPROFILE%\.codex\config.toml），配置信息如下：

model：配置方式参见模型配置。

env_key：设置的是环境变量名称，请不要直接修改 ARK_API_KEY，您需要在下一步设置该环境变量的值。

model = "<MODEL_NAME>"
model_provider = "volcengine-coding-plan"

[model_providers.volcengine-coding-plan]
name = "volcengine-coding-plan"
base_url = "https://ark.cn-beijing.volces.com/api/coding/v3"
env_key = "ARK_API_KEY"
wire_api = "responses"

注意

model_reasoning_effort：控制思考长度，可以设置为 low、medium、high。

配置环境变量，需要将 ARK_API_KEY 环境变量设置为 API Key。

macOS / Linux
Windows
查看 Shell 类型。

echo $SHELL

将环境变量写入 Shell 配置文件，使其在新开终端时自动生效。
Zsh

# 将 YOUR_API_KEY 替换为API Key。
echo 'export ARK_API_KEY="YOUR_API_KEY"' >> ~/.zshrc
source ~/.zshrc

Bash

# 将 YOUR_API_KEY 替换为API Key。
echo 'export ARK_API_KEY="YOUR_API_KEY"' >> ~/.bashrc
source ~/.bashrc
CMD：环境变量设置完成后，新开 CMD 窗口生效。

# 将 YOUR_API_KEY 替换为API Key。
setx ARK_API_KEY "YOUR_API_KEY"
# 新开窗口，检查环境变量是否生效
echo %ARK_API_KEY%

PowerShell：环境变量设置完成后，新开 PowerShell 窗口生效。

# 将 YOUR_API_KEY 替换为API Key。
[Environment]::SetEnvironmentVariable("ARK_API_KEY", "YOUR_API_KEY", [EnvironmentVariableTarget]::User)
# 新开窗口，检查环境变量是否生效
echo $env:ARK_API_KEY

配置完成后，即可使用 Codex CLI。

使用 Codex CLI

执行以下命令启动 Codex CLI。

Codex 桌面客户端

OpenAI 更新后已取消 Codex 的独立应用，将其融入了 ChatGPT Desktop App 作为其中的一个模式。

安装 ChatGPT 桌面客户端

从 OpenAI 官网下载并安装 ChatGPT 桌面客户端。

配置桌面客户端

单击左下角的设置。

在配置页面单击打开 config.toml。

编辑 config.toml，需关注的配置信息如下。

model：配置方式参见模型配置。

env_key：设置的是环境变量名称，请不要直接修改 ARK_API_KEY，您需要在下一步设置该环境变量的值。

model = "<MODEL_NAME>"
model_provider = "volcengine-coding-plan"

[model_providers.volcengine-coding-plan]
name = "volcengine-coding-plan"
base_url = "https://ark.cn-beijing.volces.com/api/coding/v3"
env_key = "ARK_API_KEY"
wire_api = "responses"

注意

model_reasoning_effort：控制思考长度，可以设置为 low、medium、high。

配置环境变量，需要将 ARK_API_KEY 环境变量设置为 API Key。

macOS / Linux
Windows
查看 Shell 类型。

echo $SHELL

将环境变量写入 Shell 配置文件，使其在新开终端时自动生效。
Zsh

# 将 YOUR_API_KEY 替换为API Key。
echo 'export ARK_API_KEY="YOUR_API_KEY"' >> ~/.zshrc
source ~/.zshrc

Bash

# 将 YOUR_API_KEY 替换为API Key。
echo 'export ARK_API_KEY="YOUR_API_KEY"' >> ~/.bashrc
source ~/.bashrc
CMD：环境变量设置完成后，新开 CMD 窗口生效。

# 将 YOUR_API_KEY 替换为API Key。
setx ARK_API_KEY "YOUR_API_KEY"
# 新开窗口，检查环境变量是否生效
echo %ARK_API_KEY%

PowerShell：环境变量设置完成后，新开 PowerShell 窗口生效。

# 将 YOUR_API_KEY 替换为API Key。
[Environment]::SetEnvironmentVariable("ARK_API_KEY", "YOUR_API_KEY", [EnvironmentVariableTarget]::User)
# 新开窗口，检查环境变量是否生效
echo $env:ARK_API_KEY

使用桌面客户端

配置完成后，需要退出 ChatGPT 桌面客户端并重新打开让配置生效。重新启动后，即可在对话界面中使用。

使用 Codex 的 Web Search 功能

说明

在 Coding Plan 场景下，通过 Responses API 接入的 Codex 也可原生使用 Web Search 功能。

使用豆包搜索承接的 Web Search 会额外发起大模型 API 请求，对搜索结果进行总结。使用前需前往方舟控制台 > 开通管理 > 应用组件库 > 豆包搜索启用并开通豆包搜索 Custom 版服务，否则将无法使用 Web Search 功能。

完成配置后，按以下步骤在 Codex 使用 Web Search 功能。

登录方舟控制台，打开应用组件库 > 豆包搜索标签页。

在豆包搜索 Custom 版的操作列中点击开通服务。

在 Codex 中直接提问，例如"GitHub 最近有哪些热门开源项目"。

最近更新时间：2026.11.03 21:11:08

这个页面对您有帮助吗？

有用

无用