Claude Code

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

开始之前

确保你已经订阅 Kimi 会员并开通 Kimi Code 权益。
获取 API Key：
1. 进入 Kimi Code 控制台；
2. 点击「新建 API Key」，输入名称后确认；
3. 复制生成的 Key 并妥善保存（关闭弹窗后无法再次查看完整 Key）。

Kimi Code 控制台

配置流程

Claude Code 是 Anthropic 推出的命令行编程助手。通过配置环境变量将其接入 Kimi 的 API 端点，你就能在 Claude Code 中直接调用 Kimi Code 的 AI 能力，在熟悉的终端交互里获得 Kimi Code 的编程体验。

① 安装 Claude Code

安装方式请参考 Claude Code 官方文档。

│

② 执行脚本，跳过登录流程

安装完成后，不要直接启动 Claude。先在终端执行以下脚本，跳过 Anthropic 默认的登录流程并清理历史配置：

node --eval "
// enable third party model support and fast mode
const claudeJsonFilePath = path.join(os.homedir(), '.claude.json');
if (fs.existsSync(claudeJsonFilePath)) {
    const content = JSON.parse(fs.readFileSync(claudeJsonFilePath, 'utf-8'));
    fs.writeFileSync(claudeJsonFilePath, JSON.stringify({ ...content, penguinModeOrgEnabled: true, hasCompletedOnboarding: true }, null, 2), 'utf-8');
} else {
    fs.writeFileSync(claudeJsonFilePath, JSON.stringify({ penguinModeOrgEnabled: true, hasCompletedOnboarding: true }), 'utf-8');
}

// delete old endpoint, credential and model id
const claudeSettingsJsonFilePath = path.join(os.homedir(), '.claude', 'settings.json');
if (fs.existsSync(claudeSettingsJsonFilePath)) {
    const content = JSON.parse(fs.readFileSync(claudeSettingsJsonFilePath, 'utf-8'));
    if (typeof content === 'object' && typeof content.env === 'object') {
        for (const element of [
            'ANTHROPIC_BASE_URL',
            'ANTHROPIC_API_KEY',
            'ANTHROPIC_AUTH_TOKEN',
            'ANTHROPIC_MODEL',
            'ANTHROPIC_SMALL_FAST_MODEL',
            'CLAUDE_CODE_SUBAGENT_MODEL',
            'ANTHROPIC_DEFAULT_FABLE_MODEL',
            'ANTHROPIC_DEFAULT_FABLE_MODEL_NAME',
            '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',
            'ENABLE_TOOL_SEARCH',
            'CLAUDE_CODE_AUTO_COMPACT_WINDOW',
            'CLAUDE_CODE_EFFORT_LEVEL',
        ]) {
            delete content.env[element];
        }
        fs.writeFileSync(claudeSettingsJsonFilePath, JSON.stringify(content, null, 2), 'utf-8');
    }
}
"

其中 settings.json 清理部分仅删除 env 中的端点、密钥与模型相关变量（这些残留会覆盖终端里 export 的同名环境变量），不影响其他配置。另外请检查 ~/.zshrc、~/.bashrc 等 shell 配置文件中是否残留旧的 ANTHROPIC_* export（Windows 用户请检查用户环境变量），如有请一并删除。

│

③ 配置 API 接入

请先根据自己的会员档位确认可用的模型与上下文窗口：

会员档位	可配置模型	可用上下文上限
Andante	`kimi-for-coding`	`262144`
Moderato	`k3`、`k3-256k` 或 `kimi-for-coding`	`262144`
Allegretto 及以上	`k3`、`k3-256k`、`kimi-for-coding`、`kimi-for-coding-highspeed`	`k3` 用 `1048576`；`k3-256k` 用 `262144`；K2.7 Code 系列用 `262144`

模型上新推荐

k3-256k全新上线，256k上下文内效果相同, k3（1M）消耗约为 k3-256k 两倍，适合日常问答、代码补全、常规功能开发、单文件或少量文件修场景，不支持视频输入。如从 k3（1M 版本）切换至 k3-256k，建议先压缩上下文再切换。

提供两种配置方式，任选其一，不要混用：方式一写入 settings.json 配置文件，长期生效、任何方式启动都生效；方式二在当前终端临时 export，仅对当前会话有效。

方式一：写入 settings.json（推荐，长期生效）

settings.json 的路径：

macOS / LinuxWindows

text

~/.claude/settings.json

text

C:\Users\<用户名>\.claude\settings.json

将以下配置写入该文件的 env 字段（文件不存在则新建）：

K3-256KK3 1M 上下文

json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.kimi.com/coding/",
    "ANTHROPIC_API_KEY": "你的API Key",
    "ANTHROPIC_MODEL": "k3-256k",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "k3-256k",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "k3-256k",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "k3-256k",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "k3-256k",
    "CLAUDE_CODE_SUBAGENT_MODEL": "k3-256k",
    "CLAUDE_CODE_EFFORT_LEVEL": "high",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "262144",
    "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "262144"
  }
}

