在 Claude Code 中使用 Kimi

Claude Code 是 Anthropic 提供的编程 Agent 产品，界面、配置项和支持能力可能随版本变化。本文说明一种通用接入方案：通过环境变量将 Claude Code 的模型请求转发到 Kimi API。

安装 Claude Code

已安装的用户可跳过。执行以下命令安装：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

未安装 Node.js？展开安装与初始化

MacOS 和 Linux：

# 安装 nodejs
curl -fsSL https://fnm.vercel.app/install | bash

# 新开一个 terminal，让 fnm 生效
fnm install 24.3.0
fnm default 24.3.0
fnm use 24.3.0

Windows（PowerShell）：

# 右键按 Windows 按钮，点击「终端」，然后依次执行
winget install OpenJS.NodeJS
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

# 关闭终端窗口，新开一个终端窗口

安装 Node.js 后，执行一次初始化配置：

node --eval "
    const fs = require('fs');
    const path = require('path');
    const os = require('os');
    const homeDir = os.homedir();
    const filePath = path.join(homeDir, '.claude.json');
    if (fs.existsSync(filePath)) {
        const content = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
        fs.writeFileSync(filePath, JSON.stringify({ ...content, hasCompletedOnboarding: true }, null, 2), 'utf-8');
    } else {
        fs.writeFileSync(filePath, JSON.stringify({ hasCompletedOnboarding: true }, null, 2), 'utf-8');
    }"

非首次安装：注意清理历史配置和环境变量

如果您之前通过第三方工具或手动修改过 ~/.claude/settings.json，其 env 字段中残留的旧配置会覆盖终端里 export 的同名环境变量，导致新配置不生效或模型请求被静默改写。建议先执行以下脚本清理：

node --eval "
    const fs = require('fs');
    const path = require('path');
    const os = require('os');
    const settingsPath = path.join(os.homedir(), '.claude', 'settings.json');
    if (fs.existsSync(settingsPath)) {
        const content = JSON.parse(fs.readFileSync(settingsPath, 'utf-8'));
        if (content && typeof content === 'object' && content.env && typeof content.env === 'object') {
            for (const key of [
                'ANTHROPIC_BASE_URL',
                'ANTHROPIC_API_KEY',
                'ANTHROPIC_AUTH_TOKEN',
                'ANTHROPIC_MODEL',
                'ANTHROPIC_SMALL_FAST_MODEL',
                'CLAUDE_CODE_SUBAGENT_MODEL',
                'ANTHROPIC_DEFAULT_OPUS_MODEL',
                'ANTHROPIC_DEFAULT_OPUS_MODEL_NAME',
                'ANTHROPIC_DEFAULT_SONNET_MODEL',
                'ANTHROPIC_DEFAULT_SONNET_MODEL_NAME',
                'ANTHROPIC_DEFAULT_HAIKU_MODEL',
                'ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME',
                'ANTHROPIC_DEFAULT_FABLE_MODEL',
                'ANTHROPIC_DEFAULT_FABLE_MODEL_NAME',
                'ENABLE_TOOL_SEARCH',
                'CLAUDE_CODE_AUTO_COMPACT_WINDOW',
                'CLAUDE_CODE_EFFORT_LEVEL',
            ]) {
                delete content.env[key];
            }
            fs.writeFileSync(settingsPath, JSON.stringify(content, null, 2), 'utf-8');
        }
    }"

该脚本仅删除 env 中的端点、密钥与模型相关变量，不影响 settings.json 中的其他配置（如权限、主题等）。另外，请检查 ~/.zshrc、~/.bashrc 等 shell 配置文件中是否残留旧的 ANTHROPIC_* export（Windows 用户请检查用户环境变量），如有请一并删除，否则同样会干扰新配置。

获取 Kimi API Key

访问 Kimi 开放平台创建 API Key（选择 default 默认项目），替换下文中的 YOUR_MOONSHOT_API_KEY。

配置环境变量

以下两种方式 任选其一，不要混用：方式一立即生效但仅对当前终端会话有效；方式二写入配置文件，长期生效。

方式一：终端环境变量（仅当前会话）

MacOS 和 Linux：

export ANTHROPIC_BASE_URL="https://api.moonshot.cn/anthropic"
export ANTHROPIC_AUTH_TOKEN="${YOUR_MOONSHOT_API_KEY}"
export ANTHROPIC_MODEL="kimi-k3[1m]"
export ANTHROPIC_DEFAULT_OPUS_MODEL="kimi-k3[1m]"
export ANTHROPIC_DEFAULT_SONNET_MODEL="kimi-k3[1m]"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="kimi-k3[1m]"
export ANTHROPIC_DEFAULT_FABLE_MODEL="kimi-k3[1m]"
export CLAUDE_CODE_SUBAGENT_MODEL="kimi-k3[1m]"
export ENABLE_TOOL_SEARCH="false"
export CLAUDE_CODE_AUTO_COMPACT_WINDOW="1048576"
export CLAUDE_CODE_EFFORT_LEVEL="max"
claude

