通过 BytePlus ModelArk 连接模型服务

使用独立 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]）：

# ~/.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"

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

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。