Claude From Zero
第 2 章：安装与配置

Coding Plan

在 Claude Code 中接入国产 AI 编程订阅

Claude Code 默认连接 Anthropic 官方 API，使用 Claude 系列模型。但对于中国大陆开发者而言，网络稳定性和订阅成本是两大现实门槛。Coding Plan 正是解决这一问题的关键——它是国内各大 AI 厂商推出的编程场景订阅套餐，以固定月费替代按 Token 计费，让你用 Claude Code 的交互体验配合国产模型的算力，实现低成本、高稳定的 AI 编程工作流。

本章将以 Kimi Coding Plan 为主线（因其 Anthropic API 兼容度最高、长上下文能力突出），同时覆盖 DeepSeek、GLM、MiniMax 等其他主流方案，帮助你找到最适合自己的配置。

一、Coding Plan 是什么

1.1 定义

Coding Plan 是 AI 模型/云厂商面向开发者推出的编程场景订阅套餐。与传统按 Token 计费不同，它以固定周期（5 小时 / 周 / 月）提供固定额度，大幅降低使用门槛和成本不确定性。1

计费模式特点适用场景
按 Token 计费用多少付多少，成本不可预测低频使用、实验性项目
Coding Plan 订阅固定月费，额度内不限量日常开发、团队高频使用
混合模式订阅 + 超出部分按量重度使用者

1.2 核心选购指标：额度倍率

额度倍率是衡量 Coding Plan 性价比的核心指标：

额度倍率 = 当前周期可用额度 ÷ 包月价格

倍率越高，单位资金能买到的算力越多。但需注意：额度充足比倍率更重要——再高的倍率，如果频繁触发 429（Rate Limit），体验也会大打折扣。1

1.3 为什么 Claude Code + Coding Plan 是最佳组合

Claude Code 提供了目前最成熟的终端 AI 编程交互体验，但它的模型绑定并非不可改变。通过配置 ANTHROPIC_BASE_URL 等环境变量，Claude Code 可以接入任何兼容 Anthropic API 格式的第三方服务。2

这意味着你可以：

  • 保留 Claude Code 的终端交互、文件编辑、命令执行等核心能力
  • 将底层模型从 Claude 切换为 Kimi、DeepSeek、GLM 等国产模型
  • 享受 Coding Plan 的固定成本和国内直连优势

二、Claude Code 接入国产模型的核心机制

2.1 原理：Anthropic API 格式兼容

Claude Code 默认向 api.anthropic.com 发送请求，但提供了一系列环境变量允许你重定向到兼容的服务端点：3

环境变量作用必需
ANTHROPIC_BASE_URL自定义 API 基础地址是
ANTHROPIC_AUTH_TOKENAPI 认证密钥是
ANTHROPIC_MODEL主模型名称推荐配置
ANTHROPIC_SMALL_FAST_MODEL轻量模型（后台任务）推荐配置

国产厂商中，Kimi 和 DeepSeek 官方提供了 Anthropic API 格式的兼容端点，配置最为直接。GLM、阿里云百炼等也提供了适配方案。

2.2 配置方式

Claude Code 支持两种配置方式，推荐第二种：

方式一：Shell 环境变量（临时生效）

export ANTHROPIC_BASE_URL=https://api.moonshot.cn/anthropic
export ANTHROPIC_AUTH_TOKEN=sk-your-kimi-api-key
export ANTHROPIC_MODEL=kimi-k2-turbo-preview
export ANTHROPIC_SMALL_FAST_MODEL=kimi-k2-turbo-preview

claude  # 启动会话

方式二：settings.json（持久化，推荐）

在 ~/.claude/settings.json 中写入：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.moonshot.cn/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-kimi-api-key",
    "ANTHROPIC_MODEL": "kimi-k2-turbo-preview",
    "ANTHROPIC_SMALL_FAST_MODEL": "kimi-k2-turbo-preview"
  }
}

配置完成后，启动 Claude Code 时执行 /status 可查看当前连接的模型和 API 配置。

2.3 多模型切换策略

Claude Code 本身不支持同时配置多个模型，但可以通过配置文件切换实现灵活调度：4

