# Claude Code 使用 Kimi K3

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

## 准备 Token

在 [仪表盘 → 管理 Tokens](https://4aicode.com/tokens) 创建一个 `sk-4ai-...` Token。Claude Code 只需要 4AICode Token。

## 永久配置（推荐）

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

```json
{
  "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 提交之外。

## 临时配置

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


**macOS / Linux**


```bash
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
```


**Windows PowerShell**


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


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

## 检查配置

启动 Claude Code，输入：

```text
/status
```

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

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

## 常见问题

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

配置方式参考 [Kimi 官方 Claude Code 指南](https://platform.kimi.com/docs/guide/claude-code-kimi)。普通 Claude 模型和 ChatGPT 模型配置见 [Claude 配置](/docs/guides/claude)。