Claude Code 是最早出现的 CLI coding agent，也是这个领域生态建设的引领者。如果你想学习使用 coding agent 来进行编码，那么它是绕不过去的一个学习对象，很多第三方 agent 也是基于 Anthropic 的模型协议开发的。

本文面向小白，首先介绍如何安装 Claude Code 并将其配置为集成国产大模型，然后分享一些实用的自定义配置。

为什么选择国产模型

Claude Code 默认对接 Anthropic 官方的 Claude 模型接口（Anthropic 是服务端，Claude Code 是客户端）。但由于合规和监管要求，这一接口服务并未向中国大陆用户开放。

Anthropic 在官方文档中明确指出 Claude Code “支持第三方提供商”。不过这里的第三方厂商只包括 Amazon Bedrock、Claude Platform on AWS、Google Cloud’s Agent Platform、Microsoft Foundry 这些国外厂商。这些厂商部署的，也都是 Claude 官方模型，而非自研模型。

为了满足广大用户使用 Claude Code 的需求，国产模型厂商大都提供了兼容 Anthropic 协议的接口。相比官方接口，不需要绕过网络限制，不用担心 Anthropic 在服务端的封禁或识别。相比中转站，数据直达国内服务商，也不用担心数据泄露和指令劫持。

不过 Claude Code 客户端集成国产第三方模型的做法，对 Anthropic 而言一直处于一种默许但不被承认的灰色地带。官方文档中从未明确声明 Claude Code 支持协议兼容的第三方模型。由于 Claude Code 工具本身不是开源软件，这种集成方式未来可能受 Anthropic 公司运营策略的影响。如果你对可控性十分在意，可以考虑切换到其他开源 coding agent 工具，例如 pi 或 opencode。

常见国产模型厂商的接入文档可参考：

模型文档地址
deepseekhttps://api-docs.deepseek.com/zh-cn/quick_start/agent_integrations/claude_code
MiniMaxhttps://platform.minimaxi.com/docs/token-plan/claude-code
glmhttps://docs.bigmodel.cn/cn/guide/develop/claude
kimihttps://www.kimi.com/code/docs/third-party-tools/claude-code.html
qwenhttps://help.aliyun.com/zh/model-studio/claude-code

选定厂商前，建议先购买基础版 Coding Plan / Token Plan 试用，或者看看厂商有没有赠送的额度。在确认模型能力满足你的开发需求后，再考虑长期订阅。

安装前准备

安装 Claude Code 前，需要先准备好两个基础依赖：

  1. Node.js：Claude Code 通过 npm 进行安装，需要 Node.js 运行环境。请前往 nodejs 官网，下载安装最新的 LTS 版本 Node.js，当前版本号是 v24.20.0。

  2. Git for Windows（仅 Windows 环境需要）：Claude Code 会默认使用 Git for Windows 提供的类 Unix（POSIX）Shell 环境来执行命令行。可以前往 gitforwindows 官网 下载安装。如果不安装，则会回退到 PowerShell。目前大模型对 Bash 的理解和执行能力比 PowerShell 更完善。

安装 Claude Code

Claude Code 官方提供了一键安装脚本，但在中国大陆访问时会被拒绝，所以通常改用 npm 进行安装。这种安装方式也是官方支持的，在安装过程中 npm 只是承担了一个包管理器的职责，安装下来的程序与通过脚本安装的没有区别。通过 npm 来安装 Claude Code 的命令行如下：

npm install -g @anthropic-ai/claude-code --allow-scripts=@anthropic-ai/claude-code

由于 Node.js 社区的不少 npm 包近期发生了上游的 script 安全劫持事件，最新版本的 npm 要求用户手动许可才能执行脚本。所以此处添加 --allow-scripts 参数来解决安装后脚本的运行权限问题。

配置 Claude Code

安装好 Claude Code 工具后，需要配置它来使用你的国产模型接口，否则它会默认使用 Anthropic 的官方接口。配置方法也很简单，编辑 ~/.claude/settings.json 文件，把国产大模型的接口地址和 API Key 配置进去就行了。

Windows 环境下，打开 CMD 控制台，执行以下命令：

cd %USERPROFILE%
mkdir .claude
notepad .claude\settings.json

Linux 环境下，打开 Bash 终端，执行以下命令：

cd ~
mkdir .claude
vim .claude/settings.json

编辑配置文件并保存，以 MiniMax 为例，格式如下：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.minimaxi.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "<your-api-key>",
    "ANTHROPIC_MODEL": "MiniMax-M3[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M3[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M3[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M3[1m]",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS": "1"
  },
  "skipWebFetchPreflight": true,
  "autoMemoryEnabled": false,
  "awaySummaryEnabled": false
}

配置说明

配置文件中主要包括兼容 Anthropic 的接口地址、API Key，以及模型名称。更换模型厂商，需要按对应的帮助文档对配置进行调整。如果经常需要切换，可以考虑使用工具 cc-switch。

除了必要的配置外，示例里还添加了几项我日常使用的额外配置，主要为了优化使用体验，它们的作用分别如下：

  1. CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 禁用 Claude Code 的非必要网络流量，主要包括遥测上报和错误报告等。开启后，客户端不会再把使用数据发往 Anthropic。这个配置也会禁用自动更新。
  2. CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS: 禁用 Claude Code 内置的 Explore（代码探索）和 Plan（任务规划）两个子 agent 类型。Claude Code 处理复杂任务时，会先派这两个子 agent 去读代码、列方案，再交给主 agent 执行。实际使用中，国产模型对子 agent 的适配参差不齐，容易把简单问题复杂化，出现过度计划与调研，导致长时间等待。关闭后由主模型一次性输出反而更稳定，也更省 token。
  3. skipWebFetchPreflight: 跳过 WebFetch 工具执行前对远端主机名的可达性预检。WebFetch 是内置的网页内容抓取与处理工具，默认状态下，它会先访问 Anthropic 接口来进行安全合规检测，Anthropic 在云端维护了一个官方域名黑名单。由于 Anthropic 未向中国大陆用户提供服务，预检每次都会失败。跳过预检可以让 WebFetch 直接发请求，使其能够正常抓取网页内容。
  4. autoMemoryEnabled: 关闭自动记忆功能。Claude Code 默认会在会话过程中把你的偏好、对它的修正、项目背景等内容写入 ~/.claude/projects/<项目>/memory/ 目录，并在下次会话自动加载。长期使用会自动产生一份 MEMORY.md，容易堆积冗余信息。关闭后，需要约束模型时，建议直接在提示词中要求模型记入项目的 CLAUDE.md，这样会更可控，积累的经验也能够在团队间共享。
  5. awaySummaryEnabled: 关闭离开时的会话回顾。Claude Code 默认会在你长时间离开再回到终端时，弹出一份这段时间的进展摘要。这个功能对我而言意义不大，且会额外消耗 token，可按需关闭。

好了，今天就分享到这里，关于 AI coding 还有很多最佳实践，后续再进行分享。