Windows（PowerShell）：

$env:ANTHROPIC_BASE_URL="https://api.moonshot.cn/anthropic";
$env:ANTHROPIC_AUTH_TOKEN="YOUR_MOONSHOT_API_KEY"
$env:ANTHROPIC_MODEL="kimi-k3[1m]"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="kimi-k3[1m]"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="kimi-k3[1m]"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="kimi-k3[1m]"
$env:ANTHROPIC_DEFAULT_FABLE_MODEL="kimi-k3[1m]"
$env:CLAUDE_CODE_SUBAGENT_MODEL="kimi-k3[1m]"
$env:ENABLE_TOOL_SEARCH="false"
$env:CLAUDE_CODE_AUTO_COMPACT_WINDOW="1048576"
$env:CLAUDE_CODE_EFFORT_LEVEL="max"
claude

方式二：写入 settings.json（长期生效）

将同样的变量写入 ~/.claude/settings.json 的 env 字段：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.moonshot.cn/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_MOONSHOT_API_KEY",
    "ANTHROPIC_MODEL": "kimi-k3[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "kimi-k3[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "kimi-k3[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "kimi-k3[1m]",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "kimi-k3[1m]",
    "CLAUDE_CODE_SUBAGENT_MODEL": "kimi-k3[1m]",
    "ENABLE_TOOL_SEARCH": "false",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1048576",
    "CLAUDE_CODE_EFFORT_LEVEL": "max"
  }
}

注意：settings.json 的 env 会覆盖终端里 export 的同名变量；该文件包含明文 API Key，请勿提交到 git 仓库；保存后需重启 Claude Code 生效。

配置项说明

Claude Code 内部会按场景使用不同档位的模型（主对话、后台摘要、子 Agent 等），只配置部分变量会让对应场景静默失败：

变量	作用	不配置或配置错误的影响
`ANTHROPIC_BASE_URL`	将模型请求转发到 Kimi 的 Anthropic 兼容端点	请求被发往 Anthropic 官方端点，鉴权失败
`ANTHROPIC_AUTH_TOKEN`	使用 Kimi API Key 鉴权	返回 401 鉴权错误
`ANTHROPIC_MODEL`	主对话使用的模型	使用 Claude 默认模型名，Kimi 端点无法识别，报模型不存在错误
`ANTHROPIC_DEFAULT_OPUS_MODEL` / `ANTHROPIC_DEFAULT_SONNET_MODEL` / `ANTHROPIC_DEFAULT_HAIKU_MODEL` / `ANTHROPIC_DEFAULT_FABLE_MODEL`	Claude Code 按任务档位选择模型时使用的模型名	对应档位的任务（如 haiku 档的后台标题生成、摘要）请求失败
`CLAUDE_CODE_SUBAGENT_MODEL`	子 Agent 使用的模型	子任务请求失败或效果明显变差
`ENABLE_TOOL_SEARCH`	Claude Code 的 Tool Search 特性开关	Kimi 端点暂不支持该特性，必须设为 `false`，否则工具调用异常
`CLAUDE_CODE_AUTO_COMPACT_WINDOW`	触发自动压缩上下文的窗口大小	需与模型上下文一致：`kimi-k3` 为 1M（`1048576`），`kimi-k2.7-code` 为 256K（`262144`）；设置过小会过早压缩丢失上下文，过大则报上下文超限错误
`CLAUDE_CODE_EFFORT_LEVEL`	控制 Claude Code 的推理努力程度	设为 `max` 以获得最充分的推理；较低值可能在复杂任务上降低质量

模型与思考行为

三个模型在 Claude Code 中的实际行为差异（均经 anthropic 兼容端点实测）：

模型	思考行为	使用要点
`kimi-k3`（本页默认）	默认开启思考	开箱即用，无需额外配置
`kimi-k2.7-code`	始终开启思考	请求必须显式开启思考，请在 Claude Code 中保持 Thinking on（按 `Tab`）使用；未开启时请求会被拒绝（`invalid thinking: only type=enabled is allowed for this model`）
`kimi-k2.6`	思考可选	可关闭思考使用，适合对延迟敏感的简单任务

切换模型时，请把配置中所有模型变量的值一并替换为新模型名。

