跳到主要内容

Claude Code

Claude Code 是 Anthropic 推出的 AI 编程助手，通过命令行界面为开发者提供智能编程支持[1]。

没有免费额度，官方费用非常高，20 美金每月，只能使用 Claude Sonnet 4。100 美金版本比较主流，可以使用Claude Sonnet 4 / Claude Opus 4.1。据说通过代理访问官方也容易被封号。

有第三方代理中转平台，大概 299 人民币起步，计费方式大致为：每天有固定上限点数，每小时自动回复点数。

还有兼容 Claude Code （CC）的正规平台，如 Moonshot[2]、智普[3]、DeepSeek[4]、Doubao[5]。

以及使用 Claude Code Router[6] （CCR）进行中转，这样可以兼容大部分模型。

体验​

Claude Code 上手相对容易，/ 命令也不多，功能也比较清晰。周边生态、MCP 等适配资源也非常丰富。现在也支持子代理、插件、自定义命令等高级功能了。它支持粘贴图片进行对话（需要模型也支持，国内K2 模型不支持图片），上下文控制也还可以。体验是比较优秀的。

国内来用的话，可以配置的国内模型比较多，而且很多都是官方支持 CC，价格也有很多包月，也是比较划算。同时也有大量的配置工具，如 ZCF CC-Switch 等，大幅精简了配置过程。

可以说，对于想使用一款 CLI 工具的话，CC 一定是首选。

系统要求​

  • Node.js 18 或更新版本
  • 模型平台，以下任选一即可
    • Anthropic 官方付费账号 + 代理工具
    • 第三方中转平台
    • 兼容 CC 的平台账号（ Moonshot 需要充值50元以上，确保有足够的线程数）
    • 使用 Claude Code Router，任选常见一个平台的 API 账号

安装​

特别注意

如果是第三方中转平台，以平台为准，可能会安装定制版 npm 包。请参考第三方中转平台教程。

现在非常不推荐使用定制版 npm 包了，容易存在安全隐患。现在绝大部分中转平台都支持官方 CC 包。

官方、第三方中转平台、还有兼容 CC 的平台、以及 CCR 方案，可参考本方案进行安装。

哪种方案，都是安装标准的 CC 工具：

npm install -g @anthropic-ai/claude-code
# 如果安装失败，可尝试更换国内源进行安装
npm install -g @anthropic-ai/claude-code --registry https://registry.npmmirror.com

使用 NCF 配置工具​

现在有了好的管理工具：NCF[7]。这样可以省去手动切换。

它可以实现配置多个路由，方便随时切换，也支持自动安装 CC、CCR。同时带有一些工作流和输出风格的配置。

只需要指定 npx ncf 即可。即可看到下面的使用指引。

╔════════════════════════════════════════════════════════════════╗
║                                                                ║
║   ███████╗  ██████╗ ███████╗                                   ║
║       ██╔╝  ██╔═══╝  ██╔═══╝                                   ║
║      ██╔╝   ██║      █████╗                                    ║
║    ██╔╝     ██║      ██╔══╝                                    ║
║   ███████╗  ╚██████╗ ██║                                       ║
║   ╚══════╝   ╚═════╝ ╚═╝        for Claude Code                ║
║                                                                ║
║   Zero-Config Code Flow                                        ║
║                                                                ║
╚════════════════════════════════════════════════════════════════╝

  Version: 3.3.1  |  https://github.com/UfoMiao/zcf

请选择功能
  -------- Claude Code --------
  1. 完整初始化 - 安装 Claude Code + 导入工作流 + 配置 API 或 CCR 代理 + 配置 MCP 服务
  2. 导入工作流 - 仅导入/更新工作流相关文件
  3. 配置 API 或 CCR 代理 - 配置 API URL、认证信息或 CCR 代理
  4. 配置 MCP - 配置 MCP 服务（含 Windows 修复）
  5. 配置默认模型 - 设置默认模型（opus/sonnet/sonnet 1m/自定义）
  6. 配置 Claude 全局记忆 - 配置 AI 输出语言和输出风格
  7. 导入推荐环境变量和权限配置 - 导入隐私保护环境变量和系统权限配置

  --------- 其他工具 ----------
  R. CCR - 配置 Claude Code Router 以使用多个 AI 模型
  U. ccusage - Claude Code 用量分析
  L. CCometixLine - 基于 Rust 的高性能 Claude Code 状态栏工具，集成 Git 信息和实时使用量跟踪

  ------------ ZCF ------------
  0. 更改显示语言 / Select display language - 更改 ZCF 界面语言
  S. 切换代码工具 - 在支持的代码工具之间切换 (Claude Code, Codex)
  -. 卸载和删除配置 - 从系统中删除 Claude Code 配置和工具
  +. 检查更新 - 检查并更新 Claude Code、CCR 和 CCometixLine 的版本
  Q. 退出

