Kimi API Key 怎么获取和配置：4 个接入点的操作与验证

木木夕技术创作者 2026-11-03 142 阅读

拿到 Kimi 的 API Key 只是第一步，真正卡住多数人的是把 Key 填进错的位置——环境变量、配置文件、还是工具内置认证，三者互不通用。截至 2026-11 抓取时，Kimi 开放平台文档导航里已经换成 Kimi K3.1 Pro、Kimi K3、Kimi K2.7 Code、Kimi K2.6 四个系列，K3.1 Pro 高速版也已上线（官方首页横幅与 llms.txt 索引均已列出），旧配置里手写的模型名需要跟着改。本篇按官方《快速开始》走一遍全流程，再把 Codex、Claude Code、OpenCode、kha CLI 这 4 个接入点各自的填法拆开对照。

标注规则：下文凡写「我的推断」「我的判断」处，都是我根据官方原文推出来的，不是官方结论；其余数字、路径、命令均出自官方文档原文。

动手前的 3 项准备

账号：注册并登录 Kimi API 开放平台控制台，浏览器打开 https://platform.moonshot.cn/docs/ 顶部导航「开始使用 → 快速开始」，页面右上「登录开放平台」入口可确认登录状态；官方 kha CLI 指南也把「注册 Kimi 开放平台账号」列为第 1 步。
余额：官方 OpenCode 指南写明，Kimi K3 需要账户有可用余额，且新用户认证赠送的代金券不能用于 Kimi K3。如果你只打算调 K3.1 Pro 之外的模型，仍需确认账户余额为正，否则第一次调用就会被拒。
IP 白名单（仅组织账号需要）：若你的组织在控制台启用了 IP 白名单，按官方《使用控制台进行组织管理》添加调用机器的出口 IPv4；个人账号跳过这一步。

第 1 步：登录控制台创建 API Key

登录后进入开放平台的 API Keys 页面（控制台 → API Keys）创建并复制密钥。官方原文的建议是：妥善保管 API Key，不要泄露他人，不要直接硬编码在代码中，改用环境变量保存。

复制后立刻离开这个页面——API Key 只在创建/复制时可见，官方控制台的「创建、复制和管理用于 API 调用的密钥」说明页把它定位为控制台侧的唯一入口。

第 2 步：把 Key 写进环境变量

官方快速开始给的就是这一个变量名，写错变量名是「明明复制了 Key 却说没鉴权」的常见原因：

export MOONSHOT_API_KEY="你的_KIMI_API_KEY"

注意两点：变量名是 MOONSHOT_API_KEY（官方示例注释里写的是 你的_KIMI_API_KEY，注释和变量名不一致，别照抄注释里的拼法）；等号两侧不能有空格——bash 里 export A = B 会被当成非法标识符，必须写成 export A=B。如果你走的是 kha CLI 这条线，官方托管智能体快速开始用的是另一个变量名 KIMI_API_KEY：

export KIMI_API_KEY="你的_KIMI_API_KEY"

这是官方两个文档里真实存在的差异，不是笔误：直连模型推理 API 用 MOONSHOT_API_KEY，kha CLI 用 KIMI_API_KEY。

第 3 步：选模型与调用格式

base_url 固定为 https://api.moonshot.cn/v1，官方 Python / Node.js / cURL 三个示例里都是这个值。调用格式按你的技术栈选：

调用方式	兼容格式	适合谁
Chat Completions API	OpenAI 格式	有 OpenAI SDK 或任意 HTTP 客户端
Responses API	OpenAI 格式	要生成文本/JSON 或调函数工具
Messages API	Anthropic 格式	Claude Code 这类 Anthropic 生态工具

模型名以官方当前列表为准，llms.txt 索引中在售的是 kimi-k3.1-pro、kimi-k3、kimi-k2.7-code、kimi-k2.6。官方快速开始推荐优先用 kimi-k3.1-pro：3 万亿级参数、1M token 上下文；追求输出速度则选高速版 kimi-k3.1-pro-highspeed，官方描述为「能力相同、约为 2～3 倍速度」。

K3.1 Pro 用请求顶层的 reasoning_effort 调推理强度，支持 low / high / max，默认 max。换模型时要同时替换 model 字段并按模型支持情况调整参数。

第 4 步：发一次请求并验证

官方 cURL 示例可直接复制运行（模型名按上一步替换）：

curl https://api.moonshot.cn/v1/chat/completions 
  -H "Content-Type: application/json" 
  -H "Authorization: Bearer $MOONSHOT_API_KEY" 
  -d '{
    "model": "kimi-k3.1-pro",
    "messages": [
      {"role": "user", "content": "你好，我叫李雷，1+1等于多少？"}
    ]
  }'

如果走 SDK，官方给出的依赖条件是 Python 3.9+ 或 Node.js 18+，OpenAI SDK 1.0.0 及以上：

pip install --upgrade 'openai>=1.0'   # Python
npm install openai@latest             # Node.js