json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.kimi.com/coding/",
    "ANTHROPIC_API_KEY": "你的API Key",
    "ANTHROPIC_MODEL": "k3[1m]",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "k3[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "k3[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "k3[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "k3[1m]",
    "CLAUDE_CODE_SUBAGENT_MODEL": "k3[1m]",
    "CLAUDE_CODE_EFFORT_LEVEL": "high",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1048576",
    "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "1048576"
  }
}

保存后重启 Claude Code 生效。

明文密钥风险

settings.json 中的 API Key 以明文存储，请勿将该文件提交到版本仓库或随 dotfiles 公开分享；该文件的 env 会覆盖终端里 export 的同名变量。

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

K3-256K 配置如下：

macOS / LinuxWindows

export ANTHROPIC_BASE_URL=https://api.kimi.com/coding/
export ANTHROPIC_API_KEY=你的API Key

export ANTHROPIC_MODEL="k3-256k"
export ANTHROPIC_DEFAULT_FABLE_MODEL=$ANTHROPIC_MODEL
export ANTHROPIC_DEFAULT_OPUS_MODEL=$ANTHROPIC_MODEL
export ANTHROPIC_DEFAULT_SONNET_MODEL=$ANTHROPIC_MODEL
export ANTHROPIC_DEFAULT_HAIKU_MODEL=$ANTHROPIC_MODEL
export CLAUDE_CODE_SUBAGENT_MODEL=$ANTHROPIC_MODEL
export CLAUDE_CODE_EFFORT_LEVEL=high
export CLAUDE_CODE_AUTO_COMPACT_WINDOW=262144
export CLAUDE_CODE_MAX_CONTEXT_TOKENS=262144

claude

powershell

$env:ANTHROPIC_BASE_URL="https://api.kimi.com/coding/"
$env:ANTHROPIC_API_KEY="你的API Key"

$env:ANTHROPIC_MODEL="k3-256k"
$env:ANTHROPIC_DEFAULT_FABLE_MODEL=$env:ANTHROPIC_MODEL
$env:ANTHROPIC_DEFAULT_OPUS_MODEL=$env:ANTHROPIC_MODEL
$env:ANTHROPIC_DEFAULT_SONNET_MODEL=$env:ANTHROPIC_MODEL
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL=$env:ANTHROPIC_MODEL
$env:CLAUDE_CODE_SUBAGENT_MODEL=$env:ANTHROPIC_MODEL
$env:CLAUDE_CODE_EFFORT_LEVEL="high"
$env:CLAUDE_CODE_AUTO_COMPACT_WINDOW="262144"
$env:CLAUDE_CODE_MAX_CONTEXT_TOKENS="262144"

claude

K3 1M 上下文配置如下：

注意 k3[1m] 写法仅在 Claude Code 环境变量场景需要

k3[1m]（以及外层的引号）用来明确告诉 Claude Code 把上下文窗口设为 1M；其它场景（例如 API 请求、其它第三方工具的 Model ID 字段）只需填 k3 即可。

macOS / LinuxWindows

export ANTHROPIC_BASE_URL=https://api.kimi.com/coding/
export ANTHROPIC_API_KEY=你的API Key

export ANTHROPIC_MODEL="k3[1m]"
export ANTHROPIC_DEFAULT_FABLE_MODEL=$ANTHROPIC_MODEL
export ANTHROPIC_DEFAULT_OPUS_MODEL=$ANTHROPIC_MODEL
export ANTHROPIC_DEFAULT_SONNET_MODEL=$ANTHROPIC_MODEL
export ANTHROPIC_DEFAULT_HAIKU_MODEL=$ANTHROPIC_MODEL
export CLAUDE_CODE_SUBAGENT_MODEL=$ANTHROPIC_MODEL
export CLAUDE_CODE_EFFORT_LEVEL=high
export CLAUDE_CODE_AUTO_COMPACT_WINDOW=1048576
export CLAUDE_CODE_MAX_CONTEXT_TOKENS=1048576

claude

powershell

$env:ANTHROPIC_BASE_URL="https://api.kimi.com/coding/"
$env:ANTHROPIC_API_KEY="你的API Key"

$env:ANTHROPIC_MODEL="k3[1m]"
$env:ANTHROPIC_DEFAULT_FABLE_MODEL=$env:ANTHROPIC_MODEL
$env:ANTHROPIC_DEFAULT_OPUS_MODEL=$env:ANTHROPIC_MODEL
$env:ANTHROPIC_DEFAULT_SONNET_MODEL=$env:ANTHROPIC_MODEL
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL=$env:ANTHROPIC_MODEL
$env:CLAUDE_CODE_SUBAGENT_MODEL=$env:ANTHROPIC_MODEL
$env:CLAUDE_CODE_EFFORT_LEVEL="high"
$env:CLAUDE_CODE_AUTO_COMPACT_WINDOW="1048576"
$env:CLAUDE_CODE_MAX_CONTEXT_TOKENS="1048576"

