Claude Code安装指南

Claude Code 安装指南 —— 保姆级新手安装教程

Claude Code：是由Anthropic公司推出的一款终端原生（Terminal-native）的 AI 编程助手。它并非一个集成在 IDE 中的插件，而是一个独立的命令行工具，旨在通过自然语言指令，在终端环境中自主完成从需求到部署的完整开发任务。

1. Claude Code简介

Claude Code的核心定位是Agentic(代理式)工具，这使其与传统 AI 编程插件有本质区别。它不仅仅是代码建议者，更是任务执行者。你只需给出一个高层级的自然语言指令（例如“为这个模块添加 JWT 认证并编写单元测试”），它会自主规划、分解并执行一系列步骤来完成任务。

1.1 主要特性

• 强大的全库代码理解能力：启动时，Claude Code 会主动探索并理解整个项目的结构、依赖关系和技术栈。它拥有约 200K token 的超大上下文窗口，能够一次性处理大量代码，精准定位跨文件的调用和修改点，非常适合处理大型项目重构或理解复杂的“祖传代码”。
• 自主的工程化能力：它可以直接在你的终端环境中执行多种操作，形成一个完整的开发闭环：
  • 文件操作： 读取、创建、编辑和批量修改文件。
  • 代码检索： 内置基于 ripgrep 的快速搜索功能。
  • 终端执行： 运行 Shell 命令、编译、调试、安装依赖、执行测试等。
  • Git 集成： 自动创建分支、提交代码、编写 commit message，甚至可以发起 Pull Request。
• 丰富的扩展架构：Claude Code 提供了三套扩展机制，使其能力边界非常灵活：
  • MCP (模型上下文协议): 一个标准化的“万能插排”，可以连接数据库、内网服务、云资源或任何自定义工具。
  • Skills (技能): 可复用的工作流封装，你可以将它理解为给 AI 的“专业技能证书”。例如，可以创建一个“React 性能优化”技能，让 AI 在编写前端代码时自动遵循最佳实践。
  • Plugins (插件): 兼容 VSCode 等编辑器插件生态，实现终端与 IDE 的联动。
• 高度的可配置性与可控性
  • CLAUDE.md 配置文件： 你可以在项目根目录创建此文件，用于定义项目规范、技术栈、常用命令和编码风格。Claude Code 会在每次会话时自动读取并遵循这些规则，确保生成的代码符合项目要求。
  • 安全权限控制： 采用分级权限管理，默认对文件只有只读权限，在执行修改、运行命令等高风险操作前会请求用户确认，确保操作安全可控。
• 终端优先，环境无关：它不依赖任何特定的 IDE，可以在任何终端、服务器、WSL 或远程开发环境中无缝使用，也可以被脚本化并集成到 CI/CD 流程中。

2. 下载和安装

推荐采用npm的方式安装

2.1 前置环境

在正式安装 Claude Code的之前，请先安装如下列表：

• nodejs：
  • 点击链接下载nodejs，选择LTS长期维护版本。
• git：
  • 点击链接下载git，选择对应的系统平台。

2.2 正式安装

Claude Code 支持主流操作系统，安装非常便捷：

2.2.1 macOS / Linux：

curl-fsSLhttps://claude.ai/install.sh|bash

2.2.2 Windows：

irm https://claude.ai/install.ps1|iex

• 或者使用 WinGet方式：

wingetinstallAnthropic.ClaudeCode

• 或者使用npm的方式，执行完成之后，安装的目录在：C:\Users\qtz\AppData\Roaming\npm\node_modules\@anthropic-ai

npminstall-g@anthropic-ai/claude-code

2.3 验证安装

上述安装完成之后，输入以下命令，查看版本号：claude --version

2.4 安装过程中的错误

如果在执行 npm 方式安装时候，报该错误：TypeError: Object not disposable，是因为你当前的 Node.js 版本过低导致的。Claude Code 使用了 ECMAScript 2024 标准中的新特性（Symbol.dispose），而旧版本的 Node.js（特别是 v18.x 系列）无法识别这些特性，从而引发报错。

• 使用 node -v 来查看版本
• 下载 nodejs 最新版，然后运行安装，会自动卸载旧版本

3. 启动 Claude Code

打开终端，输入 claude 回车即可。

3.1 Unable to connect to Anthropic services

在开始第一次运行时候，一般都会报如下错误：
Unable to connect to Anthropic services Failed to connect to api.anthropic.com: ERR_BAD_REQUEST

3.1.1 处理方式

该错误表示：Claude Code 正在尝试直接连接 Anthropic 的官方服务器，但因为网络限制或配置错误，连接被拒绝了。要解决这个问题，通常最有效的方案：“跳过引导检查”（最快，如果你已有配置），我们打开配置文件.claude.json（例如：C:\Users\qtz\.claude.json），增加如下配置：

"hasCompletedOnboarding": true

3.2 Not logged in · Run /login

当我们第二次启动时候，又发现提示如下信息：Not logged in · Run /login。说明 Claude Code 已经成功安装，但还没有进行账户授权。这通常有两种情况：一种是使用官方的 Claude 账户，另一种是通过配置第三方 API 来使用。

3.2.1 处理方式

我们采用配置国内的大模型 ：deepseek来处理。

3.2.1.1 创建API key

• 打开deepseek，点击API开发平台。点击创建 API key ，创建完成后，请保存好生成的key。
  

3.2.1.2 安装CC Switch

• 点击下载CC Switch。找到Releases 页。
  
• 在Releases页面选择对应系统平台的版本，然后双击安装即可。
  

3.1.2.3 配置deepseek

• 将之前保存好的API key填写到下面截图种，请求地址不用改动即：https://api.deepseek.com/anthropic
  

• 选用deepseek模型：deepseek-v4-pro或deepseek-v4-flash，配置完点击保存即可
  

• 启用deepseek：回到主界面，点击启用deepseek。
  

• 启用操作会修改配置文件C:\Users\qtz\.claude\settings.json的配置文件，改成如下格式：

{"env":{"ANTHROPIC_BASE_URL":"https://api.deepseek.com/anthropic","ANTHROPIC_AUTH_TOKEN":"sk-xxxxxxxxxxxxxxxxxxxxxx","ANTHROPIC_MODEL":"deepseek-v4-pro","ANTHROPIC_DEFAULT_HAIKU_MODEL":"deepseek-v4-pro","ANTHROPIC_DEFAULT_SONNET_MODEL":"deepseek-v4-pro","ANTHROPIC_DEFAULT_OPUS_MODEL":"deepseek-v4-pro"},"includeCoAuthoredBy":false}

3.3 再次启动Claude Code

• 此时，我们可以发现，claude code已经完美运行了，恭喜你。

3.4 启动界面的信息说明

在上述界面中，右边的提示信息的含义：你看到的这段信息是Claude Code 刚刚完成了一次版本更新的提示。这并非错误报告，而是更新日志（Changelog），告诉你本次版本修复了哪些问题。

• What’s new：新功能
• Internal fixes：内部修复
• [VSCode] Fixed extension failing to activate on Windows：[VSCode] 修复了在 Windows 系统上扩展程序无法激活的问题。
• Added CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL to re-enable the sess…：添加了CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL环境变量，以重新启用会话反馈调查。
  • /release-notes for more：输入/release-notes命令可以查看更多更新详情。
  

END