大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



最后更新：2026年4月

• 一、什么是 Claude Code
• 二、系统要求与环境准备
• 三、安装 Claude Code（推荐方式）
• 四、首次启动与认证
• 五、基础使用指南
• 六、高级配置与实用技巧
• 七、常见问题排查
• 八、参考资源

---

Claude Code 是 Anthropic 官方推出的终端 AI 编程助手，可以直接在命令行中与 Claude 大模型对话，帮助你写代码、改 Bug、分析项目、执行文件操作等。

核心特点：

• 直接操作文件：可读取、创建、修改项目中的代码文件
• 理解项目上下文：自动分析项目结构
• 执行终端命令：可运行构建、测试等 shell 命令
• 集成 IDE：支持 VS Code 扩展，在编辑器中直接使用

Claude Code 现已支持 Windows 原生运行，无需配置 WSL。

---

2.1 系统要求

2.2 安装 Git for Windows（必需）

Claude Code 在 Windows 上依赖 Git Bash 来执行 shell 命令，因此必须先安装 Git for Windows。

安装步骤：

1. 访问 https://git-scm.com/download/win，下载安装包
2. 双击运行安装程序，一路点 Next 使用默认选项即可
3. 安装完成后验证：

   git –version 

看到类似 git version 2.51.0.windows.1 的输出说明安装成功。

提示：你也可以使用 winget 命令安装：winget install Git.Git –source winget

---

原生安装器是官方推荐的方式，不需要 Node.js，安装后会自动后台更新。

3.1 方式一：PowerShell 一键安装（推荐）

以普通用户身份打开 PowerShell（不需要管理员权限），运行：

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

等待安装完成即可。

3.2 方式二：CMD 安装

打开 CMD 命令提示符，运行：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd 

3.3 方式三：npm 安装（备选）

如果原生安装器因网络等原因无法使用，可以用 npm 方式安装。此方式需要先安装 Node.js（版本 ≥ 18）。

1. 从 https://nodejs.org/ 下载 LTS 版，双击安装
2. 验证 Node.js 安装：

   node –version npm –version 

3. 全局安装 Claude Code：

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

   警告：正确的包名是 @anthropic-ai/claude-code（带前缀），不要安装 claude-code 这个仿冒包。

3.4 添加 Claude 到 PATH（如需要）

原生安装器有时可能无法正确将 Claude 添加到 PATH 环境变量中。如果安装后运行 claude 提示命令找不到，按以下步骤修复：

1. 手动添加环境变量（PowerShell）：

   \(claudePath = "\)env:USERPROFILE.localbin“ [Environment]::SetEnvironmentVariable(”Path“, [Environment]::GetEnvironmentVariable(”Path“, ”User“) + ”;$claudePath“, ”User“) 

2. 关闭并重新打开 PowerShell 使 PATH 生效。

说明：Claude Code 默认安装到 %USERPROFILE%.localbinclaude.exe。

3.5 验证安装

安装完成后，关闭并重新打开终端窗口，输入：

claude –version 

能看到类似 2.1.89 (Claude Code) 的版本号输出，说明安装成功。

---

4.1 创建项目文件夹

建议先创建一个专门的项目文件夹，而不是直接在用户主目录中启动 Claude Code：

New-Item -ItemType Directory -Path C:projectsmy-project -Force cd C:projectsmy-project 

这样做的原因是：Claude Code 启动时会询问是否信任当前文件夹中的文件。在空项目文件夹中回答此问题更安全。

4.2 启动与认证（包含跳过登录）

由于官方 Claude 账号存在注册限制和网络访问难题，我们可以通过修改本地配置文件的方式，绕过官方的登录验证，直接进入 Claude Code 的交互界面。

1. 手动修改配置文件：

• 用记事本或代码编辑器打开位于 C:Users你的用户名 路径下的 .claude.json 文件。
• 在文件中添加 ”hasCompletedOnboarding“: true 这一行配置。请务必注意 JSON 格式，在上一行末尾补上英文逗号。

  {

"otherConfig": "value", "hasCompletedOnboarding": true 

}

2. 一键脚本自动修改（推荐）：

打开 PowerShell，直接复制并执行以下脚本，即可自动完成上述修改

node –eval ” const fs = require(‘fs’); const path = require(‘path’); const os = require(‘os’); const homeDir = os.homedir(); const filePath = path.join(homeDir, ‘.claude.json’); if (fs.existsSync(filePath)) , null, 2), ‘utf-8’); } else ), ‘utf-8’); } “

