Claude Code+GLM 5 安装配置与10个快速上手技巧

你大概率用过或听过Cursor、Trae、Qoder这类AI编程工具吧?其实它们本质上都是"模型包装商"------底层调用的是 ClaudeGPT 的 API,然后在外面套上一层可视化的外壳。

而今天要重点说的Claude Code,是Anthropic官方(也就是开发Claude模型的公司)推出的AI编程工具。和Cursor这类带图形界面的工具不同,它采用纯终端命令行形式,不用额外下载安装繁杂程序,在任何终端里都能直接使用,还能和VSCode、Cursor等IDE无缝集成,效率绝对拉满。

说真的,Claude Code(简称CC)是我2025年最推荐的AI编程产品,没有之一。毕竟,这是 Anthropic 专为自家模型"量身定制"的官方原生工具,在提示词工程和上下文管理方面,它展现出了第三方的"壳"难以企及的深度和优势。

当然,不得不提的是门槛问题。由于 Claude 官方对国内账号的限制严格,直接使用官方账号的难度很高。更稳妥的选择是用中转方案 ,或者直接选用国产大模型 平替。目前国内对Claude Code支持度比较好的国产模型有三个:GLM-5Kimi K2.5MiniMax-M2.5,实测使用体验都很流畅。

接下来,就以GLM-5 (智谱AI) 为例,分享一下,在国内如何在Claude Code接入国产AI大模型。

如果你想接入Kimi K2.5、MiniMax-M2.5等大模型,方法也是一样的

一、Claude Code + GLM-5 安装配置

第1步: Claude Code安装

前提条件:

1、进入命令行界面,安装 Claude Code

复制代码
npm install -g @anthropic-ai/claude-code

如果上述命令,安装没有成功,可以尝试下列这个方法。

2、如果你的电脑是 macOS, Linux,粘贴下述命令,回车

复制代码
curl -fsSL https://claude.ai/install.sh | bash

3、如果你的电脑是 Windows,粘贴这条命令,回车

复制代码
irm https://claude.ai/install.ps1 | iex

4、安装完成后,运行如下命令,查看安装结果,若显示版本号则表示安装成功

复制代码
claude --version

如果您在安装过程中遇到权限问题,请尝试使用 sudo(MacOS/Linux)或以管理员身份运行命令提示符(Windows)重新执行安装命令。

如果,想升级Claude Code版本,可以执行下述命令

bash 复制代码
claude update

第2步:启动Claude Code

打开命令行终端,执行 claude 命令,进入Claude Code,默认是需要登录连接 Claude 账号的,如果你是第一次使用,输入Claude后,大概率会出现下述报错提示。

这个错误最常见的原因是地区限制 。Anthropic 的服务(包括 API 和 Claude Code)目前并不在中国大陆等地区提供官方支持。因此,即使你的网络连接正常,如果从这些地区直接访问,也会被拒绝 。

解决该问题最主要、最有效的方法,可以通过一个能访问 Anthropic 服务的网络节点(代理)来中转你的请求,还可以配置国内大模型的方法来连接使用Claude Code,比如以智谱AI为例。

第3步:准备国内大模型API Key (智谱GLM为例)

具体配置方法:

1、注册账号 :访问 智谱开放平台https://www.bigmodel.cn/glm-coding?ic=OQISQHVSO2),点击右上角的「注册/登录」按钮,按照提示完成账号注册流程。

2、获取API Key :登录后,在个人中心页面,点击 API Keyshttps://bigmodel.cn/usercenter/proj-mgmt/apikeys),创建一个新的 API Key,复制下来备用。

3、订阅一个 Coding 套餐,去年年底有个跨年特惠,强烈推荐这个包季的 Coding Lite,三个月只要 54 块钱,跟不要钱一样。

可以在这里购买:https://www.bigmodel.cn/glm-coding?ic=OQISQHVSO2

