前言
作为 Cursor 的用户，最近使用 Claude Code 后发现其功能强大。本文提供从安装、配置到实战的详细教程，包含安装方式、配置步骤和完整实战项目案例。
一、基础概念解析
1.1 什么是 Claude Code？
| 概念 | 核心定义 | 核心用途 |
|---|---|---|
| Claude Code | Anthropic 推出的 AI 代码助手（Claude 大模型的代码专项版本），支持代码生成/调试/重构/解释，兼容多语言。 | 图形化/界面化使用 AI 写代码、查 Bug、优化逻辑，适合可视化操作的场景。 |
| Claude Code CLI | Claude Code 的命令行工具（Command Line Interface），无图形界面，纯终端交互。 | 集成到开发流程（如脚本/CI/CD）、服务器/无界面环境使用，支持批量代码处理。 |
Claude Code CLI：
1.2 Claude Code 能干嘛？
【核心能力】
- 需求转代码：自然语言描述功能，自动规划、编写并验证多文件代码，适配主流框架。
- 调试与修复：分析错误日志/代码库，定位根因并修复（含多文件协调修改），支持测试与构建系统联动。
- 代码库导航：全局理解项目结构与依赖，快速解答架构、调用链、接口设计等问题，可关联外部数据源。
- 自动化繁琐任务：批量修复 lint、解决 Git 冲突、生成文档/Release Notes，可集成 CI 自动执行。
- 工程级修改与重构：跨文件重构、性能优化、代码标准化，遵循团队规范并需显式授权才修改文件。
- 集成与协作：对接 GitHub/GitLab，从读取需求到提交 PR 全流程处理，支持 MCP 访问外部数据。
- 可以集成各种 MCP，实现自动编写测试用例，自动执行测试用例，生成测试报告；git 代码自动审核等。
【典型场景】
- 新功能开发与 Bug 修复
- 大型项目上手与代码评审
- 重构老旧系统与批量规范整改
- CI/CD 流程自动化与 PR 辅助
二、安装 Claude Code
2.1 方式一：基于 Node.js 环境
前提条件：您需要安装 Node.js 18 或更新版本环境。安装教程 https://nodejs.org/en/download/ MacOS 用户请使用 nvm 方式安装 Nodejs，若直接安装包安装后续会遇到权限问题。 Windows 用户还需安装 Git for Windows 进入命令行界面。
npm install -g @anthropic-ai/claude-code
运行如下命令，查看安装结果，若显示版本号则表示安装成功：
claude --version
2.2 方式二：不依赖 Node.js 环境，原生版（推荐）
CMD 命令行执行：
winget install Anthropic.ClaudeCode
注意：安装完毕后，需要执行一下 claude 命令（它会初始化一些配置文件）。
三、配置
Claude Code 内置了大模型（收费），且 Anthropic 没有对国内用户开放。以下介绍如何配置国内大模型。
智谱 GLM Coding 模型 Claude Code、Cline 等 20+ 大编程工具无缝支持，'码力'全开。 链接：https://www.bigmodel.cn/glm-coding
3.1 配置大模型端点和密钥
1. 注册账号
通过提供的链接注册。
2. 获取 API Key
密钥示例：d4fd383aadfe4f7ca329cdffcxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
3. 配置 claude code 环境变量
- 支持 MacOS & Linux & Windows，注意不同系统配置文件路径不一样。注意需保证修改的 JSON 文件格式正确性。
- 编辑或新增
settings.json文件。 - MacOS & Linux 为
~/.claude/settings.json。 - Windows 为
用户目录/.claude/settings.json。 - 新增或修改里面的 env 字段。
- 注意替换里面的
your_zhipu_api_key为您上一步获取到的 API Key。
{"env":{"ANTHROPIC_AUTH_TOKEN":"your_zhipu_api_key_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","ANTHROPIC_BASE_URL":"https://open.bigmodel.cn/api/anthropic","API_TIMEOUT_MS":"3000000","CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC":1}}
- 再编辑或新增
.claude.json文件。 - MacOS & Linux 为
~/.claude.json。 - Windows 为
用户目录/.claude.json。 - 新增
hasCompletedOnboarding参数。
{"hasCompletedOnboarding":true}
4. 测试配置
开始使用 Claude Code。配置完成后，进入一个您的代码工作目录，在终端中执行 claude 命令即可开始使用 Claude Code。若遇到「Do you want to use this API key」选择 Yes 即可。启动后选择信任 Claude Code 访问文件夹里的文件。
配置错误会显示：
配置正确会显示：
5. 切换模型（非必要，可跳过）
如何切换使用模型：
{"env":{"ANTHROPIC_DEFAULT_HAIKU_MODEL":"glm-4.5-air","ANTHROPIC_DEFAULT_SONNET_MODEL":"glm-4.7","ANTHROPIC_DEFAULT_OPUS_MODEL":"glm-4.7"}}
启动一个新的命令行窗口，运行 claude 启动 Claude Code，在 Claude Code 中输入 /status 确认模型状态：
6. 查看 token 用量
四、项目实战例
题外话：如何导入项目？不需要导入项目，在 cmd 黑窗口进入到项目目录执行 claude 就行。
4.1 实战背景
GitHub 多维表开源项目 Apitable，一共有 5 个服务，全部服务在 Docker 里跑起来，系统是正常的。此时想对后台服务 backend-server-1 停止掉，并在 IDEA 编辑器里运行，且二次开发，第一步就难住了。
出现一个奇怪的问题，项目正常启动，能连上 room 服务的 Socket，操作数据的时候就会断开连接。
4.2 难点
- 项目是陌生的项目。快速部署，快速上手。
- 该配置的都配置了。
- 奇怪的是 Docker 跑起来，可以正常的用；本地编辑器能跑起来，功能用不了。
- 针对陌生项目，如何快速定位问题？
4.3 上 Claude Code
模拟对话过程：
【我】: room-server-1 backend-server-1 imageproxy-server-1 databus-server-1 minio 1、这 5 个服务都启动在 docker 上，页面启动在我的 idea 编辑器起里，他是正常的，2、如果我的 backend-server-1 在 docker 停掉，我在我的编辑器里启动 backend-server-1，连接 url: ${SOCKET_URL:http://localhost:3002}第一次连接是正常的，后面就连接失败，为什么？我应该怎么改
【Claude】: 可能是连接时间不够，从 3 秒改到 5 秒，需要我帮你改吗？YES？NO？
-----------------------------------
【我】:YES，还是不行，再帮我看看
【Claude】:可能是网络的问题，需要我帮你看看网络吗？YES？NO？
-----------------------------------
【我】:YES
【Claude】:开始检查网络（包括端口，防火墙，域名...等等）网络没有问题，可能是 socket 客户端和服务端版本不一致，需要我帮你检测一下吗？
-----------------------------------
【我】:YES
【Claude】:找到了！版本不一致，需要我帮你改了吗？
-----------------------------------
【我】:YES，还是不行！
【Claude】:我帮你看看 room 服务的日志，稍等，日志没有报错。需要我帮你看看 room 源代码吗？
-----------------------------------
【我】:YES
【Claude】:找到了！room 服务 socket 通讯用的是 docker 容器名，不是 ip。需要帮你改吗？
-----------------------------------
【我】:YES，可以了！真棒！
下面是完整对话过程:
问题：
已解决：
五、集成到编辑器内
5.1 IDEA 插件式
打开 JetBrains IDE（如 IntelliJ IDEA、PyCharm 等），进入插件市场，搜索「Claude Code」插件并进行安装。
安装完成后，重启 IDE 即可使用 Claude Code 功能。
5.2 VSCode
Claude Code VSCode 插件支持在 VSCode 及基于 VSCode 的 IDE（如 Cursor、Trae 等）中使用。 打开 VSCode，进入扩展市场，搜索并安装「Claude Code」插件进行安装。
安装完成后，点击如下图中的右上角 Claude Code 图标，即进入 Claude Code 页面，在登录页面等待几秒待其初始化完成后即可使用。
成功进入 Claude Code 对话框后，在对话框输入 /config 进入设置，勾选 Disable Login Prompt 配置来关闭登录页面。
完毕！现在就可以在 IDE 中正常使用 Claude Code 进行开发了。
5.3 Cursor
在 Cursor 中使用 GLM Coding Plan 的方法。 将 GLM-4.7 模型通过 OpenAI 协议在 Cursor 中自定义配置模型接入使用。 注意：由于 Cursor 的限制，只有订阅了 Cursor 高级会员及以上的用户才支持自定义配置模型。若非 Cursor 高级会员，配置后会报错 The model GLM does not work with your current plan or api key.
-
安装 Cursor 访问 Cursor 官网下载并安装适合您的操作系统的版本。
-
保存并切换模型 配置完成后，保存设置并在主页上选择您刚创建的 GLM-4.7 Provider。
开始使用 通过该设置，您可以开始使用 GLM-4.7 模型进行代码生成、调试、任务分析等工作。
创建新 Provider/Model 在 Cursor 中，打开'Models'部分，并点击'Add Custom Model'按钮。
选择 OpenAI 协议。 配置 OpenAI API Key（从智谱开放平台获取）。 在 Override OpenAI Base URL 中，将默认 URL 替换为 GLM-4.7 的接口地址：https://open.bigmodel.cn/api/coding/paas/v4。 输入您希望使用的模型，如 GLM-4.7, GLM-4.6 或 GLM-4.5-air。 注意：在 Cursor 中，需要输入模型的大写名称不能小写名称，如 GLM-4.7。
六、常用命令
/clear：清理上下文 /compact：压缩上下文 @xxx：指定文件
上下文管理： 核心用 /clear（重置）、/compact（压缩），辅助用 /ls（查看已加载文件）。
文件操作： @文件名（指定文件）是高频简写，/load//unload 用于精准管理文件加载。
代码核心操作： /run（执行）、/fix（修复）、/refactor（重构）是写代码时最常用的功能命令。
