Kimi K2.7 Code：Claude Code 官方接入配置与多层级模型映射

一句话结论

在 Claude Code 中通过环境变量或 settings.json 将请求转发至 Kimi Anthropic 兼容端点，必须显式开启 Thinking（Tab 键）、将自动压缩窗口配置为 256K（262144），并完整映射 Opus/Sonnet/Haiku/Fable/Subagent 各分层模型别名。

适用场景

• 适合的任务：在 Claude Code 终端 Agent 中使用 Kimi K2.7 Code 进行仓库级代码编写、重构、测试与子 Agent 协同。

• 不适合的任务：要求关闭思维链的快速单轮生成、上下文超过 256K 的超大单次加载、缺少 Haiku/Subagent 变量的部分配置场景。

• 适用的模型版本：kimi-k2.7-code（标准版）、kimi-k2.7-code-highspeed（高速版，约 180~260 tokens/s）。

• 适用的客户端、Agent 或 API：@anthropic-ai/claude-code 终端 CLI、Kimi Anthropic 兼容 API 端点（https://api.moonshot.ai/anthropic）。

• 推荐的推理档位和参数：CLAUDE_CODE_EFFORT_LEVEL="max"，CLAUDE_CODE_AUTO_COMPACT_WINDOW="262144"，Thinking 必须保持开启。

可直接使用的内容

方式一：终端环境变量（当前 Session 生效）

macOS / Linux (bash/zsh)

export ANTHROPIC_BASE_URL="https://api.moonshot.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="YOUR_MOONSHOT_API_KEY"
export ANTHROPIC_MODEL="kimi-k2.7-code"
export ANTHROPIC_DEFAULT_OPUS_MODEL="kimi-k2.7-code"
export ANTHROPIC_DEFAULT_SONNET_MODEL="kimi-k2.7-code"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="kimi-k2.7-code"
export ANTHROPIC_DEFAULT_FABLE_MODEL="kimi-k2.7-code"
export CLAUDE_CODE_SUBAGENT_MODEL="kimi-k2.7-code"
export CLAUDE_CODE_AUTO_COMPACT_WINDOW="262144"
export CLAUDE_CODE_EFFORT_LEVEL="max"
claude

Windows (PowerShell)

$env:ANTHROPIC_BASE_URL="https://api.moonshot.ai/anthropic";
$env:ANTHROPIC_AUTH_TOKEN="YOUR_MOONSHOT_API_KEY";
$env:ANTHROPIC_MODEL="kimi-k2.7-code";
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="kimi-k2.7-code";
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="kimi-k2.7-code";
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="kimi-k2.7-code";
$env:ANTHROPIC_DEFAULT_FABLE_MODEL="kimi-k2.7-code";
$env:CLAUDE_CODE_SUBAGENT_MODEL="kimi-k2.7-code";
$env:CLAUDE_CODE_AUTO_COMPACT_WINDOW="262144";
$env:CLAUDE_CODE_EFFORT_LEVEL="max";
claude

方式二：持久化配置（写入 ~/.claude/settings.json）

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.moonshot.ai/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_MOONSHOT_API_KEY",
    "ANTHROPIC_MODEL": "kimi-k2.7-code",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "kimi-k2.7-code",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "kimi-k2.7-code",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "kimi-k2.7-code",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "kimi-k2.7-code",
    "CLAUDE_CODE_SUBAGENT_MODEL": "kimi-k2.7-code",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "262144",
    "CLAUDE_CODE_EFFORT_LEVEL": "max"
  }
}

若需切换为高速版，将上述全部模型字段中的 kimi-k2.7-code 替换为 kimi-k2.7-code-highspeed 即可。

测试/工作流步骤

1. 安装 Claude Code：执行 npm install -g @anthropic-ai/claude-code。

2. 获取 API Key：登录 Kimi 开放平台（platform.kimi.ai）创建 API Key。

3. 写入配置：选择上述环境变量或 settings.json 方式，填入真实 API Key 与全部环境变量。

4. 启动并验证状态：在项目根目录运行 claude，输入 /status 检查：

   • Base URL 显示为 https://api.moonshot.ai/anthropic

   • Model 显示为 kimi-k2.7-code（或 highspeed 版本）

5. 显式开启 Thinking：按 Tab 键确保出现 “Thinking on” 指示器。若 Thinking 处于关闭状态，K2.7 会直接抛出 400 错误。

6. 运行首轮测试：输入简单指令（如 总结当前项目结构并检查 package.json）验证工具调用与输出正常。

原始证据与数据

官方文档列出的核心参数与映射机制：

• 分层模型依赖：Claude Code 在后台任务（如标题生成、上下文摘要使用 Haiku 层，复杂推理使用 Opus/Sonnet 层，并发任务使用 Subagent）。若未完整设置 ANTHROPIC_DEFAULT_* 变量，后台任务会回退到 Anthropic 官方模型名并触发 404 或鉴权错误。

• 上下文压缩窗口：Kimi K2.7 Code 上下文为 256K（262,144 tokens）。若设置为 1M（1,048,576，如 K3），会导致上下文溢出报错；若设置过小，会过早触发压缩导致信息丢失。

• 思考模式强制性：Kimi K2.7 Code 接口强制 thinking={"type": "enabled"}，未开启时请求被拒绝（400 invalid thinking: only type=enabled is allowed for this model），且 WebSearch / WebFetch 功能依赖思考模式正常运行。

适用边界

• 该接入方式依赖 Kimi 官方提供的 Anthropic 协议兼容层；第三方代理若未完整实现 Anthropic Tools / Thinking 协议可能存在格式转换失败。

• ~/.claude/settings.json 优先级高于终端环境变量，且会明文保存 API Key，切勿提交至公开 Git 仓库。

• Claude Code 的 /model 菜单为内置固定别名列表，不会显示 Kimi 模型名称，配置是否生效必须通过 /status 验证。

来源摘录或观察（仅做合规短引）

• 官方文档明确说明：“K2.7-code requires requests to explicitly enable thinking: press Tab in Claude Code to turn Thinking on... otherwise the model rejects requests (400 invalid thinking).”

• 官方指引强调：“Claude Code uses different model tiers for different scenarios... Configuring only some of the variables makes the corresponding scenarios fail silently.”