Deepseek ArtifactsDeepseek Artifacts
Kimi K3 · Claude Code 实操指南

Kimi K3 接入 Claude Code：完整配置指南

月之暗面提供了 Anthropic 兼容端点，只需一个 settings.json 环境变量块，Claude Code 就能跑在 Kimi K3 上。下文每个配置值均逐字核对自 Kimi 官方文档，八张截图完整记录了一次真实的 K3 会话——从第一句提示词到验证通过、可以直接运行的游戏。

开始图文教程查看常见问题

太长不看：Kimi K3 跑进 Claude Code

  • 月之暗面的 Messages API 兼容 Anthropic：把 ANTHROPIC_BASE_URL 指向 https://api.moonshot.ai/anthropic，把 Kimi API 密钥填进 ANTHROPIC_AUTH_TOKEN，Claude Code 的所有功能原样保留，动脑的换成 Kimi K3。
  • 官方 settings.json 把所有模型档位映射到 kimi-k3[1m]（百万上下文版本），Haiku 档位用 kimi-k2.7-code，并设置 CLAUDE_CODE_AUTO_COMPACT_WINDOW 为 1000000、CLAUDE_CODE_EFFORT_LEVEL 为 max。
  • 两种验证方式：运行 /status 检查 Base URL 和 kimi-k3[1m] 模型名，或者直接看启动横幅——演示视频里写着 Using kimi-k3 (from .claude/settings.json)。
  • K3 在 Kimi 开放平台按量计费：输入 $3/百万 token，输出 $15/百万 token，缓存命中输入 $0.30/百万 token，上下文 1M。模型本身是 2.8T 参数的 MoE（激活 104B），思考模式常开。

Kimi K3 + Claude Code Demo

视频演示:Data Science in your pocket8:11

打开

Use Kimi in Claude Code — official guide

产品事实:platform.kimi.aiKimi API Platform docs

打开

步骤 1-4（安装、API 密钥、环境变量块、curl 验证）依据 Kimi 官方文档撰写，因为目前不存在无遮挡的配置过程录屏——YouTube 上每支相关教程都带着摄像头画面。步骤 5-12 的截图来自一支纯终端录屏：Claude Code v2.1.207 跑在 kimi-k3 上。

截图均来自来源视频并署名，每张图深链到对应时间戳。本文文字为原创，并非字幕搬运。

Kimi K3 接入 Claude Code，逐步图解

1 · 把 Claude Code 指向 Kimi K3

  1. 1

    安装 Claude Code

    用 Anthropic 官方安装脚本：macOS 和 Linux 执行 curl -fsSL https://claude.ai/install.sh | bash，Windows PowerShell 执行 irm https://claude.ai/install.ps1 | iex。npm 方式也可行：npm install -g @anthropic-ai/claude-code 需要 Node.js 22 及以上。已经装过？直接跳过——但如果之前有第三方工具改过 ~/.claude/settings.json，先清掉 env 字段里残留的 ANTHROPIC_* 键，这些旧值会悄悄覆盖你在终端里导出的一切。

  2. 2

    创建 Kimi API 密钥

    登录 platform.kimi.ai，打开控制台，在 API Keys 下创建密钥。K3 需要充值成功后才会解锁，门槛是 $1——一块钱就够跑完整个教程。注意这是按量计费的 Kimi 开放平台：Kimi Code 或 Kimi 会员是另外的产品，不提供本教程所需的 API 密钥。

  3. 3

    把环境变量块写进 ~/.claude/settings.json

    打开（或新建）~/.claude/settings.json，严格按官方文档填写 env 字段：ANTHROPIC_BASE_URL 设为 https://api.moonshot.ai/anthropic，ANTHROPIC_AUTH_TOKEN 填 Kimi 密钥，ANTHROPIC_MODEL 连同 OPUS、SONNET、FABLE 档位和 CLAUDE_CODE_SUBAGENT_MODEL 全部设为 kimi-k3[1m]，ANTHROPIC_DEFAULT_HAIKU_MODEL 设为 kimi-k2.7-code，CLAUDE_CODE_AUTO_COMPACT_WINDOW 设为 1000000，CLAUDE_CODE_EFFORT_LEVEL 设为 max。每个档位都要映射：Claude Code 会用这些别名发起后台和子代理请求，缺一个就静默失败。env 块会覆盖终端导出的同名变量，而且密钥以明文保存——千万别提交到 git。

  4. 4

    先用 curl 验证端点和密钥

    启动 Claude Code 之前，先直连 Anthropic 兼容路由发一个单 token 请求：curl https://api.moonshot.ai/anthropic/v1/messages，Authorization: Bearer 头带 Kimi 密钥，请求体写 model 为 kimi-k3、max_tokens 为 1。返回正常 JSON 说明端点和凭证都没问题。返回 401 则说明密钥无效、Base URL 与签发密钥的平台不匹配，或者残留的 ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN 冲突——删掉它。