算成功的标志：命令无报错，输出里出现模型回复文本，官方示例给的是「你好，李雷！1+1 等于 2……」，官方也提示实际回复内容不会完全一致，所以看的是「有回复、无鉴权报错」，不是逐字比对。

填进工具里：4 个接入点的差异

接入点	Key 放哪	关键操作	验证方式
Codex	环境变量 `KIMI_API_KEY`（不要写进 config.toml）	编辑 `~/.codex/config.toml` 指定供应商与模型	桌面端重启后模型选 `kimi-k3.1-pro`；CLI 里发「你好」收到回复
Claude Code	Claude Code 的 Anthropic 兼容配置	走 Messages API 接入并选模型	官方《在 Claude Code 中使用 Kimi》含模型选择与配置验证步骤
OpenCode	工具内置凭据库	`opencode auth login` → 选 `Moonshot AI (China)` → 粘贴 Key	输入框执行 `/models` 选 Kimi K3，底部状态栏显示 Kimi K3、Moonshot AI (China)、max
kha CLI	终端粘贴，无回显	`kha login` 后粘贴 Key 回车	登录完成即完成凭据写入

Codex 的两步配置（官方指南原文结构）：

第一步用环境变量给 Key（避免写进文件与命令历史）：

# macOS / Linux（read -s 输入不回显）
read -s KIMI_API_KEY && export KIMI_API_KEY
# Windows PowerShell
$env:KIMI_API_KEY="你的 Kimi API Key"

第二步编辑 ~/.codex/config.toml（Windows 为 %USERPROFILE%.codexconfig.toml）：

model = "kimi-k3.1-pro"
model_provider = "kimi"
model_context_window = 1048576

[model_providers.kimi]
name = "Kimi"
base_url = "https://api.moonshot.cn/v1"
env_key = "KIMI_API_KEY"
wire_api = "responses"

wire_api = "responses" 是直连的关键——Kimi 原生支持 Codex 用的 Responses API，无需协议转换或本地代理。逐项验证：桌面端退出重开（重新读配置）→ 模型选择器选 kimi-k3.1-pro（界面可能显示“自定义”，实际请求仍走你配置的模型）→ 发「你是谁」收到回复；CLI 端 codex 启动后确认当前模型为 kimi-k3.1-pro，发「你好」收到回复即连通（底层打到 POST https://api.moonshot.cn/v1/responses）。

Claude Code 走 Anthropic 兼容端点（官方指南），两个环境变量缺一不可：

export ANTHROPIC_BASE_URL="https://api.moonshot.cn/anthropic"
export ANTHROPIC_AUTH_TOKEN="你的 Kimi API Key"

验证：启动 Claude Code 后打开 /model 菜单，能看到已配置的模型即成功；两个变量配错的典型症状官方也写了——BASE_URL 错会把请求发向 Anthropic 官方端点导致鉴权失败，TOKEN 错则直接返回 401。

OpenCode 一路最需要逐步照做，官方完整命令是：

$ opencode auth login
┌  Add credential
│
◆  Select provider
│  Search: Moon█ (2 matches)
│  ● Moonshot AI (China)

选完后粘贴 Key，注意这个输入不回显。官方同时提醒：不要把 API Key 写入配置文件、截图或 Git 仓库。

kha CLI 的安装与登录（官方托管智能体快速开始原文）：

curl -fsSL https://ha-static.moonshot.cn/kha/install.sh | sh
export PATH="$HOME/.local/bin:$PATH"
kha login

常见卡点与延伸

钱不够：官方 OpenCode 指南明确写「Kimi K3 需要账户有可用余额；新用户认证赠送的代金券不能用于 Kimi K3」。看到这类失败，先去控制台看余额与券状态；这是我的判断——文档没有针对该情形的专门报错页，只能靠账户状态自查。

Key 串站：官方 OpenCode 指南原文写着「中国区、国际站使用不同的 API Key，请勿混用」。中国区与国际站各自有独立的 API Key，混用会被拒；OpenCode 的 provider 列表里 Moonshot AI (China) 是中国区入口，选错分支后面所有请求都过不去。

组织开了 IP 白名单：官方要求在控制台把调用机器的出口 IPv4 加进白名单，否则请求被拒；云主机尤其容易漏加。

工具版本漂移：OpenCode 指南基于 OpenCode 1.18.3，官方注明界面、配置项与支持能力可能随版本变化；找不到 /models 时先执行 opencode --version 确认版本。

延伸阅读：完整文档索引在 https://platform.moonshot.cn/docs/llms.txt ，一文列出全部页面；模型参数细节见 https://platform.moonshot.cn/docs/guide/kimi-k3-1-pro-quickstart ；中英文两版 OpenCode 接入指南分别在 https://platform.kimi.com/docs/guide/open-code 与 https://platform.kimi.ai/docs/guide/open-code ，对照阅读能看清中国区与国际站在鉴权上的差异。

参考来源

# AI # 知识

评论区

0 条评论

登录后可评论。