完成上述修改后，再次运行 claude 命令，即可直接进入交互界面，无需再处理官方登录流程。

4.3 配置第三方大模型（DeepSeek / Kimi）

要使用第三方模型，核心是配置两个环境变量：ANTHROPIC_BASE_URL（API接口地址）和 ANTHROPIC_AUTH_TOKEN（你的API密钥）。这里提供两种配置方式：

方式一：使用图形化工具 CC-Switch（推荐新手）

CC-Switch 是一个可视化工具，能帮你轻松管理和切换模型，省去手动配置的繁琐。

1. 获取 API Key：前往你选择的模型平台注册并创建 API Key。
   • DeepSeek：DeepSeek 开放平台
   • Kimi（月之暗面）：Kimi API 平台
   • 更多兼容模型：也可以选择 GLM、Qwen 等。
2. 安装并使用 CC-Switch：
   • 下载并安装 CC-Switch 工具。
   • 打开软件，点击“+”号，选择模型并粘贴你的 API Key，保存配置。
3. 启动 Claude Code：
   • 在后台保持 CC-Switch 运行。
   • 在终端输入 claude 启动，然后输入 /model 命令，即可看到并切换为你配置的第三方模型。

方式二：手动配置环境变量（推荐进阶用户）

如果你更倾向于直接控制，可以手动设置环境变量。

方法 A：临时配置（仅当前终端会话有效）

在终端（PowerShell或CMD）中，用你的API Key替换 ”你的API密钥“，然后运行以下命令：

1. 接入 DeepSeek：

# PowerShell \(env:ANTHROPIC_AUTH_TOKEN = "你的DeepSeek_API_Key" \)env:ANTHROPIC_BASE_URL = ”https://api.deepseek.com/anthropic/";

注意：DeepSeek 的接口地址是 https://api.deepseek.com/anthropic/。

2. 接入 Kimi：

# PowerShell \(env:ANTHROPIC_AUTH_TOKEN = "你的Kimi_API_Key" \)env:ANTHROPIC_BASE_URL = “https://api.moonshot.cn/anthropic/";

注意：Kimi 的接口地址是 https://api.moonshot.cn/anthropic/。

方法 B：永久配置（推荐）

在用户目录下的 %USERPROFILE%.claudesettings.json 文件中写入配置。

1. 创建或打开文件：在终端中运行 notepad $env:USERPROFILE.claudesettings.json。
2. 根据你选择的模型，填入以下配置之一，保存文件即可。

示例：为 DeepSeek 配置

{ ”env“: {

"ANTHROPIC_AUTH_TOKEN": "你的DeepSeek_API_Key", "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic/" 

} }

示例：为 Kimi 配置

{ ”env“: {

"ANTHROPIC_AUTH_TOKEN": "你的Kimi_API_Key", "ANTHROPIC_BASE_URL": "https://api.moonshot.cn/anthropic/" 

} }

配置完成后，重新打开终端并运行 claude 即可生效。

提示：配置后启动 Claude Code，可以在欢迎界面的 Overrides 区域看到 API Key 和 API Base 信息，确认配置无误。请注意，API 调用会产生费用，请确保账户有足够余额。

4.3 首次配置

首次启动时会提示你：

1. 选择主题（默认即可）
2. 确认安全须知
3. 使用默认终端配置
4. 信任当前工作目录

完成以上步骤后，即可开始使用。

---

5.1 启动方式

5.2 交互模式常用命令