使用 CC-Switch 配置工具​

如果不希望使用 NCF，觉得它功能太多了，还可以使用 CC-Switch[8] 进行 API 配置，CC-Switch 是带有界面的工具。

具体可以参考官方的介绍文档，由于带有页面，使用比较简单。

环境变量配置方法（传统）​

不同系统配置方法不同，大致如下：

# PowerShell
$env:http_proxy="http://127.0.0.1:7890"
$env:https_proxy="http://127.0.0.1:7890"

# cmd
set http_proxy="http://127.0.0.1:7890"
set https_proxy="http://127.0.0.1:7890"

# MacOS Linux
export http_proxy="http://127.0.0.1:7890"
export https_proxy="http://127.0.0.1:7890"

后续所有配置变量，以 MacOS Linux 为准，需自行调整为合适的配置方法。

官方使用方法​

  1. 如果使用官方方案，需要使用命令行工具，访问到项目目录，之后配置代理（根据你的代理工具IP和端口进行调整）：
export http_proxy="http://127.0.0.1:7890"
export https_proxy="http://127.0.0.1:7890"
  1. 运行启动命令：
claude
  1. 启动 claude 后，会出现它的 LOGO，随后你可以按上下键选择登录鉴权方式。选择网页账号鉴权，随后会打开默认浏览器，直接授权即可。
  2. 返回命令行工具，就可以使用了。

对接正规代理第三方中转平台、还有兼容 CC 的平台​

  1. 如果是兼容 CC 的方案，可直接使用下面的配置。注意替换自己的 ANTHROPIC_AUTH_TOKEN。如果是第三方中转平台方案，参考平台文档，配置基本和下面差不多。
# Moonshot 配置
export ANTHROPIC_BASE_URL="https://api.moonshot.cn/anthropic"
export ANTHROPIC_AUTH_TOKEN="sk-********"

# 智普配置
export ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/anthropic"
export ANTHROPIC_AUTH_TOKEN="sk-********"

# DeepSeek 配置
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=${DEEPSEEK_API_KEY}
export API_TIMEOUT_MS=600000 # deepseek 建议配置更长的时间
export ANTHROPIC_MODEL=deepseek-chat
export ANTHROPIC_SMALL_FAST_MODEL=deepseek-chat
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
  1. 运行启动命令：
claude
  1. 应该会自动完成鉴权，不需要做任何配置等处理，即可使用。

对接 Claude Code Router 使用方法​

  1. 安装 Claude Code Router
npm install -g @musistudio/claude-code-router
# 如果安装失败，可尝试更换国内源进行安装
npm install -g @musistudio/claude-code-router --registry https://registry.npmmirror.com
  1. 运行配置 CCR 命令，可使用 UI 模式进行配置：
ccr ui

在浏览器中，添加你的模型供应商，如果模型不在模版中，任选一个，然后修改相应的参数，注意保存模型。

随后在右侧配置中，配置新增的供应商，确保最基础的 默认 后台 思考 等路由都配置完成。

当然，也可以在后续的 ccr code 进程中，打开配置页面进行配置（要提前复制本地配置地址）。

  1. 检查是否存在 ~/.claude/config.json 配置文件，如果你使用过 claude（不论是官方方案还是兼容 CC 方案），会出现此配置。请删除此文件。否则 CCR 配置不生效。

  2. 运行启动命令：

ccr code
## 注意这里不是 ccr claude
  1. 应该会自动完成鉴权，不需要做任何配置等处理，即可使用。

故障排除​

如果出现什么意外，可以考虑移除用户目录下的 .claude 目录后，再次尝试。

参考​

[1] Claude Code

[2] Moonshot - 在-claude-code-中使用-kimi-k2-模型

[3] 智普 - 接入 Claude Code

[4] DeepSeek - Anthropic API

[5] Doubao - 配置编程工具

[6] GitHub - claude-code-router

[7] GitHub - zcf

[8] GitHub - cc-switch

最后于 更新