用 Claude Code 的交互体验 + 国产大模型的低成本与低延迟,打造最佳编程工作流。


目录

安装 Claude Code CLI

1. 安装 Node.js

2. 通过 npm 安装 Claude Code

3. 验证安装

核心原理

方案一:接入 Kimi K2.5(Moonshot)

1. 获取 API Key

2. 配置环境变量与默认模型

3. 启动 Claude Code

方案二:使用 CC-Switch 图形化切换(推荐)

1. 安装

2. 添加 Provider

3. 一键切换

4. 更多特性

持久化配置

方法一:在 Windows 用户环境变量中配置

方法二:使用 Claude Code settings.json

总结


安装 Claude Code CLI

在开始配置之前,你需要先安装 Claude Code 命令行工具。

1. 安装 Node.js

前往 Node.js 官网 下载并安装 v18 或更高版本。安装完成后验证:

node -v

2. 通过 npm 安装 Claude Code

npm install -g @anthropic-ai/claude-code

如果安装速度慢,可使用国内镜像:

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

3. 验证安装

claude -v

如果显示版本号,说明安装成功 


    核心原理

    Claude Code 底层通过 Anthropic Messages API 格式(/v1/messages)与模型通信。只要第三方服务兼容该 API 格式,就可以通过设置环境变量将请求转发到自定义端点:

    Claude Code CLI → 自定义 API 端点(国产模型) → 模型响应
    

    关键的两个环境变量:

    ANTHROPIC_BASE_URL 
    
    ANTHROPIC_AUTH_TOKEN 

    方案一:接入 Kimi K2.5(Moonshot)

    1. 获取 API Key

    前往 Moonshot AI 开放平台 注册账号并创建 API Key。

    2. 配置环境变量与默认模型

    在终端中执行:

    PowerShell:

    # 设置 API 端点指向 Moonshot
    $env:ANTHROPIC_BASE_URL = "https://api.moonshot.cn/anthropic"
    
    # 设置你的 Moonshot API Key
    $env:ANTHROPIC_AUTH_TOKEN = "your-moonshot-api-key"
    
    # 设置默认模型(这样启动时无需 --model 参数)
    $env:ANTHROPIC_MODEL = "kimi-k2.5"
    

    CMD:

    set ANTHROPIC_BASE_URL=https://api.moonshot.cn/anthropic
    set ANTHROPIC_AUTH_TOKEN=your-moonshot-api-key
    set ANTHROPIC_MODEL=kimi-k2.5
    

    也可以通过编辑 C:\\Users\\你的用户名\\.claude\\settings.json来持久化配置默认模型:

    {
      "env": {
        "ANTHROPIC_BASE_URL": "https://api.moonshot.cn/anthropic",
        "ANTHROPIC_AUTH_TOKEN": "your-moonshot-api-key",
        "ANTHROPIC_MODEL": "kimi-k2.5",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "kimi-k2.5",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "kimi-k2.5",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "kimi-k2.5"
      }
    }
    

    3. 启动 Claude Code

    配置完默认模型后,直接运行即可:

    claude
    

    也可以通过 --model 临时指定其他模型:

    claude --model kimi-k2.5
    

    提示: 如果未设置 ANTHROPIC_MODEL 且不带 --model 参数,Claude Code 默认会尝试调用 Claude Sonnet,而 Moonshot 端点不支持该模型名,会导致报错。

    方案二:使用 CC-Switch 图形化切换(推荐)

    如果你不喜欢每次手动修改环境变量,CC-Switch 是一个更优雅的选择。它是一款开源桌面应用,提供图形化界面来管理和切换多个 API Provider 配置,支持 Claude Code、Codex、Gemini CLI 等主流 AI 编程工具。

    核心亮点: 无需手动改配置文件或设置环境变量,通过 UI 或系统托盘一键切换模型提供商。

    1. 安装

    前往 GitHub Releases 下载 Windows 安装包(推荐 .msi,安装包仅约 6MB),按提示完成安装即可。

    2. 添加 Provider

    打开 CC-Switch 主界面,点击 "Add Provider" 按钮:

    • 使用内置预设(推荐):CC-Switch 内置了大量常用 Provider 模板(Moonshot、智谱、DeepSeek 等),选择后填入 API Key 即可
    • 自定义配置:手动填写 API 端点和密钥,适合接入自建代理或小众服务商

    3. 一键切换

    配置完成后,可通过以下方式切换:

    • 在主界面点击对应 Provider 即可激活
    • 通过系统托盘图标快速切换
    • 支持拖拽排序,将高频使用的配置置顶

    4. 更多特性

    • MCP 服务器管理:统一管理 MCP 配置,并可在 Claude Code 和 Codex 之间同步
    • WSL 穿透:Windows 环境下支持 WSL 自动同步配置目录
    • CC 插件同步:支持 Claude Code VS Code 插件的资源站切换(在设置中开启)
    • 云同步:支持通过坚果云等服务同步配置,多设备共享

    项目地址:github.com/farion1231/cc-switch

    持久化配置

    方法一:在 Windows 用户环境变量中配置

    通过设置 Windows 用户环境变量,每次打开终端时自动生效,无需重复设置。

    方式一:图形界面设置

    1. Win + I 打开设置,搜索「编辑系统环境变量」
    2. 点击「环境变量」按钮
    3. 在上方「用户变量」区域,点击「新建」,依次添加以下变量:
    变量名 变量值(以 Kimi K2 为例)
    ANTHROPIC_BASE_URL https://api.moonshot.cn/anthropic
    ANTHROPIC_AUTH_TOKEN 你的 API Key
    ANTHROPIC_MODEL kimi-k2.5(默认模型)
    ANTHROPIC_DEFAULT_HAIKU_MODEL kimi-k2.5(替代 Haiku)
    ANTHROPIC_DEFAULT_SONNET_MODEL kimi-k2.5(替代 Sonnet)
    ANTHROPIC_DEFAULT_OPUS_MODEL kimi-k2.5(替代 Opus)

    方式二:通过 PowerShell 命令设置

    # 设置用户环境变量(永久生效)
    [Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.moonshot.cn/anthropic", "User")
    [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "your-moonshot-api-key", "User")
    [Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "kimi-k2.5", "User")
    [Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_HAIKU_MODEL", "kimi-k2.5", "User")
    [Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_SONNET_MODEL", "kimi-k2.5", "User")
    [Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_OPUS_MODEL", "kimi-k2.5", "User")

    注意: 设置完成后需要重新打开终端才能生效。如果需要切换不同模型服务商,修改对应变量值即可。

    方法二:使用 Claude Code settings.json

    编辑 %USERPROFILE%\\.claude\\settings.json(即 C:\\Users\\你的用户名\\.claude\\settings.json):

    {
      "env": {
        "ANTHROPIC_BASE_URL": "https://api.moonshot.cn/anthropic",
        "ANTHROPIC_AUTH_TOKEN": "your-api-key",
        "ANTHROPIC_MODEL": "kimi-k2.5",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "kimi-k2.5",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "kimi-k2.5",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "kimi-k2.5"
      }
    }
    

    关键字段说明:

    字段 作用
    ANTHROPIC_MODEL 默认使用的模型,启动时无需 --model 参数
    ANTHROPIC_DEFAULT_HAIKU_MODEL 替代 Haiku 的模型(用于轻量级任务)
    ANTHROPIC_DEFAULT_SONNET_MODEL 替代 Sonnet 的模型(默认主力模型)
    ANTHROPIC_DEFAULT_OPUS_MODEL 替代 Opus 的模型(用于复杂推理任务)

      总结

      Claude Code CLI 的开放架构为国内开发者提供了一个绝佳的入口:既能享受顶级的 AI 编程交互体验,又能灵活选择适合自己的大模型

      Logo

      有“AI”的1024 = 2048,欢迎大家加入2048 AI社区

      更多推荐