claude

配置项说明

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

变量	作用	不配置或配置错误的影响
`ANTHROPIC_BASE_URL`	将模型请求转发到 Kimi Code 端点	请求被发往 Anthropic 官方端点，鉴权失败
`ANTHROPIC_API_KEY`	使用 Kimi Code API Key 鉴权	返回 401 鉴权错误
`ANTHROPIC_MODEL`	主对话使用的模型	使用 Claude 默认模型名，Kimi Code 端点无法识别，报模型不存在错误
`ANTHROPIC_DEFAULT_OPUS_MODEL` / `ANTHROPIC_DEFAULT_SONNET_MODEL` / `ANTHROPIC_DEFAULT_HAIKU_MODEL` / `ANTHROPIC_DEFAULT_FABLE_MODEL`	Claude Code 按任务档位选择模型时使用的模型名	对应档位的任务（如 haiku 档的后台标题生成、摘要）请求失败
`CLAUDE_CODE_SUBAGENT_MODEL`	子 Agent 使用的模型	子任务请求失败或效果明显变差
`CLAUDE_CODE_AUTO_COMPACT_WINDOW`	触发自动压缩上下文的窗口大小	需与模型上下文一致：`k3[1m]` 为 `1048576`，其余模型为 `262144`；设置过小会过早压缩丢失上下文，过大则报上下文超限错误
`CLAUDE_CODE_MAX_CONTEXT_TOKENS`	最大上下文 token 数	同上，需与所选模型的上下文窗口一致
`CLAUDE_CODE_EFFORT_LEVEL`	默认思考档位，K3 推荐设为 `high`	较低值可能在复杂任务上降低质量

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

切换思考档位

启动后在会话中输入 /effort 即可切换思考档位，无需配置环境变量。K3 支持 low / high / max 三档，Claude Code 的档位与 K3 的映射关系如下：

Claude Code 档位	K3 实际档位
`low`	`low`
`medium`	`high`（推荐）
`high`	`high`（推荐）
`xhigh`	`max`
`max`	`max`
未设置（默认）	`high`

注意

关闭 thinking 后 K3 和 K2.7 Code 都会被路由到 K2.6，请保持 thinking 开启以使用 K3 / K2.7；K2.7 Code 快捷键 macOS 为 Option+T，Windows / Linux 为 Alt+T。

启动后若提示是否使用该 API key，确认使用即可。随后按照指引选择你信任的项目文件夹，完成授权即可。

│

④ 启动后验证

启动后输入 /status，如果返回信息中显示 Base URL 为 https://api.kimi.com/coding/，则配置成功。此时即使模型名称仍显示为 Claude 模型，实际调用的仍是 Kimi Code 的 API。

Claude Code 状态检查

│

在 VS Code 插件中使用

插件自带 Claude Code 程序，与命令行共用 ~/.claude 下的配置。按以下步骤接入：

按方式一的「配置流程」完成 API 接入配置。
打开插件新建会话，出现登录页面时点击底部的 Run claude in terminal：
在弹出的终端中依次完成两个确认：信任目录选择 Yes, I trust this folder；API Key 确认选择 1. Yes：
完全退出 VS Code 后重新打开，即可在插件中直接对话。

如果不经过终端确认就使用插件，插件会缺少 API Key 的确认登记，发送消息时会反复弹出登录页面。

常见问题

修改配置后不生效

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

返回 401 鉴权错误

检查 ANTHROPIC_API_KEY 是否为有效的 Kimi Code API Key，注意 Key 只在创建时完整展示一次。

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

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

后台任务或子 Agent 报错

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

VS Code 插件一直弹出登录页面

插件缺少 API Key 的确认登记。详细操作见「在 VS Code 插件中使用」。

帮助与反馈

指南

配置

定制化

参考手册

发布说明

Claude Code

开始之前

配置流程

配置项说明

切换思考档位

在 VS Code 插件中使用

常见问题

修改配置后不生效

返回 401 鉴权错误

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

后台任务或子 Agent 报错

VS Code 插件一直弹出登录页面

Claude Code ​

开始之前 ​

配置流程 ​

配置项说明 ​

切换思考档位 ​

在 VS Code 插件中使用 ​

常见问题 ​

修改配置后不生效 ​

返回 401 鉴权错误 ​

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

后台任务或子 Agent 报错 ​

VS Code 插件一直弹出登录页面 ​

Claude Code

开始之前

配置流程

配置项说明

切换思考档位

在 VS Code 插件中使用

常见问题

修改配置后不生效

返回 401 鉴权错误

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

后台任务或子 Agent 报错

VS Code 插件一直弹出登录页面