确认配置是否生效

在 Claude Code 中输入 /status 确认配置状态：

Base URL 应显示为 https://api.moonshot.cn/anthropic
Model 应显示为 kimi-k3[1m]

Claude Code 的 /model 菜单是内置的固定别名列表，不会显示 Kimi 模型，也无需在其中切换——配置是否生效以 /status 显示为准。

最后随便发送一条消息（例如 hi），能正常收到回复即说明端到端配置成功。

开启 Thinking

kimi-k3 默认开启思考，开箱即用。如果你切换为 kimi-k2.7-code，它要求请求显式开启思考：请在 Claude Code 中按 Tab 开启 Thinking on，看到 “Thinking on” 标识后再开始使用，否则模型会拒绝请求（400 invalid thinking），WebSearch 等功能也无法使用。

接下来就可以正常使用 Claude Code 进行开发了！

切换高速版模型

Kimi K2.7 Code 提供高速版 kimi-k2.7-code-highspeed，输出速度约为普通版的 5-6 倍。追求输出速度时，可将配置中所有模型变量的值改为 kimi-k2.7-code-highspeed（注意它要求显式开启思考，见「模型与思考行为」），价格详见 K2.7 Code 模型价格。

第三方工具：cc-switch

cc-switch 等社区工具可以在多套供应商配置之间切换。这类工具并非 Kimi 官方维护，其预设配置可能与本页推荐值存在差异，使用后请对照「配置项说明」逐一核对各变量取值，并用 /status 确认实际生效的 Base URL 与模型。

常见问题

WebSearch 报 400 invalid thinking / WebFetch 不可用

WebSearch 报 400 invalid thinking: only type=enabled is allowed for this model：kimi-k2.7-code 强制思考开启，WebSearch 请求未显式开启思考时被平台拒绝。请先按 Tab 开启 Thinking on 再使用；仍不行可切换到 kimi-k2.6（思考可选，不受该限制）。kimi-k3 无此限制。此问题与本地配置和 cc-switch 无关。
WebFetch 报 temporarily unavailable 或无抓取结果：当前端点暂不支持 WebFetch 抓取，与配置无关，待平台支持后恢复。临时可改为把网页内容粘贴给模型，或使用 MCP 抓取类工具替代。

返回 401 鉴权错误

检查 ANTHROPIC_AUTH_TOKEN 是否为有效的 Kimi API Key；如果您之前配置过 ANTHROPIC_API_KEY，请将其删除，避免与 ANTHROPIC_AUTH_TOKEN 同时存在导致冲突。

提示模型不存在（model not found）

检查各模型变量的值是否拼写正确（kimi-k3[1m]），注意不要携带多余空格或引号。

后台任务或子 Agent 报错

通常是 ANTHROPIC_DEFAULT_HAIKU_MODEL、ANTHROPIC_DEFAULT_FABLE_MODEL 或 CLAUDE_CODE_SUBAGENT_MODEL 未配置，对应场景请求了 Kimi 端点无法识别的模型名，请对照「配置项说明」补齐。

修改配置后不生效

检查 ~/.claude/settings.json 的 env 中是否有残留旧配置（会覆盖终端环境变量），可执行上文折叠块中的清理脚本；
终端中 export 的变量只对当前会话有效，重开终端后需要重新设置；如果写入了 ~/.zshrc 或使用了 settings.json 方式，请确认修改后重启了 Claude Code。

API Key 与端点不匹配

请确认 ANTHROPIC_BASE_URL 与您创建 API Key 的平台一致，即在上文「获取 Kimi API Key」链接对应的平台创建 Key 并使用本页给出的端点。

开始使用

模型能力

工具调用

核心工作流

生态集成

调试与运维

安装 Claude Code

获取 Kimi API Key

配置环境变量

方式一：终端环境变量（仅当前会话）

方式二：写入 settings.json（长期生效）

配置项说明

模型与思考行为

确认配置是否生效

开启 Thinking

切换高速版模型

第三方工具：cc-switch

常见问题

​安装 Claude Code

​获取 Kimi API Key

​配置环境变量

​方式一：终端环境变量（仅当前会话）

​方式二：写入 settings.json（长期生效）

​配置项说明

​模型与思考行为

​确认配置是否生效

​开启 Thinking

​切换高速版模型

​第三方工具：cc-switch

​常见问题

安装 Claude Code

获取 Kimi API Key

配置环境变量

方式一：终端环境变量（仅当前会话）

方式二：写入 settings.json（长期生效）

配置项说明

模型与思考行为

确认配置是否生效

开启 Thinking

切换高速版模型

第三方工具：cc-switch

常见问题