在 Windows 环境下使用 Claude Code 完全指南

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

Claude Code 简介
Windows 环境安装
基本使用方法
Claude Code for VSCode
常见问题与技巧

Claude Code 是 Anthropic 推出的 AI 编程助手工具，它能够：

理解和编辑代码库
执行终端命令
搜索和浏览文件
自动化开发任务
与 VSCode 深度集成

Node.js (版本 18 或更高)
npm 或 yarn
Git (可选，但推荐)

访问 Node.js 官网下载并安装 LTS 版本。

验证安装：

node –version npm –version

打开 PowerShell 或 CMD，运行：

GPT plus 代充 只需 145npm install -g @anthropic-ai/claude-code

或者使用 npx 直接运行：

npx @anthropic-ai/claude-code

首次运行时，Claude Code 会提示你输入 Anthropic API Key。

获取 API Key 的步骤：

访问 Anthropic Console
登录或注册账户
在 API Keys 页面创建新的 API Key
复制并保存好你的 API Key

由于网络原因，国内用户推荐使用智谱 BigModel 提供的 Claude Code 接入服务。

步骤一：注册并获取 API Key

访问智谱开放平台
注册并登录账户
进入控制台 → API Keys 管理
创建新的 API Key

步骤二：配置 GLM Coding Plan

在 PowerShell 中设置环境变量：

GPT plus 代充 只需 145# 临时设置（当前会话有效） \(env:ANTHROPIC_API_KEY = &#34;your-bigmodel-api-key&#34; \)env:ANTHROPIC_BASE_URL = “https://open.bigmodel.cn/api/anthropic"

或永久设置（写入用户环境变量）：

# 永久设置 API Key [Environment]::SetEnvironmentVariable(”ANTHROPIC_API_KEY“, ”your-bigmodel-api-key“, ”User“)

永久设置 API Base URL

