Claude Code 安装配置与实战应用指南

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

cmd 命令行执行：

winget install Anthropic.ClaudeCode

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

三、配置

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

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、难点：

1. 项目是陌生的项目。快速部署，快速上手。
2. 该配置的都配置了。
3. 奇怪的是 docker 跑起来，可以正常的用；本地编辑器能跑起来，功能用不了。
4. 针对陌生项目，如何快速定位问题？

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.

1. 安装 Cursor 访问 Cursor 官网下载并安装适合您的操作系统的版本。
2. 保存并切换模型 配置完成后，保存设置并在主页上选择您刚创建的 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（重构）是写代码时最常用的功能命令。