在 Claude Code 交互界面中，输入以 / 开头的斜杠命令：

5.3 实战示例

理解代码库

> 简要介绍一下这个项目的整体结构和核心功能 > 项目的入口文件在哪里？ > 它是如何处理用户身份验证的？

执行代码修改

> 在 main.js 中添加一个处理异常的中间件 > 优化目前的登录逻辑，增加输入校验

一次性任务

claude ”fix the build error“ claude -p ”review this code for potential bugs“

5.4 自动 Git 提交

claude commit

Claude Code 会分析代码变更，自动生成合适的提交信息并创建提交。

---

6.1 环境变量配置

如需使用 API Key 方式连接 Claude（或使用第三方 API 网关）：

# 临时设置（仅当前终端会话有效） \(env:ANTHROPIC_AUTH_TOKEN = "sk-xxx" \)env:ANTHROPIC_BASE_URL = ”https://your-api-gateway.com";

或者通过系统环境变量永久设置：

1. Win + R → 输入 sysdm.cpl → 高级 → 环境变量
2. 在用户变量中添加：
   • 变量名：ANTHROPIC_AUTH_TOKEN，值：你的 API Key
   • 变量名：ANTHROPIC_BASE_URL，值：API 地址（如需要）

6.2 Git Bash 路径配置

如果 Claude Code 提示找不到 git-bash，手动设置环境变量：

$env:CLAUDE_CODE_GIT_BASH_PATH = “C:Program FilesGitbinbash.exe”

6.3 禁用自动更新

Claude Code 默认会自动更新。如需禁用，在 settings.json 中设置：

export DISABLE_AUTOUPDATER=1

手动更新命令：claude update

6.4 在 VS Code 中使用

Claude Code 支持 VS Code 扩展，可以在编辑器中直接使用。安装 VS Code 扩展后，点击编辑区域 Logo 即可打开对话面板。

---

7.1 执行安装命令返回语法错误

现象：PowerShell 中运行 irm https://claude.ai/install.ps1 | iex 报语法错误，提示不支持 var 关键字。

原因：网络问题导致 irm 没有拿到正确的 PS1 脚本，拿到的是 HTML 页面。

解决：确保网络能正常访问 claude.ai，或配置代理：

$Env:HTTPS_PROXY = “http://127.0.0.1:7890"; # 替换成你的代理端口 irm https://claude.ai/install.ps1 | iex

7.2 提示不支持 32 位 Windows

现象：系统明明是 64 位，但安装脚本报 “Claude Code does not support 32-bit Windows”。

原因：当前 PowerShell 进程是 32 位的。

解决：强制启动 64 位 PowerShell：

Start-Process ”$env:SystemRootSysNativeWindowsPowerShellv1.0powershell.exe“

在新窗口中验证 [Environment]::Is64BitProcess 为 True 后再安装。

7.3 安装成功但找不到 claude 命令

现象：安装成功，但运行 claude 报错 “无法将 claude 项识别为 …”。

解决：

1. 关闭当前终端，重新打开一个（这是最常见的原因，PATH 只在新终端会话中生效）
2. 如仍无效，手动添加 PATH：Win + R → sysdm.cpl → 环境变量 → 用户变量 → PATH → 新建 C:Users你的用户名.localbin

7.4 运行 claude 提示缺少 git-bash

现象：安装日志中出现 “Claude Code on Windows requires git-bash”。

解决：

1. 确认已安装 Git for Windows
2. 设置环境变量：CLAUDE_CODE_GIT_BASH_PATH=C:Program FilesGitbinbash.exe

7.5 使用 /doctor 命令自诊断

遇到问题时，先运行 /doctor 自诊断，再按错误信息对症处理，是最高效的排查路径。

7.6 npm 安装时误装仿冒包

如果误装了 claude-code（非官方包），先卸载再重装：

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

---

---

提示：本指南基于 2026 年 4 月的最新信息编写。如遇版本更新导致的差异，请以官方文档为准。