跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
编程语言Node.jsAI

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

介绍 Claude Code 的安装配置与实战应用。涵盖基于 Node.js 和原生版的两种安装方式，详细说明了如何配置 API Key 及环境变量以接入国内大模型。通过项目实战案例演示了如何利用其解决 Docker 与本地环境冲突问题，并介绍了在 IDEA、VSCode 及 Cursor 中的集成方法，最后总结了常用命令。

ByteFlow发布于 2026/4/6更新于 2026/9/471 浏览
Claude Code 安装配置与实战应用指南

前言

作为 AI 代码助手，Claude Code 提供了强大的命令行交互能力。本文介绍其安装方式、配置步骤及完整实战项目案例。

一、基础概念解析

1.1、什么是 Claude Code？

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

Claude Code CLI：

在这里插入图片描述

1.2、Claude Code 能干嘛？

【核心能力】

  1. 需求转代码：自然语言描述功能，自动规划、编写并验证多文件代码，适配主流框架。
  2. 调试与修复：分析错误日志/代码库，定位根因并修复（含多文件协调修改），支持测试与构建系统联动。
  3. 代码库导航：全局理解项目结构与依赖，快速解答架构、调用链、接口设计等问题，可关联外部数据源。
  4. 自动化繁琐任务：批量修复 lint、解决 Git 冲突、生成文档/Release Notes，可集成 CI 自动执行。
  5. 工程级修改与重构：跨文件重构、性能优化、代码标准化，遵循团队规范并需显式授权才修改文件。
  6. 集成与协作：对接 GitHub/GitLab，从读取需求到提交 PR 全流程处理，支持 MCP 访问外部数据。
  7. 可以集成各种 MCP，实现自动编写测试用例，自动执行测试用例，生成测试报告；git 代码自动审核，等等

【典型场景】

  • 新功能开发与 Bug 修复
  • 大型项目上手与代码评审
  • 重构老旧系统与批量规范整改
  • CI/CD 流程自动化与 PR 辅助

二、安装 Claude Code

2.1、（方式一）基于 node.js 环境

前提条件：您需要安装 Node.js 18 或更新版本环境。

# 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 没有对国内用户开放。建议配置国内大模型。

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

目录

  1. 前言
  2. 一、基础概念解析
  3. 1.1、什么是 Claude Code？
  4. 1.2、Claude Code 能干嘛？
  5. 二、安装 Claude Code
  6. 2.1、（方式一）基于 node.js 环境
  7. MacOS 用户请使用 nvm 方式安装 Nodejs，若直接安装包安装后续会遇到权限问题
  8. Windows 用户还需安装 Git for Windows 进入命令行界面
  9. 运行如下命令，查看安装结果，若显示版本号则表示安装成功
  10. 2.2、（方式二）不依赖 node.js 环境，原生版（推荐）
  11. 三、配置
  12. 3.1 配置大模型端点和密钥
  13. 1.注册账号
  14. 2.获取 API Key
  15. 3.配置 claude code 环境变量
  16. 4.测试配置：
  17. 5.切换模型（非必要，可跳过）
  18. 6.查看 token 用量
  19. 四、项目实战例
  20. 4.1、实战背景：
  21. 4.2、难点：
  22. 4.3、上 Claude Code：
  23. 五、集成到编辑器内
  24. 5.1 idea 插件式
  25. 5.2 Vscode
  26. 5.3 Cursor
  27. 六、常用命令

更多推荐文章

查看全部
  • OpenClaw 漏洞预警：AI 代理安全审计与日志追溯
  • Coze 长期计划构建 AI 工具榜单整理 Agent 与钉钉自动推送指南
  • Flutter tflite_web 在 OpenHarmony 下的 AI 推理适配与 WebGL 加速实践
  • Flutter 三方库 webfeed 的鸿蒙适配指南：RSS/Atom 解析实战
  • 大模型入门实战：VisualGLM 图文生成与 RAG 知识库问答
  • 深入理解 AI 前端：技术架构与职业前景
  • 中国未来 50 年产业发展趋势：人工智能与大模型技术解析
  • RAG 技术入门：核心原理、优化方案与评估体系详解
  • Whisper-large-v3 部署避坑指南：解决启动、性能与识别率问题
  • Python PyQt6 实战：从零构建简易记事本
  • Git 使用指南：从安装到连接 GitHub
  • 基于比迪丽 AI 模型的龙珠主题短视频创作提效方案
  • VS Code 远程连接服务器后 GitHub Copilot 无法使用及修复方案
  • AI 辅助测试用例生成实战指南
  • 基于 Rokid 灵珠平台构建旅游 AR 智能体
  • Temperature 与 Top-P 参数如何影响大模型 Prompt 输出效果
  • MambaRefine-YOLO：无人机影像双模态小目标检测器
  • [AI工具箱] Vheer：免费、免登录，一键解锁AI绘画、视频生成和智能编辑
  • VSCode 远程 SSH 连接下 Copilot Claude Agent 异常修复
  • Python 入门教程：从基础语法到面向对象编程详解

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online

  • 随机西班牙地址生成器

    随机生成西班牙地址（支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选），支持数量快捷选择、显示全部与下载。 在线工具，随机西班牙地址生成器在线工具，online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online

  • Markdown转HTML

    将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online