---
title: 用 Kimi 会员（Kimi Code）
nav: Kimi
summary: 用月之暗面的 Kimi 会员（Plus 或更高档）驱动 Agent J：香港和海外首推，大陆也能用；key 贴进手机密钥卡，用 OpenCode 或 Kimi 自家的 Kimi Code，默认 Kimi K3 能看截图。
order: 41
---
# 用 Kimi 会员（Kimi Code）

Kimi 是月之暗面出的产品。如果你买了 Kimi 会员（Plus 或更高档），里面自带编程额度，叫 Kimi Code。这个可以直接接进 Agent J。

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

## 适合谁 {#who}

- 人在香港或海外，Claude Code 和 Codex 用不了：**首推 Kimi**。国内三家套餐里，只有 Kimi 的海外路线 Agent J 内置支持。
- 人在大陆，已经是 Kimi 会员：直接用。
- 人在大陆，还没买过：首推[火山方舟](/docs/ark/)，Kimi 也能用。

## 开通与套餐 {#plan}

1. 打开 Kimi 官网 https://www.kimi.com/ 。kimi.com 是月之暗面的主站，大陆也用它；海外站是 https://www.kimi.ai/ 。
2. 订阅 **Plus 或更高档**。**Go 档没有编程额度，买了也接不上。**

价格以官方购买页为准：[kimi.com 会员价格](https://www.kimi.com/en/help/membership/membership-pricing)、[kimi.ai 会员价格](https://www.kimi.ai/help/membership/membership-pricing)。2026-10-16 我们从海外访问这两页，价格一样，都按美元收费；从大陆访问 kimi.com 是人民币价格。编程额度从 Plus 档起，具体价格以页面为准。

电脑上的 Agent 运行 `agentj agent route` 时，也会给出一个购买链接。那是 Agent J 官方的邀请链接，链接后面会紧跟一句说明，见[装好 AI 命令行工具](/docs/setup-agents/)。

## 拿 key {#key}

1. 打开 Kimi Code 控制台：kimi.com 会员用 https://www.kimi.com/code/console ，kimi.ai 会员用 https://www.kimi.ai/code/console 。
2. 新建一把 key。它只显示一次，**先别复制给任何人**，等手机上弹出密钥卡再贴。

用 Kimi Code 时也可以不要 key，直接登录，见下面的[能用的 AI 编程工具](/docs/kimi/#tools)。

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

跟电脑上的 Agent 说一句：帮我接上 Kimi 会员。它会这样做：

1. 运行下面这条。在 Claude Code 和 Codex 用不了的电脑上，它会打印 Kimi 的密钥卡命令和后面几步。

```bash
agentj agent route
```

2. 运行那条密钥卡命令。手机上会弹出密钥卡，名称是 `KIMI_API_KEY`，你只把 key 贴进卡里。贴完 Agent J 马上用 Kimi 的只读接口核对一次。
3. 重启后台服务，看现在能切到哪些工具，再切到 Kimi K3：

```bash
agentj service restart
```

```bash
agentj agent switch --scan
```

```bash
agentj agent switch opencode --model kimi-code-plan-cn/k3
```

在 kimi.ai 买的会员，模型改写成 `kimi-code-plan-global/k3`。

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

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

两个都能用，同一个会员：

- **OpenCode（默认）**：上面那几步就是。OpenCode 自带 Kimi 接入，不用另外写设置。没装 OpenCode 的，见[装好 AI 命令行工具](/docs/setup-agents/#opencode)。
- **Kimi Code（月之暗面自家的 `kimi`，MIT 开源）**：要 2.2.0 或更新。安装：

```bash
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash
```

登录二选一：在你**自己的终端**里运行 `kimi login --region mainland-cn`（kimi.com 的会员）或 `kimi login --region global`（kimi.ai 的会员），按提示在登录了 Kimi 的设备上确认；或者用上面那张 `KIMI_API_KEY` 密钥卡。然后切过去：

```bash
agentj agent switch kimi
```

kimi.ai 的会员加 `--region global`：

```bash
agentj agent switch kimi --region global
```

Kimi Code 只支持独立会话。每次权限请求都会发到手机上，你点同意只管这一次。更多见[换成 Kimi Code](/docs/switch-harness/#kimi)。

## 模型与看图 {#models}

| 用途 | OpenCode 里的模型 | 能看截图 |
|---|---|---|
| 主力 | `kimi-code-plan-cn/k3` | 能（实测） |
| 快，轻任务 | `kimi-code-plan-cn/kimi-for-coding` | 能（实测） |
| K3 的 256k 上下文版，省额度 | `kimi-code-plan-cn/k3-256k` | 官方写支持 |

kimi.ai 会员把前缀 `kimi-code-plan-cn/` 换成 `kimi-code-plan-global/`。实测指 2026-10-16 我们在电脑上发一张软件截图，让模型读出弹窗标题、错误码、按钮上的字和表格里的金额，OpenCode 和 Kimi Code 都全部读对。Kimi 官方说 K3 的 1M 上下文要 Pro 及以上。

## 常见坑 {#pitfalls}

- **用着用着报 401**：多半不是 key 坏了，是额度用完了。Kimi 按 5 小时和每月两层算额度，具体次数官方不公开，而且和 Kimi App 共用。等额度恢复，或升级套餐。
- **买了 Go 档接不上**：Go 没有编程额度，要 Plus 或更高。
- **kimi.com 还是 kimi.ai**：按你在哪个站买的选。2026-10-16 实测，kimi.com 买的会员 key 在国内和海外两个接口都能用；kimi.ai 买的 key 我们还没测过。
- **定时任务、客服 bot**：会员额度只给你在编程工具里交互用，Agent J 不会把这把 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 里的服务商名：kimi.com 的会员是 `kimi-code-plan-cn`，kimi.ai 的会员是 `kimi-code-plan-global`。
- 编程接口：国内 `https://api.kimi.com/coding/v1`，海外 `https://api.kimi.ai/coding/v1`。密钥卡就用这里的模型列表接口做只读核对。
- key 的环境变量名：`KIMI_API_KEY`。用 Kimi Code 时，只有 Kimi 自己没登录，Agent J 才在内存里把这把 key 交给它，不写进 Kimi 的设置文件。

</details>