Claude Code 安装配置与实战教程

前言

作为 AI 代码助手，Claude Code 提供了强大的命令行交互能力。本文介绍从安装、配置到 IDE 集成及实战应用的全过程。

一、基础概念解析

1.1 什么是 Claude Code？

概念	核心定义	核心用途
Claude Code	Anthropic 推出的 AI 代码助手（Claude 大模型的代码专项版本），支持代码生成/调试/重构/解释，兼容多语言。	图形化/界面化使用 AI 写代码、查 Bug、优化逻辑，适合可视化操作的场景。
Claude Code CLI	Claude Code 的命令行工具（Command Line Interface），无图形界面，纯终端交互。	集成到开发流程（如脚本/CI/CD）、服务器/无界面环境使用，支持批量代码处理。

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 或更新版本环境。

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

运行如下命令，查看安装结果，若显示版本号则表示安装成功：

claude --version

2.2 方式二：不依赖 Node.js 环境，原生版（推荐）

在 cmd 命令行执行：

winget install Anthropic.ClaudeCode

注意：安装完毕后，需要执行一下 claude 命令（它会初始化一些配置文件）。

三、配置

Claude Code 内置了大模型（收费），且 Anthropic 没有对国内用户开放。建议配置国内大模型服务。

3.1 配置大模型端点和密钥

1. 注册账号

通过相关平台注册账号。

2. 获取 API Key

在控制台获取 API Key。

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",
    "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 命令即可开始使用。

若遇到「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（重构）是写代码时最常用的功能命令。

Claude Code 安装配置与实战教程