2 · 启动并确认 K3 在干活

  1. 5

    启动 claude，读懂横幅

    在项目目录里运行 claude。横幅说明一切：演示中是 Claude Code v2.1.207，接着是 kimi-k3 · API Usage Billing，然后是关键一行——Using kimi-k3 (from .claude\settings.json) · /model。这就是 env 块生效的标志；项目级的 .claude/settings.json 效果相同。如果横幅还显示 Claude 或 Anthropic 的计费信息，回到第 3 步检查并重启 Claude Code。

    Claude Code v2.1.207 startup banner showing kimi-k3 with API Usage Billing and the line Using kimi-k3 (from .claude\settings.json), proof that the settings.json env block is routing Claude Code to Kimi K3
    启动横幅写明 kimi-k3，以及它来自哪个 settings.json。看视频 0:22
  2. 6

    派一个真实任务，别问它是谁

    演示的开场提示词是 help me develop a game called snake and ladders.——一个具体、可构建的需求。K3 先思考再回答：Thought for 16s，然后回复开始流式输出，状态栏同时计数 Channeling… 25s · ↓1.0k tokens。别用「你是什么模型」来试探：配置把 Claude 的别名映射到了 Kimi 的模型 ID，自我介绍说明不了任何问题——/status 和启动横幅才是证据。

    Claude Code terminal with the prompt help me develop a game called snake and ladders answered after Thought for 16s while the Channeling status counts 25 seconds and 1.0k tokens on Kimi K3
    第一句提示词已提交，K3 开始思考——token 计数器跑起来了。看视频 1:42
  3. 7

    回答澄清问题

    K3 不靠猜。界面弹出带标签页的选择器——Platform、Players、Rules、Submit——给出 Web（HTML/CSS/JS）、Python console、Python + pygame 或自行输入等选项，每个选项下还有说明。Enter 选中，Tab 和方向键切换，Esc 取消。这种开局就把需求问清的结构化提问，正是成品一次通过、不用返工的一半原因。

    Claude Code clarifying question What platform should the game run on with Web HTML/CSS/JS, Python console and Python + pygame options where Enter selects and Tab with arrow keys navigate, the structured answers Kimi K3 requests before writing code
    带标签页的提问界面：Enter 选中，Tab 和方向键切换，Esc 取消。看视频 2:04

3 · 一句话，一个游戏：K3 的工作循环

  1. 8

    核对并提交答案

    真正动工之前，Claude Code 会显示 Review your answers 复核页：Platform、Players、Rules 三个标签全部打勾——演示中是 Python + pygame、1 player vs computer、Classic——Submit answers 作为高亮选项待命。一次 Enter 之后，代理就拿到了完整规格。这一步务必认真核对：整个计划正是从这些选项构建的。

    Claude Code Review your answers screen listing Python + pygame, 1 player vs computer and Classic in green with Submit answers highlighted as the first option, the confirmation step before Kimi K3 starts building
    Platform、Players、Rules 全部打勾——Submit answers 只差一次回车。看视频 2:12
  2. 9

    读计划，让它自行补齐依赖

    计划以可验证的步骤呈现：检查环境并确认 Python + pygame；编写游戏并确认可编译；无头冒烟测试逻辑与渲染，让模拟对局都在恰好到达 100 格时结束。它检测到 Python 3.13、发现 pygame 缺失，然后自行运行 python -m pip install pygame。注意思考时长——单次长达 4 分 53 秒——这正是 CLAUDE_CODE_EFFORT_LEVEL=max 在起作用；K3 默认就是最大推理强度。

    Kimi K3 plan inside Claude Code listing check environment, write snake_and_ladders.py and smoke-test headlessly, then running python -m pip install pygame after detecting Python 3.13 without pygame
    三段式计划，以及在 Python 3.13 上自动安装 pygame。看视频 3:42
  3. 10

    批准写入，看编译检查

    K3 写出 snake_and_ladders.py——演示中 279 行——然后自检：先做编译检查（python -m py_compile … && echo "compile OK"），再跑无头冒烟测试，渲染每个元素并模拟数千局完整游戏。底部状态栏显示 accept edits on（shift+tab to cycle），这种权限模式让文件写入不必逐个确认。写入被拒也能恢复——演示里就误触了一次拒绝，代理重新尝试后照常完成。

    Claude Code reporting Wrote 279 lines to snake_and_ladders.py and then verifying with a python -m py_compile compile check and a headless smoke test that simulates thousands of full games, all under accept edits on
    写入 279 行，随后在 accept edits on 下执行 python -m py_compile。看视频 6:05

4 · 验证过、能直接运行

  1. 11

    读验证清单

    All checks pass. The game is done and verified——而且 Claude Code 列出了证据：编译 ✓；渲染——棋盘、蛇、梯子、骰子全部可绘制 ✓；棋盘映射——第 1 格在左下、蛇形排列到第 100 格 ✓；规则——超步作废、恰好到达 100 格才算赢 ✓；2000 局模拟全部在胜者到达 100 格时正常结束 ✓。下方打印运行命令和成果摘要。这个习惯值得学会：永远不要直接相信代码，跑模拟验证它。

    Claude Code verification checklist reading All checks pass with compile, rendering, board mapping, rules and 2000 simulated games ticked, above the Run it command python C:\Users\datas\snake_and_ladders\snake_and_ladders.py
    编译、渲染、棋盘映射、规则、2000 局模拟——全部通过。看视频 6:55
  2. 12

    运行它

    执行打印出来的命令——演示中是 python C:\Users\datas\snake_and_ladders\snake_and_ladders.py——游戏窗口随即打开：10x10 棋盘上绿色波浪蛇和棕色梯子，SNAKES & LADDERS 侧栏带回合指示、骰子和绿色 Roll 按钮。空格或点击掷骰，R 重开，Esc 退出。从一句话到可玩、且自验证过的游戏，K3 用了约十分钟。

    Snake and Ladders pygame window with a 10x10 board of green snakes and brown ladders beside a SNAKES & LADDERS panel showing Turn You, a dice face and a green Roll button, the game Kimi K3 built end to end in Claude Code
    完成的 Snakes & Ladders 窗口，用 K3 打印的命令启动。看视频 7:35

Kimi K3 + Claude Code 常见问题

继续探索

GLM Coding Plan 指南Claude Code Router 教程在 Cursor 中使用 DeepSeekDeepSeek 接入 Cline 教程全部攻略