使用指南

Claude Code 使用 Kimi K3

LLMs Text

Claude Code 使用 Kimi K3

完成配置后,Claude Code 的主对话、后台任务和子 Agent 都会使用 Kimi K3。

准备 Token

在 仪表盘 → 管理 Tokens 创建一个 sk-4ai-... Token。Claude Code 只需要 4AICode Token。

永久配置(推荐)

打开 ~/.claude/settings.json,将以下内容写入 env。已有其他 Claude Code 设置时,请保留原有内容并合并 env 字段。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://relay.4aicode.net",
    "ANTHROPIC_AUTH_TOKEN": "sk-4ai-xxxxxxxxxxxxxxxx",
    "ANTHROPIC_MODEL": "kimi-k3",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "kimi-k3",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "kimi-k3",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "kimi-k3",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "kimi-k3",
    "CLAUDE_CODE_SUBAGENT_MODEL": "kimi-k3",
    "ENABLE_TOOL_SEARCH": "false",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1048576",
    "CLAUDE_CODE_EFFORT_LEVEL": "max"
  }
}

将示例 Token 替换成你自己的 4AICode Token,保存后完全退出并重新打开 Claude Code。

settings.json 包含明文 Token,请妥善保管并排除在 Git 提交之外。

临时配置

临时配置只对当前终端窗口生效,适合先试用。

export ANTHROPIC_BASE_URL="https://relay.4aicode.net"
export ANTHROPIC_AUTH_TOKEN="sk-4ai-xxxxxxxxxxxxxxxx"
export ANTHROPIC_MODEL="kimi-k3"
export ANTHROPIC_DEFAULT_OPUS_MODEL="kimi-k3"
export ANTHROPIC_DEFAULT_SONNET_MODEL="kimi-k3"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="kimi-k3"
export ANTHROPIC_DEFAULT_FABLE_MODEL="kimi-k3"
export CLAUDE_CODE_SUBAGENT_MODEL="kimi-k3"
export ENABLE_TOOL_SEARCH="false"
export CLAUDE_CODE_AUTO_COMPACT_WINDOW="1048576"
export CLAUDE_CODE_EFFORT_LEVEL="max"
claude

请保留示例中的全部模型变量。Claude Code 会在主对话、摘要和子 Agent 等场景使用不同的模型变量。

检查配置

启动 Claude Code,输入:

/status

确认 Base URL 为 https://relay.4aicode.net,Model 为 kimi-k3,然后发送一条消息测试。

Claude Code 的 /model 菜单主要展示内置 Claude 模型。Kimi K3 的实际配置以 /status 为准。

常见问题

现象处理方法
401 或 Token 无效在 Token 页面 检查或重新创建 Token
提示模型不存在所有模型变量统一使用 kimi-k3,模型名不包含 [1m] 后缀
主对话正常,后台任务失败检查配置中是否包含 Haiku、Fable 和 CLAUDE_CODE_SUBAGENT_MODEL
Tool Search 或工具调用异常确认 ENABLE_TOOL_SEARCH 为 false
修改后没有生效settings.json 会覆盖终端里的同名变量,保存后完全重启 Claude Code

配置方式参考 Kimi 官方 Claude Code 指南。普通 Claude 模型和 ChatGPT 模型配置见 Claude 配置。