如果没有赶上去年底那波白嫖福利,现在的你,就只能勒紧裤腰包,忍痛买个现价的套餐包了,新手可以先尝试买个Coding Lite套餐尝尝鲜(赶紧抢,GLM编码套餐太火爆了,现在智谱官方每天都是限量对外开售的,在官方渠道上有钱也不一定能抢的到哦)--> 如果你实在抢不到,就到万能的闲鱼上找找吧。

第4步:Claude Code 配置智谱GLM

有了 Coding 套餐之后,就可以在Claude Code中配置使用了(主要是配置环境变量)。

通过在 MacOS、LinuxWindows 中使用以下任一种方式设置环境变量:

注意 :设置环境变量时,有些命令不会返回任何输出。这是正常的,只要没有报错即代表成功。
注意:选择以下适合您操作系统的一种方式进行配置即可。

比如,以Windows CMD为例,打开用户目录/.claude/settings.json

复制代码
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your_zhipu_api_key",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  }
}

上述命令执行前,将ANTHROPIC_AUTH_TOKEN替换成你真实的即可,如下图所示:

配置成功后,请确保重新打开一个新的终端窗口,以便环境配置生效。

除了上述通过环境变量设置外,还可以通过安装自动化助手:coding-helper 来自动配置。

Coding Tool Helper 是一个编码工具助手,快速将您的GLM编码套餐 加载到您喜爱的编码工具中。安装并运行它,按照界面提示操作即可自动完成工具安装,套餐配置,MCP服务器管理等。

复制代码
# 进入命令行界面,执行如下运行 Coding Tool Helper
npx @z_ai/coding-helper

配置完成后,进入一个您的代码工作目录,在终端中执行 claude 命令即可开始使用 Claude Code 若遇到「Do you want to use this API key」选择 Yes 即可

启动后选择信任 Claude Code 访问文件夹里的文件,完毕后,就可以正常使用 Claude Code 进行开发了。

官方配置参考手册https://docs.bigmodel.cn/cn/coding-plan/tool/claude

第5步:Claude Code中验证GLM-5基本功能

配置完成后,比如在Claude Code中输入问题 ,测试它的基本功能

温馨提醒: 下述测试所使用的问题,是于2025年底所采用的,如果你需要验证GLM最新的功能,可以按需调整提示词中的问题即可。

让我们依次测试一下,首先是网页搜索能力,验证一下,它能否紧跟时事:

复制代码
第1个问题 :`最近快手发生了什么事?`
复制代码
第2个问题,继续提问:`狂师是谁`
复制代码
第三个问题:测试网页读取能力,让它来读取我们测试开发导航网站的信息:`介绍一下这个网站:testfather.cn`

二、Claude Code 快速上手技巧

上手 Claude Code,要学习的东西很多。

但是最基础只有三件事,核心是理解 CC 的工作原理。

你可以把 CC 理解成一个能操作系统的代理人,它能看到你的电脑、读取文件、操作文件、分析文件、输出文件。

你和它的沟通方式,就是通过自然对话,不需要你写一行代码。

2.1 文件夹

文件夹是 CC 最棒的设计理念,它是 CC 运行的游乐场。

你可以把文件夹理解为是CC的工作空间,是CC执行任务的上下文。

这里,我建议大家,每个任务都建一个单独的文件夹,这样能够保证数据独立、互不干扰。

如何在指定文件夹下启动CC呢?有两种方式:

一是先在命令行定位到新地址后,再输Claude启动CC。

bash 复制代码
cd /你的新文件夹地址

一种是直接在地址栏输"cmd"启动命令行,再输Claude进入。

值得一提的是,CC支持直接拖拽文件夹和文件,你可以把想让它理解的文件夹或文件直接拖到CC的会话框里,然后跟它描述你的任务需求。

比如,让CC帮你翻译解释图片,把图片直接拖给CC,让它来翻译就行了。

2.2 启动claude的几种方式

使用 claude 命令进入项目后,就可以使用 Claude Code 了。

bash 复制代码
# 默认启动
claude

#️ 继续最近的对话
claude --continue

# 可以选择最近的一些对话中的一个开始
claude --resume


