完成配置后,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 配置。