你大概率用过或听过Cursor、Trae、Qoder这类AI编程工具吧?其实它们本质上都是“模型包装商”——底层调用的是 Claude 或 GPT 的 API,然后在外面套上一层可视化的外壳。
而今天要重点说的Claude Code,是Anthropic官方(也就是开发Claude模型的公司)推出的AI编程工具。和Cursor这类带图形界面的工具不同,它采用纯终端命令行形式,不用额外下载安装繁杂程序,在任何终端里都能直接使用,还能和VSCode、Cursor等IDE无缝集成,效率绝对拉满。
说真的,Claude Code(简称CC)是我2025年最推荐的AI编程产品,没有之一。毕竟,这是 Anthropic 专为自家模型“量身定制”的官方原生工具,在提示词工程和上下文管理方面,它展现出了第三方的“壳”难以企及的深度和优势。
当然,不得不提的是门槛问题。由于 Claude 官方对国内账号的限制严格,直接使用官方账号的难度很高。更稳妥的选择是用中转方案,或者直接选用国产大模型平替。目前国内对Claude Code支持度比较好的国产模型有三个:GLM-5、Kimi K2.5和MiniMax-M2.5,实测使用体验都很流畅。
接下来,就以GLM-5 (智谱AI) 为例,分享一下,在国内如何在Claude Code接入国产AI大模型。
如果你想接入Kimi K2.5、MiniMax-M2.5等大模型,方法也是一样的
一、Claude Code + GLM-5 安装配置
第1步: Claude Code安装
前提条件:
- 您需要安装 Node.js 18 或更新版本环境
- Windows 用户还需安装 Git for Windows
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、安装完成后,运行如下命令,查看安装结果,若显示版本号则表示安装成功如果您在安装过程中遇到权限问题,请尝试使用 sudo(MacOS/Linux)或以管理员身份运行命令提示符(Windows)重新执行安装命令。
如果,想升级Claude Code版本,可以执行下述命令
第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 Keys(https://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、Linux 或 Windows 中使用以下任一种方式设置环境变量:
注意:设置环境变量时,有些命令不会返回任何输出。这是正常的,只要没有报错即代表成功。
注意:选择以下适合您操作系统的一种方式进行配置即可。
比如,以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最新的功能,可以按需调整提示词中的问题即可。
让我们依次测试一下,首先是网页搜索能力,验证一下,它能否紧跟时事:- 第三个问题:测试网页读取能力,让它来读取我们测试开发导航网站的信息:`介绍一下这个网站:testfather.cn`
复制代码
二、Claude Code 快速上手技巧
上手 Claude Code,要学习的东西很多。
但是最基础只有三件事,核心是理解 CC 的工作原理。
你可以把 CC 理解成一个能操作系统的代理人,它能看到你的电脑、读取文件、操作文件、分析文件、输出文件。
你和它的沟通方式,就是通过自然对话,不需要你写一行代码。
2.1 文件夹
文件夹是 CC 最棒的设计理念,它是 CC 运行的游乐场。
你可以把文件夹理解为是CC的工作空间,是CC执行任务的上下文。
这里,我建议大家,每个任务都建一个单独的文件夹,这样能够保证数据独立、互不干扰。
如何在指定文件夹下启动CC呢?有两种方式:
一是先在命令行定位到新地址后,再输Claude启动CC。
一种是直接在地址栏输“cmd”启动命令行,再输Claude进入。
值得一提的是,CC支持直接拖拽文件夹和文件,你可以把想让它理解的文件夹或文件直接拖到CC的会话框里,然后跟它描述你的任务需求。
比如,让CC帮你翻译解释图片,把图片直接拖给CC,让它来翻译就行了。
2.2 启动claude的几种方式
使用 claude 命令进入项目后,就可以使用 Claude Code 了。
- # 默认启动
- 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. 分析程序性能瓶颈
- 日常使用:用 claude(默认),简洁高效,无冗余输出;
- 简单排查(如配置 / 参数问题):用 claude --verbose,查看详细运行流程;
- 复杂故障排查(如崩溃 / 底层异常):用 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模板示例:- # 项目信息
- - 项目名:我的电商网站
- - 技术栈: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 可以全自动地操控你的电脑,不需要你的任何确认。这种模式有个好处就是,你给它一个需求,它直接交付结果,你不用去管过程。
听起来很危险,但是不开的话,每次操作都要确认,非常繁琐,非常影响效率。
建议在指定文件夹位置并备份好数据的条件下开启此模式,命令是:- 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
复制代码
如果你需要显示历史对话选择器,从最近的一些对话中选择一个开始,则执行下述命令- # 可以选择最近的一些对话中的一个开始
- 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 两次
快速回退到上一个版本
方法二:输入命令Claude 会列出历史版本,你可以选择回到哪个时间点
方法三:直接说
「刚才那个改动我不喜欢,还原回去」
上述的几种方法,只是用来救急,用于恢复最近一次的变动,但如果你想恢复到之前指定的某一个时间点,上述的方法不一定有效,所以更为建议的方法是,在每次用AI修改好的功能,一定要及时用git进行版本管理,方便后续回溯,即便AI把最新代码搞坏了,也可以通过git恢复。
2.10 Claude Code发送图片技巧
有了 CC 后,你遇到任何问题都可以直接问它。但是有些问题需要图片,你就需要把图片粘贴到 CC 里面。
Claude Code支持上传图片,虽然跑在命令行里面,但是可以向对话中添加图片!
Claude Code 不仅能理解代码,还能"看懂"图片!在命令行中,把图片和提示词发过去,让它更好的理解你的意图。
典型场景:
- 截图界面让AI复刻UI
- 上传架构图让AI理解系统设计
- 粘贴错误截图快速Debug
使用方法
- 截图粘贴: Ctrl+V直接粘贴截图,复制图片,然后使用 Ctrl + V 将其粘贴到 CLI 中(不是 Cmd + V)。
- 拖拽上传: 直接把图片拖到终端,将图片拖放到 Claude Code 窗口中。
注意,在 Mac 中粘贴图片不是使用 command + v,而是使用 ctrl + v 快捷键。
三、最后
上面的步骤只是你开启AI编程工作学习的一个开始,未来还有很多东西要学。
万事开头难,这篇文章其实是最难的部分,后续你遇到任何问题,直接问 Claude Code ,它都能帮你解决。
最后,我想纠正一个常见的认知:虽然它名字叫“Claude Code”,但它的能力绝不仅仅止步于写代码。在实际使用中,它更像是一款真正意义上的通用 Agent。
AI 编程的效果,往往取决于“工具”与“模型”的双重配合。而在“工具”这一维度,Claude Code 对上下文的理解能力和工程化水准,目前确实是业内的天花板。
来源:程序园用户自行投稿发布,如果侵权,请联系站长删除
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作! |