#进入 Claude Debug 模式,会打印很多运行时日志
claude --debug
命令格式 日志级别 输出内容 核心用途 适用场景
claude(默认) 最低 仅输出关键必要信息(如启动成功提示、严重错误(Fatal/Error)),无冗余 日常正常使用,快速执行任务 无需排查问题,仅需完成核心功能(如调用接口、生成内容)
claude --verbose 中等 输出详细运行信息(在默认基础上,增加警告(Warning)、关键步骤日志、进度信息、配置加载详情等) 查看程序运行流程,排查简单问题 1. 确认配置是否加载成功;2. 定位简单的运行异常(如参数错误);3. 跟踪任务执行进度
claude --debug 最高 输出最详尽的调试信息 (在 --verbose 基础上,增加底层细节:函数调用栈、变量值、网络请求 / 响应完整内容、内部状态变化、底层组件交互日志等) 深度排查复杂故障、开发调试 1. 排查难以复现的崩溃问题;2. 开发人员调试代码逻辑;3. 定位网络超时、权限异常等复杂底层问题;4. 分析程序性能瓶颈
  1. 日常使用:用 claude(默认),简洁高效,无冗余输出;
  2. 简单排查(如配置 / 参数问题):用 claude --verbose,查看详细运行流程;
  3. 复杂故障排查(如崩溃 / 底层异常):用 claude --debug,获取最详尽的调试日志辅助定位问题;

2.3 Claude.md 文件

首次在新项目中使用 Claude Code 时,可以使用 /init 命令,完后后写入 CLAUDE.md 记忆文件,可以通过上下方向键选择是否直接编辑文件不再询问授权,最终生成一个 CLAUDE.md 项目指南文件。

它会:

  • 分析你的项目结构和主要技术栈。

  • 生成一个 CLAUDE.md 文件,其中包含:

  • 项目概述和架构说明。

  • 代码风格指南和规范。

  • 关键模块和依赖的说明

  • 这个文件就像项目的"大脑",让 Claude Code 在后续对话中拥有持久的项目上下文,大幅提升回答质量

简单来说CLAUDE.md 文件是 Claude Code 自动读取的记忆文件,类似于 Cursor 中 rules 规则文件,但比它要更强大,它可以为 Claude 提供更多项目相关的上下文信息,如:

  • 常用的 bash 命令
  • 核心文件和工具函数
  • 代码风格指南
  • 测试说明
  • 代码库规范
  • 开发环境设置
  • 更多希望 Claude 记住的信息等等

当 Claude Code 启动时,以上所有记忆文件会自动加载到运行环境中。可以在多个位置放置 CLAUDE.md 文件,Claude Code 会递归读取这些文件,从当前工作目录开始,向上递归到根目录,读取找到的任何 CLAUDE.md 文件。

在实际开发项目时,很多人不重视项目记忆文件,每次都要重新解释项目背景。

建议的CLAUDE.md模板示例:

markdown 复制代码
# 项目信息
- 项目名:我的电商网站
- 技术栈:React + Node.js + MongoDB
- 包管理:npm

## 重要提醒
- 不要修改package.json,除非明确需要
- API接口有跨域限制,本地开发需要代理
- 图片上传功能有bug,正在修复中
- 数据库连接配置在.env.local文件中

## 编码规范
- 组件使用函数式 + Hooks
- 所有异步操作必须有错误处理
- 提交前必须通过ESLint检查

## 常用命令
- 启动:npm run dev(端口3000)
- 测试:npm run test
- 构建:npm run build
- 部署:npm run deploy

CLAUDE.md就像给Claude装了个大脑,你的项目规范、常用命令、核心逻辑都可以写进去。Claude会自动加载这些信息,不用每次都从头解释。

另外,CLAUDE.md内容也不宜写的太长,建议控制在1000行以内。

2.4 Claude Code支持三种模式切换

首先,通过一个表格快速了解这三种模式的核心区别,以便你有一个直观的印象。

