Claude Code + GLM-5.1 全能保姆级攻略：零门槛打造你的私人终端 AI 程序员

倔强的石头_
0 阅读7分钟

虽然目前市面上有诸多 AI 编程辅助工具，但 Anthropic 官方推出的命令行工具 Claude Code 凭借其“终端原生”的特性，依然是目前独一档的“AI 程序员”。它可以直接读取你的本地代码库、自动执行终端命令、自主完成代码修改和运行测试。

然而，原版工具对网络环境要求极高，且官方 API 额度获取困难，直接劝退了大量国内开发者。

今天，我们将通过 蓝耘 MaaS 平台，打破这一壁垒！通过简单的配置，将 Claude Code 的底层模型无缝替换为国内顶尖的 GLM-5.1，零门槛打造你的全能本地编程助手。

8f6573c6cd825f954d2726bf9812a180.png

@[toc]

💡 为什么是“蓝耘 MaaS + GLM-5.1”的黄金组合？

在开始动手前，我们先盘点一下这套方案的绝对优势： image.png

  1. 为什么选择蓝耘 MaaS？

    • 原生级兼容： 蓝耘不仅提供标准的 OpenAI 兼容接口，还提供了完美的 Anthropic 接口兼容（Base URL 甚至可以直接伪装）。这意味着你一行代码都不用改，也无需安装复杂的本地代理插件，就能直接骗过 Claude Code。

    • 高吞吐、低延迟： 终端编程对 AI 的响应速度要求极高。根据 AI Ping 的实测数据，蓝耘 MaaS 平台上的主流模型（如 DeepSeek、GLM 系列）在首字延迟和生成吞吐量上表现优异，告别“打字机”式的便秘感，代码生成如丝般顺滑。

  2. 为什么选择 GLM-5.1？

    • 最新一代的硬核实力： 作为智谱最新的旗舰模型，GLM-5.1 在逻辑推理、代码生成和长上下文理解能力上有了质的飞跃。面对复杂的项目级重构和多文件关联，它能保持极其清晰的思路，是当前国产模型中最适合用于复杂编程任务的基座。

🛠️ 第一阶段：环境准备（新手必看）

由于 Claude Code 是一个基于 Node.js 的命令行工具，在安装它之前，我们需要确保你的电脑环境已就绪：

  1. 安装 Node.js（核心依赖）

    • 要求： 版本号必须 ≥ 18。

    • 操作： 前往 Node.js 官网，下载并安装 LTS（长期支持）版本。

    • 验证： 打开你的终端（Windows 的 CMD/PowerShell，或 Mac 的 Terminal），输入 node -v 和 npm -v。如果能正确返回版本号，则说明安装成功。 image.png

  2. 安装代码编辑器与 Git（推荐）

    • 建议使用 VS Code 作为你的代码编辑器。

    • 建议安装 Git，因为 Claude Code 经常需要借助版本控制来更好地理解项目上下文。

    winget install --id Git.Git -e --source winget

🔑 第二阶段：获取蓝耘“两件套”

接下来，我们需要在蓝耘平台拿到配置所需的名牌：API Key 和 模型名称。

  1. 注册并登录：首先，前往蓝耘官方控制台：蓝耘官网 image.png

  2. 获取 API Key：在左侧导航栏找到 API管理 / 密钥管理，点击"创建 API Key"。 image.png

    💡 注意：复制并保存好生成的 sk-xxxxxxxxxxxxxxxx，它只会显示一次！

  3. 确认模型名称：进入 模型广场，挑选你需要使用的模型并记录下模型调用名称。

    • 在左侧菜单点击【模型广场】，找到最新的 GLM-5.1。 image.png

    • 点击查看详情，你可以看到该模型在蓝耘平台的唯一调用名称为：/maas/zhipuai/GLM-5.1。记下这串字符。

⚙️ 第三阶段：极简配置 Claude Code（核心步骤）

以往的教程通常会教你配置复杂的系统环境变量，不仅容易出错，重启后还可能失效。今天我们使用蓝耘官方推荐的最优雅方式：.claude.json 配置文件注入法。

1. 全局安装 Claude Code

打开终端，输入以下命令进行全局安装：

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

注：Mac/Linux 用户如果遇到权限报错，请在命令前加上 sudo。

安装完成后，输入 claude --version，出现版本号即为成功。 image.png

2. 创建核心配置文件

接下来需要在你的系统用户根目录下创建一个名为 .claude.json 的隐藏文件。

  • Windows 用户路径： C:\Users\你的用户名\.claude.json

  • Mac/Linux 用户路径： ~/.claude.json

