🤖 + 🧠

Claude Code x 智谱 GLM

国内开发者降本增效的最佳实践指南

💲 成本降低

比官方 API 便宜 90%

🚀 网络直连

无需特殊网络环境

⚡️ 官方体验

原生 CLI + 插件支持

👉 点击屏幕任意位置开始演示

第一步：核心安装与配置

1. 安装官方 CLI

首先获取 Anthropic 的官方工具：

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

BASH

2. 智谱助手一键配置 (推荐)

使用 Coding Tool Helper 自动注入环境变量：

npx @z_ai/coding-helper

BASH

💡 提示：运行前请先去智谱开放平台 (点击跳转) 申请 API Key。

🔧 底层原理

助手会自动修改 ~/.claude/settings.json：

BASE_URL ➔ 指向智谱 API
AUTH_TOKEN ➔ 注入你的智谱 Key
Network ➔ 禁用非必要流量检查

⚠️ 关键避坑：手动配置

如果助手运行失败，或者启动卡死，请检查以下文件：

配置文件 A: settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  }
}

JSON

配置文件 B: .claude.json (必做!)

🔥 解决“初始化卡死”的关键：

{ "hasCompletedOnboarding": true }

手动添加此行，跳过官方的网络检测和新手引导。

第二步：IDE 集成 (VS Code)

在编辑器中直接使用 Claude Code，无需频繁切换终端。

📦 安装插件

搜索 "Claude Code" (官方版)

安装后，插件会自动读取 CLI 的配置（即智谱的代理配置）。

🚫 绕过登录验证 (Critical)

默认情况下，插件会弹窗要求登录 Anthropic 账号。

必须执行的操作：

1. 点击插件图标打开对话窗口

2. 输入命令：

/config

3. 勾选：Disable Login Prompt

不勾选此项，插件将无法连接智谱 GLM。

进阶功能：Agent Skills (技能)

不要每次都写 Prompt。把你的工作流封装成“技能包”。

📂

标准目录结构 (4个要素)

my-skill-name/
├── SKILL.md        # [核心] 定义技能的元数据和指令
├── scripts/        # [可选] Python/Bash 自动化脚本
├── references/     # [可选] 供 AI 查阅的详细文档
└── assets/         # [可选] 模板文件、图片资源等
                        

编写规范：SKILL.md

一个文件，两部分内容。

Part 1: YAML 头 (索引)

---
name: generate-api-docs
description: 为 Python 项目生成 Swagger 文档。
  当用户请求“生成 API 文档”时使用。
---

YAML

Claude 通过 description 决定是否通过“触发词”调用此技能。

Part 2: Markdown 体 (大脑)

# API 文档生成指南

步骤：
1. 扫描 `src/` 目录。
2. 提取 Docstring 注释。
3. 运行 `scripts/validate.py` 校验。
...

MARKDOWN

具体的执行逻辑和步骤说明。

总结与最佳实践

🛠️ 工具链

CLI + 智谱助手

VS Code 插件 + 免登录配置

🧠 模型策略

默认映射 GLM-4.7

同时接管 Sonnet 4.5 / Opus

适合复杂编程任务

⚡️ 提效技巧

使用 Skills 固化流程

常用命令：

claude --yolo

(跳过确认直接执行)