---
title: "通过 BytePlus ModelArk 连接模型服务"
summary: "使用独立 profile 连接 Coding Plan 的 Responses 入口，通过 ARK_API_KEY 认证。/api/v3 按量入口另行计费，需使用 /api/coding/v3。"
category: config
level: intermediate
surfaces: [cli, app, ide]
tags: ["model_providers", "BytePlus", "ModelArk", "wire_api", "profile"]
canonical: /tips/byteplus-codex-gateway/
---

# 通过 BytePlus ModelArk 连接模型服务

使用独立 profile 连接 Coding Plan 的 Responses 入口，通过 ARK_API_KEY 认证。/api/v3 按量入口另行计费，需使用 /api/coding/v3。

使用独立 profile 连接 Coding Plan 的 Responses 入口，通过 ARK_API_KEY 认证。/api/v3 按量入口另行计费，需使用 /api/coding/v3。

Codex 的模型请求发送到 BytePlus ModelArk Coding Plan 的 OpenAI Responses 入口。官方 Codex 页给了 `[model_providers.byteplus-coding-plan]` 和 `wire_api = "responses"`。`env_key` 已经是变量**名** `ARK_API_KEY`，在启动 Codex 的进程里 `export`。不要和 `experimental_bearer_token` / `requires_openai_auth` / `[model_providers.*.auth]` 叠在同一张供应商表。

`base_url` 必须是 `https://ark.ap-southeast.bytepluses.com/api/coding/v3`。不要抄 Anthropic 的 `https://ark.ap-southeast.bytepluses.com/api/coding`，更不要打按量主机 `https://ark.ap-southeast.bytepluses.com/api/v3`——官方写明那条不走 Coding Plan 配额，会另计费。**Codex 不会在 `base_url` 里展开环境变量**。不要写 `openai_base_url`。这不是火山引擎国内站 `ark.cn-beijing.volces.com`，密钥和主机不要混。

不要把顶层 `model_provider = "byteplus-coding-plan"` 一上来写进用户 config，除非你就是要把**所有**会话都改走 BytePlus。官方手册和 ArkCLI Helper 都会改成默认。更稳妥是独立 profile（0.134 起不要再写 `[profiles.byteplus]`）：

```toml
# ~/.codex/config.toml
[model_providers.byteplus-coding-plan]
name = "byteplus-coding-plan"
base_url = "https://ark.ap-southeast.bytepluses.com/api/coding/v3"
env_key = "ARK_API_KEY"
wire_api = "responses"
```

```toml
# ~/.codex/byteplus.config.toml
model_provider = "byteplus-coding-plan"
model = "ark-code-latest"
model_supports_reasoning_summaries = true
model_reasoning_effort = "medium"
```

```bash
export ARK_API_KEY=YOUR_ARK_API_KEY
codex --profile byteplus
codex --profile byteplus -m ark-code-latest
```

`ark-code-latest` 是控制台里切换的别名，改完等几分钟再生效。也可以改成控制台给出的具体模型 ID。官方还写 `model_supports_reasoning_summaries = true`，reasoning 档是 `low` / `medium` / `high`。

官方一键是 `npm install -g @byteplus/ark-cli`，再 `arkcli helper`。套餐选 `coding-plan_ap-southeast-1_personal`，智能体只勾 Codex。向导会改 `~/.codex/config.toml` 并可能写成全局默认；跑完改回独立 profile。不要把 `arkcli +connect` 当成只装 Codex 的命令，它会把技能安装到本机其它助手。状态目录是 `~/.arkcli-bp`，不是 `~/.codex`。

配置注意事项：

- 不要再写 `[profiles.byteplus]` 或 `wire_api = "chat"`。
- 不要覆盖内置 ID `openai`、`ollama`、`lmstudio`。`byteplus-coding-plan` 是新 ID，可以。
- 不要写进项目 `.codex/config.toml`。项目文件改不了 `model_provider` / `model_providers`。

改完新开会话。`codex --profile byteplus` 启动后，发送一条简短请求验证连接。401 先看是不是拿按量密钥打了 Coding Plan 主机，或国内站密钥打了 `bytepluses.com`。

## 来源

- [BytePlus · Codex](https://docs.byteplus.com/en/docs/ModelArk/2556056)
- [BytePlus · Ark CLI guide for Coding Plan](https://docs.byteplus.com/en/docs/modelark/2656115)
- [BytePlus · ModelArk FAQs](https://docs.byteplus.com/api/docs/ModelArk/2165245)