特性维度 默认模式 (Default Mode) 自动接受编辑模式 (Auto-Accept Edit Mode) 计划模式 (Plan Mode)
核心特点 逐项确认与协作 自动化批处理 只读分析与规划
修改权限 需手动确认每一次编辑 自动应用所有更改 只读模式不会修改任何文件
适用场景 新代码编写、不熟悉的任务、需要严格审查时 已知安全的重构、批量操作、重复性任务 架构分析、方案设计、理解陌生代码、前期规划
工作方式 提议→你批准→执行→提议→你批准... 批量自动执行所有编辑,无需打断 分析→生成方案→你选择执行与否
安全性 最高,完全由你掌控 较低(对任务需有绝对信任) 最高(仅分析不修改)
效率 相对较低,需频繁交互 极高,适合"流水线"作业 高,避免盲目修改和返工
状态指示 通常底部无特殊标记 底部会显示 ⏵⏵ accept edits on 底部会显示 plan mode on

按下 shift + tab 键,可以在一般模式、自动接受编辑、计划模式 之间来回切换。

1、默认模式 (Default Mode)

这是最安全、最基础、也是推荐新手初始使用的模式 。它就像一个严格的审查员 ,Claude 每想修改一个文件或执行一个命令,都会停下来请求你的明确批准

适用场景: 日常问答、代码讨论。

何时使用默认模式?

  • 刚开始使用 Claude Code,还在建立信任的阶段。
  • 对任务本身不熟悉,或者对 Claude 的修改方案不太确定时。
  • 编写新功能、新代码,需要仔细审查每一行代码。
  • 对关键系统、核心业务逻辑进行修改,需要严格把关。
  • 学习和理解代码,想一步步看 Claude 是如何分析和修改的。

⚠️ 注意 :在此模式下,频繁的批准操作可能会打断你的思路 ,效率相对较低。但安全性是它的核心优势

2、自动编辑模式(Auto Edit)

在 Claude Code 中,可以通过按下 shift + tab 键来切换到「自动接受编辑 」功能(auto-accept edits on):

开启此功能后,Claude Code 会自动创建、编辑文件,而不是每次都需要我们手动确认

适用场景: 大范围重构、批量修改

切换方法:Shift+Tab一次

3、计划模式 (Plan Mode)

计划模式它不会修改任何文件 ,而是专注于深入分析你的代码库,理解你的需求,并制定一个详细的、可执行的行动计划。这个计划会以清晰的步骤呈现给你,由你决定是否执行 。

Plan Mode里只会和你讨论需求,不会进行任何代码的修改,可以讨论完成后再切换到自动编辑模式执行。

典型场景

  • 复杂功能开发前,先看计划
  • 大型重构前,先评估影响范围
  • 多步骤任务前,先理清思路

切换方法:Shift+Tab两次

2.5 免授权模式

免授权模式,又叫危险模式,那什么是危险模式呢?

顾名思义,就是一旦打开,CC 可以全自动地操控你的电脑,不需要你的任何确认。这种模式有个好处就是,你给它一个需求,它直接交付结果,你不用去管过程。

听起来很危险,但是不开的话,每次操作都要确认,非常繁琐,非常影响效率。

建议在指定文件夹位置并备份好数据的条件下开启此模式,命令是:

plain 复制代码
claude --dangerously-skip-permissions

带上这个参数启动时,Claude Code 会出现警告提示:

你需要点确认(Yes)才能开启 Bypassing Permissions 模式,开启此模式后,终端下面会出现黄色的 Bypassing Permissions 模式提示:

开启 Bypassing Permissions 模式后,后面所有操作就都不需要你授权了,Claude Code 哐当就把所有活干了。

2.6 执行中断操作

如果在 Claude Code 工作时,有时候可能给的命令描述的不对,如果你想让它停止,只需要按 ESC 键即可,终端上面会显示被用户打断。

简单说,如果你发现Claude干活的方向不对时,按ESC 就会停止任务。

2.7 恢复历史会话

Claude Code 提供两个选项来恢复之前的对话:

  • claude --continue 或者 claude -c:自动继续最近的对话,无需任何提示。
  • claude --resume 或者 claude -r:显示历史对话选择器;