[Environment]::SetEnvironmentVariable(”ANTHROPIC_BASE_URL“, ”https://open.bigmodel.cn/api/anthropic", “User”)

步骤三：启动并授权

配置完成后，进入代码工作目录，执行：

GPT plus 代充 只需 145claude

若遇到「Do you want to use this API key」选择 Yes
启动后选择信任 Claude Code 访问文件夹里的文件

⚠️ 常见问题：中国大陆访问限制

如果启动时提示「Anthropic API 在中国大陆不可用」或类似错误，需要手动创建配置文件跳过检测：

在用户目录创建配置文件 /.claude.json（Windows 路径为 C:\Users\你的用户名.claude.json）
添加以下内容：

{ “hasCompletedOnboarding”: true }

保存后，重新运行 claude 命令即可正常启动

此配置用于跳过 Anthropic API 的地区检测，使用智谱 BigModel 代理时需要此设置。

步骤四：切换使用模型

手动修改配置文件 /.claude/settings.json（Windows 路径为 C:\Users\你的用户名.claude\settings.json），添加或替换如下环境变量参数：

GPT plus 代充 只需 145{ “env”: {

&#34;ANTHROPIC_DEFAULT_HAIKU_MODEL&#34;: &#34;glm-4.5-air&#34;, &#34;ANTHROPIC_DEFAULT_SONNET_MODEL&#34;: &#34;glm-4.7&#34;, &#34;ANTHROPIC_DEFAULT_OPUS_MODEL&#34;: &#34;glm-4.7&#34;

} }

注：使用 GLM-5，需要将上方的环境变量参数值手动修改模型为 “glm-5”。

启动一个新的命令行窗口，运行 claude 启动，输入 /status 确认模型状态：

GPT plus 代充 只需 145&gt; /status

智谱支持的模型映射：

环境变量	可选模型	说明
ANTHROPIC_DEFAULT_HAIKU_MODEL	glm-4.5-air	轻量快速模型
ANTHROPIC_DEFAULT_SONNET_MODEL	glm-4.7, glm-5	主力模型
ANTHROPIC_DEFAULT_OPUS_MODEL	glm-4.7, glm-5	高级模型

推荐版本：

建议使用 Claude Code 2.1.42 或更高版本：

# 检查当前版本 claude –version

升级到最新版本

claude update

配置不生效排查：

若手动修改 /.claude/settings.json 配置文件后不生效：

关闭所有 Claude Code 窗口，重新打开一个新的命令行窗口
如果问题仍存在，尝试删除 /.claude/settings.json 文件，重新配置
检查 JSON 格式是否正确（逗号、引号等），可使用在线 JSON 校验工具

其他国内代理平台：

平台	API Base URL	说明
智谱 BigModel	https://open.bigmodel.cn/api/anthropic	推荐，支持 GLM 模型
OpenRouter	https://openrouter.ai/api/v1	支持多种模型

注意事项：

不同平台的 API Key 格式和计费方式可能不同
使用前请确认平台支持的模型列表
建议设置使用额度限制，避免意外消费

GPT plus 代充 只需 145claude –version

在项目目录中启动：

cd your-project-directory claude

命令	说明
claude	启动交互式会话
claude –help	显示帮助信息
claude –version	显示版本号
claude “your prompt”	直接执行单个提示

启动后，你可以：

提问：直接输入问题，Claude 会分析代码库并回答
请求修改：让 Claude 修改代码
执行任务：请求 Claude 执行复杂的多步骤任务

示例对话：

GPT plus 代充 只需 145&gt; 帮我找出项目中的所有 TODO 注释

> 重构这个函数，使其更易读

> 创建一个新的 React 组件用于用户登录

Ctrl + C：中断当前操作
Ctrl + D：退出 Claude Code
↑ / ↓：浏览历史命令

打开 VSCode
按 Ctrl + Shift + X 打开扩展面板
搜索 “Claude Code”
点击 “Install” 安装

code –install-extension anthropic.claude-code

设置 API Key

按 Ctrl + Shift + P 打开命令面板
输入 “Claude Code: Set API Key”
粘贴你的 Anthropic API Key

配置设置

打开 VSCode 设置 (Ctrl + ,)，搜索 “Claude Code”：

claude-code.model：选择使用的模型
claude-code.maxTokens：设置最大 token 数
claude-code.temperature：设置响应随机性

点击左侧活动栏的 Claude 图标
在聊天框中输入问题或请求
Claude 会分析当前打开的文件或整个工作区

选中代码后，右键选择 “Ask Claude”
或使用快捷键（默认 Ctrl + Shift + L）

功能	说明
解释代码	选中代码后请求解释
重构代码	请求优化或重构选中的代码
生成测试	为选中代码生成单元测试
修复 Bug	让 Claude 分析并修复问题
代码补全	AI 辅助的代码补全建议

快捷键	功能
Ctrl + Shift + L	打开 Claude 聊天
Ctrl + Shift + C	清除对话历史
Alt + Enter	接受建议

A: API Key 通常保存在：

Windows: %USERPROFILE%.claude\config.json
或环境变量 ANTHROPIC_API_KEY

A: 如果遇到网络问题，可以：

检查网络连接
配置代理设置
使用 VPN（如果需要）

A: Windows PowerShell 默认的执行策略可能会阻止脚本运行。以下是几种解决方案：

方案一：临时绕过执行策略（推荐）

此命令仅在当前 PowerShell 会话中生效，关闭后自动恢复，安全性最高：

GPT plus 代充 只需 145Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass -Force

参数说明：

-Scope Process：仅影响当前 PowerShell 进程，不影响系统全局设置
-ExecutionPolicy Bypass：绕过所有执行策略限制
-Force：强制执行，不显示确认提示

方案二：为当前用户设置执行策略

此设置会永久生效于当前用户：

Get-ExecutionPolicy Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

方案三：以管理员身份运行

右键点击 PowerShell，选择”以管理员身份运行”。

执行策略对比：

策略	说明
Restricted	默认策略，不允许运行任何脚本
RemoteSigned	本地脚本可运行，远程脚本需签名
AllSigned	所有脚本都必须有数字签名
Bypass	不阻止任何脚本，无警告
Undefined	未设置，使用默认策略

查看当前执行策略：

GPT plus 代充 只需 145Get-ExecutionPolicy -List

此命令会显示所有作用域的执行策略设置。

提供上下文

在提问时提供足够的背景信息
指明相关的文件或目录

分步骤请求

复杂任务拆分为多个小步骤
逐步验证每个步骤的结果

使用 .claudeignore

创建 .claudeignore 文件排除不需要分析的文件
类似 .gitignore 的语法

保存常用提示

将常用的提示模板保存起来
提高工作效率

代码审查

让 Claude 审查你的代码变更
获取改进建议

文档生成

自动生成代码文档
创建 README 文件

学习新技术

让 Claude 解释不熟悉的代码
学习新的编程模式

调试辅助

描述问题让 Claude 帮助诊断
获取修复建议

Claude Code 是一个强大的 AI 编程助手，通过 CLI 和 VSCode 扩展两种方式，可以显著提高开发效率。在 Windows 环境下的安装和使用相对简单，只需要配置好 Node.js 和 API Key 即可开始使用。

建议根据个人工作流程选择合适的使用方式：

CLI 方式：适合终端用户和自动化脚本
VSCode 扩展：适合日常开发，集成度更高

Claude Code 官方文档
Anthropic Console
VSCode 扩展市场

在 Windows 环境下使用 Claude Code 完全指南

永久设置 API Base URL

升级到最新版本

相关推荐