# ~/.claude/ 目录下为每个模型准备一个配置文件
~/.claude/
  ├── settings.json              # 当前生效配置
  ├── settings.json.kimi         # Kimi 配置备份
  ├── settings.json.deepseek     # DeepSeek 配置备份
  └── settings.json.glm          # GLM 配置备份

# 切换模型时复制对应的配置文件
cp ~/.claude/settings.json.kimi ~/.claude/settings.json
# 然后重启 Claude Code

更优雅的方式：Shell 函数

在 .zshrc 或 .bashrc 中定义快捷命令：

cc-kimi() {
  export ANTHROPIC_BASE_URL=https://api.moonshot.cn/anthropic
  export ANTHROPIC_AUTH_TOKEN=$KIMI_API_KEY
  export ANTHROPIC_MODEL=kimi-k2-turbo-preview
  claude
}

cc-deepseek() {
  export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
  export ANTHROPIC_AUTH_TOKEN=$DEEPSEEK_API_KEY
  export ANTHROPIC_MODEL=deepseek-reasoner
  claude
}

cc-claude() {
  unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN ANTHROPIC_MODEL
  claude
}

2.4 轻量模型与主模型的分工

Claude Code 在空闲时也会为后台任务（如上下文摘要、代码索引）调用模型。通过 ANTHROPIC_SMALL_FAST_MODEL 可以为这些任务指定成本更低的模型：3

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.moonshot.cn/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-kimi-api-key",
    "ANTHROPIC_MODEL": "kimi-k2-turbo-preview",
    "ANTHROPIC_SMALL_FAST_MODEL": "kimi-k2-turbo-preview"
  }
}

注：Kimi 目前各模型间价格差异不大，可直接统一配置。若使用 DeepSeek，建议主模型用 deepseek-reasoner，轻量模型用 deepseek-chat。

三、Kimi Coding Plan 详解与接入

Kimi（月之暗面）以长上下文能力闻名，其 Coding Plan 在代码理解、多文件重构等场景表现突出。

3.1 Kimi Coding Plan tiers

套餐月费5h 额度TPS特点
Kimi Code Andante¥49359 reqs / 15M tokens27.98入门级，额度偏紧张
Kimi Code Allegretto¥1991307 reqs / 65M tokens27.98推荐，日常开发够用
Kimi Code 团队版¥699更大额度27.98团队共享，性价比一般

选购建议：个人开发者选 Allegretto（¥199），团队可购买多个 Allegretto 分摊使用，比团队版更灵活。1

3.2 获取 Kimi API Key

  1. 访问 Kimi 开放平台
  2. 注册/登录账户
  3. 进入「API Key 管理」页面创建新密钥
  4. 复制生成的 sk- 开头密钥

3.3 Claude Code 接入 Kimi 完整步骤

Step 1：创建配置文件

# 确保 ~/.claude/ 目录存在
mkdir -p ~/.claude

# 创建或编辑 settings.json
cat > ~/.claude/settings.json <<'EOF'
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.moonshot.cn/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Kimi API密钥",
    "ANTHROPIC_MODEL": "kimi-k2-turbo-preview",
    "ANTHROPIC_SMALL_FAST_MODEL": "kimi-k2-turbo-preview"
  }
}
EOF

Step 2：验证配置

claude
# 进入会话后执行
/status

确认 API Configuration 显示自定义地址，Model 显示 kimi-k2-turbo-preview。

Step 3：测试代码生成能力

写一个 Python 函数，用递归实现快速排序，并包含类型注解和单元测试

观察响应速度和代码质量，确保配置生效。

3.4 Kimi 模型选择指南

Kimi 提供多个模型，代码场景推荐：

模型适用场景上下文长度
kimi-k2-turbo-preview通用编程，推荐默认使用256K
kimi-k2.5复杂推理、长文档分析256K
kimi-k2.6最新版本（注意：升级后稳定性待观察）1256K

3.5 已知问题与规避

问题现象规避方法
kimi-k2.6 死循环部分任务中模型反复输出同一内容降级到 k2.5 或 k2-turbo-preview
429 Rate Limit高频使用时触发速率限制降低操作频率，或升级 Allegretto
多模态限制图像输入仅 Allegretto 支持Andante 用户避免上传截图

