> ## Documentation Index
> Fetch the complete documentation index at: https://platform.kimi.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 在 Claude Code 中使用 Kimi

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

## 安装 Claude Code

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

```shell theme={null}
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
```

<Accordion title="未安装 Node.js？展开安装与初始化">
  MacOS 和 Linux：

  ```shell theme={null}
  # 安装 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）：

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

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

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

  ```shell theme={null}
  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');
      }"
  ```
</Accordion>

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

  ```shell theme={null}
  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 用户请检查用户环境变量），如有请一并删除，否则同样会干扰新配置。
</Accordion>

## 获取 Kimi API Key

访问 [Kimi 开放平台](https://platform.kimi.com/console/api-keys) 创建 API Key（选择 default 默认项目），替换下文中的 `YOUR_MOONSHOT_API_KEY`。

## 配置环境变量

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

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

MacOS 和 Linux：

```shell theme={null}
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）：

```powershell theme={null}
$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` 字段：

```json theme={null}
{
  "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` 显示为准。

<img src="https://mintcdn.com/moonshotcn/3bxMseHtiQ3oOhqL/assets/pics/cline/status.png?fit=max&auto=format&n=3bxMseHtiQ3oOhqL&q=85&s=1de57645ad426aeb96b7fe07244ba26a" alt="status" width="1138" height="458" data-path="assets/pics/cline/status.png" />

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

## 开启 Thinking

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

<img src="https://mintcdn.com/moonshotcn/3bxMseHtiQ3oOhqL/assets/pics/cline/thinking-on.png?fit=max&auto=format&n=3bxMseHtiQ3oOhqL&q=85&s=ef220742b77881d47cb48acba8ef1813" alt="thinking-on" width="1140" height="656" data-path="assets/pics/cline/thinking-on.png" />

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

## 切换高速版模型

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

## 第三方工具：cc-switch

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

## 常见问题

<AccordionGroup>
  <Accordion title="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 抓取类工具替代。
  </Accordion>

  <Accordion title="返回 401 鉴权错误">
    检查 `ANTHROPIC_AUTH_TOKEN` 是否为有效的 Kimi API Key；如果您之前配置过 `ANTHROPIC_API_KEY`，请将其删除，避免与 `ANTHROPIC_AUTH_TOKEN` 同时存在导致冲突。
  </Accordion>

  <Accordion title="提示模型不存在（model not found）">
    检查各模型变量的值是否拼写正确（`kimi-k3[1m]`），注意不要携带多余空格或引号。
  </Accordion>

  <Accordion title="后台任务或子 Agent 报错">
    通常是 `ANTHROPIC_DEFAULT_HAIKU_MODEL`、`ANTHROPIC_DEFAULT_FABLE_MODEL` 或 `CLAUDE_CODE_SUBAGENT_MODEL` 未配置，对应场景请求了 Kimi 端点无法识别的模型名，请对照「配置项说明」补齐。
  </Accordion>

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

  <Accordion title="API Key 与端点不匹配">
    请确认 `ANTHROPIC_BASE_URL` 与您创建 API Key 的平台一致，即在上文「获取 Kimi API Key」链接对应的平台创建 Key 并使用本页给出的端点。
  </Accordion>

  <Accordion title="之前通过 /login 登录过 Claude 账号">
    `ANTHROPIC_AUTH_TOKEN` 设置后会优先于已保存的登录态生效，一般无需处理。可在会话中输入 `/status` 确认当前生效的凭据来源；如需清除已保存的登录，可执行 `/logout`。
  </Accordion>
</AccordionGroup>