使用 VS Code 或任意文本编辑器打开（或新建）这个文件，将以下内容完整复制进去：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "这里替换成你刚才保存的蓝耘API Key",
    "ANTHROPIC_BASE_URL": "https://maas-api.lanyun.net/anthropic",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "/maas/zhipuai/GLM-5.1",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "/maas/zhipuai/GLM-5.1",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "/maas/zhipuai/GLM-5.1"
  },
  "hasCompletedOnboarding": true
}

image.png

这份配置的精妙之处在于：

  1. ANTHROPIC_BASE_URL 直接指向了蓝耘提供的 anthropic 兼容接口路径。

  2. 我们将 Claude Code 默认调用的高中低三档模型，全部强制映射成了蓝耘的 /maas/zhipuai/GLM-5.1。

  3. "hasCompletedOnboarding": true 可以帮你跳过首次使用的繁琐验证流程。

3. 生效与验证

极其重要： 保存文件后，彻底关闭当前的终端窗口，重新打开一个新的终端以确保配置加载。

在新终端输入：

claude

进行连接测试

32b758e440a51987a53f21d865b398af.png

到这里这台终端里的“灵魂”已经成功替换为了蓝耘 GLM-5.1！

🚀 第四阶段：实战演练 —— 用 GLM-5.1 秒写“Markdown 卡片生成器”

是骡子是马，拉出来溜溜。我们用一个非常实用的日常需求——“将 Markdown 文本转换成精美的图片卡片” 来测试一下它的实战能力。

新建一个空文件夹（例如 md-card-app），在终端中进入该目录并输入 claude 唤醒助手，直接抛出我们的需求：

Prompt (提示词):

“帮我用单文件 HTML 的形式，写一个精美的 Markdown 转卡片工具。

需求细节：

  1. 左右分栏布局：左侧是 Markdown 代码输入框，右侧是实时预览的卡片区域。

  2. 样式美化：使用 Tailwind CSS 进行排版，右侧卡片要有好看的渐变背景色和柔和的阴影，整体 UI 偏向现代化设计。

  3. 核心功能：引入 CDN 的 marked.js 来解析 Markdown；引入 html2canvas 实现点击按钮，一键将右侧的卡片保存为 PNG 图片到本地。

  4. 请直接帮我在此目录下创建并写入 index.html 文件。”

体验极速开发： b9d7b3e7f6b8ec64eff4c08ac71dacc7.png

敲下回车后，你能直观地感受到蓝耘 API 的低延迟优势。GLM-5.1 会迅速开始拆解任务，并在终端中显示它的思考过程（Thinking...）。

随后，它会请求执行文件写入操作：

claude is asking to run: echo '...' > index.html

按下 Enter 键批准。 c229e0091b2f574ff4df7f8cacfd7503.png

短短一分钟后，去你的文件夹里双击打开 index.html。一个界面优雅、支持实时预览且能一键导出图片的 Web 应用就诞生了！零手动编码，完全由 AI 独立完成。 3693758ec7731b88dd574ffe3416db3e.png

接下来继续让他完善

我想让这个程序改变功能:markdown文章可以转换为多个卡片，方便发布到社交平台

f62ac3854dc6672b39bfa9d71538762e.png

1f04340817dc6b3ee7e06c36bba87c85.png

image.png

到这里这个小工具已经基本可用了 接下来还可以根据自己的需求灵活调整，我们的Claude Code + 蓝耘 GLM-5.1组合可以快速且准确的完成任务，到这里我们的终极AI编程工具就已经得心应手了

🛡️ 避坑指南与常见问题

如果你在操作中卡壳了，请对照以下几点排查：

  1. 执行 claude 时报错找不到命令？

    • 通常是 Node.js 的全局环境变量没有配置好。建议使用 NVM 管理 Node 版本，或者手动将 npm 的 global 路径加入系统 PATH。

  2. 终端提示检测到无效的 API Key，依然去请求官方接口？

    • 90%的原因是配置文件没写对。 检查 .claude.json 文件路径是否正确（必须在用户根目录下），检查 JSON 格式是否有语法错误（多逗号、少引号），最后确认修改后是否重启了终端。

  3. 安全提示频发？

    • Claude Code 在执行系统命令（如创建文件、运行脚本）时默认会询问你。这是为了安全考虑，建议初学者保持默认。如果信任当前操作，可以直接按回车同意。

总结：

借助蓝耘 MaaS 平台的高性能算力与原生兼容优势，再配合能力全面跃升的 GLM-5.1，我们成功将 Claude Code 驯化为了国内开发者也能轻松驾驭的开发神器。不再受困于网络和高昂的订阅费，赶紧配置起来，享受 AI 带来的开发生产力革命吧！

avatar
文章
阅读
粉丝