四、其他国产 Coding Plan 对比与接入

4.1 主流方案速览

厂商套餐月费额度倍率(月)核心特点API 兼容
MiniMaxCoding Plan Plus¥4988.65额度倍率最高，含 TTS+图像Anthropic
火山方舟Coding Plan Lite¥4015.18TPS 最高(86.6)，字节系Anthropic
GLMCoding Plan Lite¥495.08代码能力国内顶尖Anthropic
GLMCoding Plan Pro¥1498.355x Lite 额度，429 更频繁Anthropic
DeepSeek无订阅，按量——百万 Token 输入 1 元Anthropic
阿里云Coding Plan Lite¥4019.80已下线—

额度倍率数据来自 awesome-coding-plan，截至 2026 年 4 月。1

4.2 DeepSeek（按量计费，无 Coding Plan）

DeepSeek 没有订阅套餐，但其按量价格极具竞争力：1

  • 缓存读：¥0.01 / 百万 Token（业界最低）
  • 输入：¥1 / 百万 Token
  • 输出：¥2 / 百万 Token
  • 1 亿 Token 总成本约 ¥9

Claude Code 接入配置：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-deepseek-key",
    "ANTHROPIC_MODEL": "deepseek-reasoner",
    "ANTHROPIC_SMALL_FAST_MODEL": "deepseek-chat"
  }
}

劣势：不支持多模态，重度使用下总成本可能超过 Coding Plan。

4.3 智谱 GLM Coding Plan

GLM 的代码能力在国内评测中表现最强，但 429 频率也最高。1

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "你的GLM API KEY"
  }
}

GLM 默认自动路由 GLM-4.5 和 GLM-4.5-Air，无需显式指定模型。

4.4 MiniMax Coding Plan Plus

目前额度倍率最高的 Coding Plan（88.65），适合预算敏感型开发者。1

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.minimax.chat/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "你的MiniMax API KEY",
    "ANTHROPIC_MODEL": "minimax-m2.7"
  }
}

4.5 火山方舟 Coding Plan Lite

字节跳动旗下，TPS 高达 86.6，响应速度最快。1

五、Coding Plan 选购决策指南

5.1 按场景推荐

你的月预算是多少？
├── ≤¥50
│   ├── 追求额度倍率 → MiniMax Plus (¥49)
│   └── 追求代码质量 → GLM Lite (¥49)
├── ¥50-200
│   ├── 追求稳定 + 长上下文 → Kimi Allegretto (¥199)
│   └── 追求代码能力 → GLM Pro (¥149)
└── 不确定用量 / 低频使用
    └── DeepSeek 按量（无订阅门槛）

你的核心需求？
├── 多模态（图像输入）→ Kimi Allegretto / MiniMax Plus
├── 极致响应速度 → 火山方舟 Lite
├── 长上下文（>100K）→ Kimi 系列
└── 最低成本 → DeepSeek 按量

5.2 额度管理技巧

监控剩余额度：

各平台通常在控制台提供额度使用统计。建议每周检查一次，避免在关键任务中突然耗尽。

避免 429 的实用技巧：

  1. 降低并发：Claude Code 默认会并行执行多个操作，可在设置中限制并发数
  2. 错峰使用：国内工作日上午 10-12 点、下午 2-4 点是使用高峰
  3. 本地缓存：对重复查询的结果自行缓存，减少 API 调用
  4. 分级使用：复杂任务用主模型，简单查询用 ANTHROPIC_SMALL_FAST_MODEL

六、进阶：多模型协同与智能路由

6.1 claude-code-router：一键切换多模型

claude-code-router（CCR）是一个开源工具，提供更优雅的模型切换体验：4

# 安装
npm install -g claude-code-router

# 配置多个模型
ccr config add kimi \
  --base-url https://api.moonshot.cn/anthropic \
  --api-key sk-your-key \
  --model kimi-k2-turbo-preview

ccr config add deepseek \
  --base-url https://api.deepseek.com/anthropic \
  --api-key sk-your-key \
  --model deepseek-reasoner

