---
title: 用火山方舟 Coding Plan
nav: 火山方舟
summary: 在中国大陆用字节跳动的火山方舟 Coding Plan 驱动 Agent J：先买 Lite，key 贴进手机密钥卡，用 OpenCode 或 Claude Code，默认豆包 Seed 2.1 Pro 能看截图。
order: 40
---
# 用火山方舟 Coding Plan

火山方舟是字节跳动（抖音、豆包同一家）旗下火山引擎的模型平台。Coding Plan 是它专为编程工具推出的包月套餐，一把 key 就能调用豆包、Kimi、智谱 GLM、DeepSeek、MiniMax 这五家的 16 个模型。

还没决定用哪家？先看[按你用的模型选](/docs/models/)。安装、配对手机这些每家都一样的事，看[安装](/docs/install/)和[手机上怎么用](/docs/phone/)。

## 适合谁 {#who}

- 在中国大陆，Claude Code 和 Codex 用不了，三家都还没有：**我们首推它，先买 Lite**。
- 已经开通了方舟 Coding Plan：直接用，不用再买别的。
- 在香港或海外：方舟的海外版叫 BytePlus，模型比大陆版旧、没有 Kimi K3，Agent J 也还没有它的一键配置。海外建议用 [Kimi](/docs/kimi/)。

## 开通与套餐 {#plan}

1. 打开火山方舟 Coding Plan 的官方活动页 https://www.volcengine.com/activity/codingplan ，用手机号注册火山引擎，完成实名认证。
2. 订阅 Coding Plan，**先买 Lite**。Lite 和 Pro 能用的模型和工具完全一样（包括 Kimi K3），Pro 只是用量是 Lite 的 5 倍。额度不够再升级。

价格以下单页为准，见[火山方舟 Coding Plan 活动说明](https://docs.volcengine.com/docs/ark/coding-plan-personal-universal-promotion?lang=zh)。2026-10-16 我们核对时，新用户头两个月有活动价，活动到 2026-11-08。Lite 是入门档，Pro 用量是 Lite 的 5 倍，价格也更高。用量怎么算，见官方 [Coding Plan 常见问题](https://docs.volcengine.com/docs/ark/coding-plan-personal-faq?lang=zh)。

## 拿 key {#key}

1. 打开方舟控制台 https://console.volcengine.com/ark/ ，在 API Key 管理里新建一把 key。
2. **先别复制给任何人。** 等手机上弹出密钥卡再贴。

## 把 key 交给 Agent J {#hand-over}

跟电脑上的 Agent 说一句：帮我接上火山方舟 Coding Plan。它会这样做：

1. 运行下面这条，把套餐里的 16 个模型写进 OpenCode 的设置。你原来的设置一项都不动。

```bash
agentj provider ark
```

2. 运行它打印出来的那条密钥卡命令。手机上会弹出密钥卡，名称是 `ARK_CODING_PLAN_API_KEY`，你只需把 key 贴进卡里。
3. 重启后台服务，再切到方舟的默认模型：

```bash
agentj service restart
```

```bash
agentj agent switch opencode --model ark-coding-plan/doubao-seed-2.1-pro
```

方舟没有只读的核对接口，贴完 key 不能马上验。**切过去以后的第一条回复就是核对**：问它一句“你是哪个模型”，答出豆包就对了。

密钥卡怎么用，见[手机上录入密钥](/docs/phone-admin/)。

## 能用的 AI 编程工具 {#tools}

方舟没有自带的编程命令行工具，用下面两个之一：

- **OpenCode（默认）**：上面那几步就是。没装 OpenCode 的，见[装好 AI 命令行工具](/docs/setup-agents/#opencode)。
- **Claude Code**：你本来就习惯 Claude Code 时用。让 Agent 运行下面这条，它会打印三步，照着顺序做：存一份方舟的配置、弹密钥卡、启用这份配置。最后一步会先真发一句测试，通过了才改设置。

<details>
<summary>技术细节：接 Claude Code 的那条命令</summary>

```bash
agentj provider ark --harness claude
```

</details>

Agent J 会把 Claude Code 的 Haiku、Sonnet、Opus 和子 Agent 都指向同一个方舟模型，这样后台任务就不会因为向方舟请求 Claude 的模型名而失败。

## 模型与看图 {#models}

| 用途 | 模型 | 能看截图 |
|---|---|---|
| 默认，日常加截图 | `doubao-seed-2.1-pro` | 能（实测） |
| 最强，但扣额度快 | `kimi-k3` | 能（实测） |
| 便宜、快，也能看图 | `deepseek-v4-1-flash` | 能（实测） |
| 纯文本写代码 | `glm-5.3`、`deepseek-v4-pro`、`deepseek-v4-flash` | 不能 |

“实测”指 2026-10-16 我们在电脑上发一张软件截图，让模型读出弹窗标题、错误码、按钮上的字和表格里的金额，全部读对。手机上发 `/model` 能看到全部模型。Agent J 写进 OpenCode 的设置里，只给确认能看图的模型打开了图片输入，没确认的一律按纯文本处理。

用纯文本模型时，你从手机发截图、或者浏览器自动化要看页面，模型都看不到，会说没收到图片。这时换回 `doubao-seed-2.1-pro` 就行。

## 常见坑 {#pitfalls}

- **报 401 或 403**：多半是 key 贴错了，或者套餐还没开通。去控制台重新建一把，再弹一次密钥卡。
- **Kimi K3 很快就用完了**：方舟官方说它扣额度快，建议 Pro 用户用。Lite 也能选，用完前换回豆包就行。
- **提示另外计费**：用错了地址。Agent J 写的是套餐专用的地址，不要自己手改。
- **Coding Plan 不能生图**：套餐里没有生图模型。
- **定时任务、客服 bot**：这个套餐只给你在编程工具里交互用。没人看着的活要用按量付费的方舟 key，Agent J 不会把 Coding Plan 的 key 交给它们。

## 切回原来的工具 {#switch-back}

随时跟 Agent 说“切回 Claude Code”（或 Codex），它会先检查、能用才切。也可以自己在电脑上运行：

```bash
agentj agent switch claude
```

想原样换回上一次切走前的那个：

```bash
agentj agent switch --undo
```

切换的细节见[换 AI 编程工具](/docs/switch-harness/)。

<details>
<summary>技术细节：地址和名字</summary>

- OpenCode 里的服务商名是 `ark-coding-plan`，模型写成 `ark-coding-plan/<模型>`。
- OpenAI 兼容地址：`https://ark.cn-beijing.volces.com/api/coding/v3`；Claude Code 用的 Anthropic 兼容地址：`https://ark.cn-beijing.volces.com/api/coding/v1`。这两个都是套餐专用地址。
- key 的环境变量名：OpenCode 用 `ARK_CODING_PLAN_API_KEY`；Claude Code 那份配置有自己的私有 key 文件，位置由 Agent J 打印的第二步给出。

</details>