这两个带参数的命令需要在「非交互模式」下进行,也就是还没有进入 Claude Code。

1、非交互模式

通过claude --continue 恢复最近对话时,需要先切换到对应的项目目录下,再执行恢复命令。(不同项目目录最近对话会不一样)

输入如下命令,可自动继续最近的对话,无需任何提示

复制代码
#️ 继续最近的对话
claude --continue
# 或者
claude -c

如果你需要显示历史对话选择器,从最近的一些对话中选择一个开始,则执行下述命令

bash 复制代码
# 可以选择最近的一些对话中的一个开始
claude --resume
# 或者
claude -r

上下方向箭可以选择其中一个对话,按P键可以预览对话内容。

2、交互模式

如果你已经进入了 Claude Code 会话,想恢复到之前的哪个历史会话,可以使用 /resume 命令恢复历史会话:

上下方向键选中一条记录可以恢复会话。

2.8 上下文压缩

对话历史会累积消耗 token,成本呈指数增长:

Claude Code 提供了一个 /compact 压缩命令,它会清除对话历史记录,但保留上下文中的摘要。

这样做的好处是:

  • 减少对话上下文大小 :当对话历史变得很长时,使用 /compact 可以压缩对话内容,减少令牌使用量。
  • 手动压缩控制 :虽然 Claude Code 默认在上下文超过 95% 容量时自动压缩(可通过 /config 开启/关闭自动压缩),但你可以使用 /compact 手动触发压缩。

什么时候用?

  • 对话记录超过100轮
  • 感觉Claude回复变慢
  • 切换到新任务之前

所以,为了有效管理成本和性能:

  • 建议在上下文变大时定期使用 /compact 手动进行压缩;
  • 定时使用 /clear 命令重置上下文;
  • 分解复杂任务或者把需求尽量具体化;

2.9 改错了怎么办

别慌,Claude Code 有「时光机」功能。

方法一:按 ESC 两次

快速回退到上一个版本

方法二:输入命令

plain 复制代码
/rewind

Claude 会列出历史版本,你可以选择回到哪个时间点

方法三:直接说

「刚才那个改动我不喜欢,还原回去」

上述的几种方法,只是用来救急,用于恢复最近一次的变动,但如果你想恢复到之前指定的某一个时间点,上述的方法不一定有效,所以更为建议的方法是,在每次用AI修改好的功能,一定要及时用git进行版本管理,方便后续回溯,即便AI把最新代码搞坏了,也可以通过git恢复。

2.10 Claude Code发送图片技巧

有了 CC 后,你遇到任何问题都可以直接问它。但是有些问题需要图片,你就需要把图片粘贴到 CC 里面。

Claude Code支持上传图片,虽然跑在命令行里面,但是可以向对话中添加图片!

Claude Code 不仅能理解代码,还能"看懂"图片!在命令行中,把图片和提示词发过去,让它更好的理解你的意图。

典型场景

  • 截图界面让AI复刻UI
  • 上传架构图让AI理解系统设计
  • 粘贴错误截图快速Debug

使用方法

  1. 截图粘贴: Ctrl+V直接粘贴截图,复制图片,然后使用 Ctrl + V 将其粘贴到 CLI 中(不是 Cmd + V)。
  2. 拖拽上传: 直接把图片拖到终端,将图片拖放到 Claude Code 窗口中。

注意,在 Mac 中粘贴图片不是使用 command + v,而是使用 ctrl + v 快捷键。

三、最后

上面的步骤只是你开启AI编程工作学习的一个开始,未来还有很多东西要学。

万事开头难,这篇文章其实是最难的部分,后续你遇到任何问题,直接问 Claude Code ,它都能帮你解决。

最后,我想纠正一个常见的认知:虽然它名字叫"Claude Code",但它的能力绝不仅仅止步于写代码。在实际使用中,它更像是一款真正意义上的通用 Agent

AI 编程的效果,往往取决于"工具"与"模型"的双重配合。而在"工具"这一维度,Claude Code 对上下文的理解能力和工程化水准,目前确实是业内的天花板。