# 启动时指定模型
ccr code --model kimi
ccr code --model deepseek

6.2 多模型共识：让多个模型交叉验证

对于关键架构决策，可以让多个模型独立给出方案后对比：5

# 使用 Claude Code + Kimi 做第一轮设计
cc-kimi
# "设计一个支持 10万 QPS 的订单系统架构"

# 保存方案后，切换到 DeepSeek 做第二轮验证
cc-deepseek
# "请审查以下架构方案，找出潜在瓶颈和遗漏点：[粘贴第一轮方案]"

6.3 任务分流策略

任务类型推荐模型理由
复杂架构设计Claude Opus / Kimi K2.5推理能力强
日常编码Kimi / GLM速度快、成本低
代码审查DeepSeek Reasoner逻辑分析细致
单元测试生成MiniMax / Qwen代码生成质量高
文档编写Kimi长上下文优势

七、避坑指南

7.1 常见配置错误

错误现象修复
ANTHROPIC_BASE_URL 末尾加 /404 错误去掉末尾斜杠，如 https://api.moonshot.cn/anthropic
使用网页版 API Key认证失败必须使用开放平台申请的 API Key
模型名称拼写错误模型不可用复制官方文档中的 exact model name
settings.json 语法错误Claude Code 启动失败用 jq . ~/.claude/settings.json 验证 JSON

7.2 订阅陷阱

  • 自动续费：部分平台默认开启，记得在不需要时关闭
  • 额度清零规则：确认未用完额度是否结转（多数平台不结转）
  • 团队版限制：检查是否允许多设备同时登录

7.3 网络问题

# 测试 API 连通性
curl -s -o /dev/null -w "%{http_code}" \
  https://api.moonshot.cn/anthropic/v1/models \
  -H "Authorization: Bearer sk-your-key"

# 预期返回 200

若返回非 200，检查：

  1. API Key 是否正确（是否有多余空格）
  2. 本地网络是否需要代理
  3. 防火墙是否拦截了该域名

八、总结

Coding Plan 让 Claude Code 从"Anthropic 独占"变成了"模型中立平台"。通过简单的环境变量配置，你可以：

  • 用 Kimi 的长上下文处理大型代码库
  • 用 DeepSeek 的低成本做日常开发
  • 用 GLM 的强代码能力做复杂重构
  • 根据任务灵活切换，不再被单一模型绑定
方案月费最佳场景推荐度
Kimi Allegretto¥199长上下文、日常开发主力★★★★★
MiniMax Plus¥49预算敏感、高额度需求★★★★☆
GLM Pro¥149追求代码质量★★★★☆
DeepSeek 按量不定低频使用、实验项目★★★☆☆
Claude Pro$20复杂推理、官方支持★★★★☆

最终建议：以 Kimi Allegretto 为主力，DeepSeek 按量为备用，既能享受 Coding Plan 的稳定性，又能在额度耗尽时不中断工作。

参考来源

Footnotes

  1. awesome-coding-plan — 国内 Coding Plan 额度、倍率、定价对比汇总 ↩ ↩2 ↩3 ↩4 ↩5 ↩6 ↩7 ↩8 ↩9
  2. 在 Claude Code 中使用自定义模型服务 — Claude Code 环境变量配置原理与实践 ↩
  3. Claude Code 接入四大国产编程模型全指南 — Kimi、DeepSeek、GLM、Qwen 详细接入步骤 ↩ ↩2
  4. Claude Code 支持多个大模型配置指南 — CCM、CCR 一键切换工具介绍 ↩ ↩2
  5. 多模型共识：让 Claude Code 调用 DeepSeek、通义千问、KIMI — 多模型配置与交叉验证方法 ↩

选择你的界面

CLI、IDE 插件、桌面应用、网页版

启动、交互模式与基本命令

Claude Code 的交互体验是其区别于传统 IDE 插件的核心竞争力。它不是一个需要点击按钮的图形界面工具，而是一个深度融入终端工作流的命令行伴侣。理解它的启动流程、交互模式和内置命令体系，是高效使用 Claude Code 的第一步。