Claude Code Windows 使用完整指南目录系统要求安装步骤基础使用配置 GLM4.6 等其他大模型

系统要求

硬件要求

操作系统：Windows 10 版本 2004 及以上（Build 19041+）或 Windows 11
内存：至少 4GB RAM（推荐 8GB 以上）
存储空间：至少 2GB 可用空间
网络：稳定的互联网连接

软件要求

Node.js：18.0.0 或更高版本
npm：9.0.0 或更高版本（通常随 Node.js 一起安装）
Git：2.30.0 或更高版本（可选但推荐）
PowerShell：5.1 或更高版本（Windows 自带）

安装步骤

步骤 1：安装 Node.js

下载 Node.js
- 访问 Node.js 官网
- 下载 Windows Installer (.msi) 的 LTS 版本（推荐）
- 选择适合您系统的版本（64-bit 或 32-bit）
安装 Node.js
- 双击下载的 .msi 安装包
- 按照安装向导完成安装（保持默认设置即可）
- 确保勾选 "Add to PATH" 选项
验证安装
- 打开 PowerShell（按 Win + X，选择 "Windows PowerShell" 或 "终端"）
- 运行以下命令验证安装：
```
node --version
npm --version
```
- 如果显示版本号，说明安装成功

步骤 2：配置 npm（可选但推荐）

设置 npm 全局安装路径
- 在 PowerShell 中运行：
```
npm config set prefix %APPDATA%\npm
```
添加到 PATH 环境变量
- 按 Win + R，输入 sysdm.cpl，按回车
- 点击"高级"选项卡 → "环境变量"
- 在"用户变量"中找到 Path，点击"编辑"
- 点击"新建"，添加：%APPDATA%\npm
- 点击"确定"保存

步骤 3：安装 Claude Code

全局安装 Claude Code
- 在 PowerShell 中运行：
```
npm install -g @anthropic-ai/claude-code
```
注意：如果遇到权限问题，请以管理员身份运行 PowerShell
验证安装
- 运行以下命令：
```
claude --version
```
- 如果显示版本号，说明安装成功

步骤 4：配置 API 密钥

获取 API 密钥
- 访问 Anthropic 官网注册账户
- 在控制台中创建 API 密钥
- 复制您的 API 密钥
设置环境变量
- 按 Win + R，输入 sysdm.cpl，按回车
- 点击"高级"选项卡 → "环境变量"
- 在"用户变量"中点击"新建"
- 变量名：ANTHROPIC_API_KEY
- 变量值：您的 API 密钥
- 点击"确定"保存
验证配置
- 重新打开 PowerShell
- 运行：
```
echo $env:ANTHROPIC_API_KEY
```
- 如果显示您的 API 密钥，说明配置成功

基础使用

启动 Claude Code

打开 PowerShell
- 按 Win + X，选择 "Windows PowerShell" 或 "终端"
导航到项目目录
```
cd D:\project\test
```
启动 Claude Code
```
claude
```

常用命令

1. 查看帮助

claude --help

2. 代码生成

claude "生成一个 Java 类，用于处理用户登录"

3. 代码审查

claude review src/main/java/Example.java

4. 代码解释

claude explain src/main/java/Example.java

5. 代码重构

claude refactor src/main/java/Example.java

交互式使用

启动交互模式
```
claude interactive
```
在交互模式中：
- 输入自然语言描述您的需求
- Claude Code 会生成相应的代码
- 输入 exit 或 quit 退出

配置文件

Claude Code 的配置文件通常位于：

C:\Users\<用户名>\.claude\config.json

示例配置：

{
  "apiKey": "your-api-key",
  "model": "claude-3-5-sonnet-20241022",
  "temperature": 0.7,
  "maxTokens": 4096,
  "timeout": 30000
}

配置 GLM4.6 等其他大模型

方法一：通过配置文件切换模型

打开配置文件
- 导航到配置文件目录：
```
cd $env:USERPROFILE\.claude
```
- 如果目录不存在，创建它：
```
mkdir $env:USERPROFILE\.claude
```

编辑配置文件

创建或编辑 config.json：

{
  "models": {
    "default": "glm-4.6",
    "available": [
      {
        "name": "glm-4.6",
        "provider": "glm",
        "apiKey": "your-glm-api-key",
        "baseUrl": "https://api.openai-proxy.com/v1",
        "modelId": "glm-4.6"
      },
      {
        "name": "claude-3-5-sonnet",
        "provider": "anthropic",
        "apiKey": "your-anthropic-api-key",
        "baseUrl": "https://api.anthropic.com/v1",
        "modelId": "claude-3-5-sonnet-20241022"
      },
      {
        "name": "gpt-4",
        "provider": "openai",
        "apiKey": "your-openai-api-key",
        "baseUrl": "https://api.openai.com/v1",
        "modelId": "gpt-4"
      }
    ]
  },
  "temperature": 0.7,
  "maxTokens": 4096
}

切换模型
```
claude --model glm-4.6
```

方法二：使用环境变量

设置模型环境变量
- 按 Win + R，输入 sysdm.cpl，按回车
- 点击"高级"选项卡 → "环境变量"
- 在"用户变量"中点击"新建"
- 变量名：CLAUDE_MODEL
- 变量值：glm-4.6
- 点击"确定"保存
设置 GLM API 密钥
- 变量名：GLM_API_KEY
- 变量值：您的 GLM API 密钥

方法三：通过命令行参数

claude --model glm-4.6 --api-key your-glm-api-key --base-url https://api.openai-proxy.com/v1 "生成代码"

GLM4.6 具体配置

获取 GLM4.6 API 密钥
- 访问 GLM 官方平台
- 注册并登录账户
- 在控制台中创建 API 密钥

配置 GLM4.6 模型

编辑配置文件 config.json：

{
  "defaultModel": "glm-4.6",
  "models": {
    "glm-4.6": {
      "provider": "glm",
      "apiKey": "your-glm-api-key",
      "baseUrl": "https://open.bigmodel.cn/api/paas/v4",
      "modelId": "glm-4-all",
      "temperature": 0.7,
      "maxTokens": 8192
    }
  }
}

验证配置
```
claude --model glm-4.6 --test
```

支持的其他模型

OpenAI 模型

{
  "gpt-4": {
    "provider": "openai",
    "apiKey": "your-openai-api-key",
    "baseUrl": "https://api.openai.com/v1",
    "modelId": "gpt-4"
  },
  "gpt-3.5-turbo": {
    "provider": "openai",
    "apiKey": "your-openai-api-key",
    "baseUrl": "https://api.openai.com/v1",
    "modelId": "gpt-3.5-turbo"
  }
}

本地模型（Ollama）

{
  "llama2": {
    "provider": "ollama",
    "baseUrl": "http://localhost:11434",
    "modelId": "llama2"
  }
}

其他兼容 OpenAI API 的模型

{
  "custom-model": {
    "provider": "openai-compatible",
    "apiKey": "your-api-key",
    "baseUrl": "https://your-api-endpoint.com/v1",
    "modelId": "your-model-name"
  }
}

高级配置

自定义提示词模板

创建提示词模板文件

在 .claude 目录下创建 templates 文件夹
创建模板文件，例如 java-template.txt：

你是一个专业的 Java 开发工程师。
请根据以下需求生成代码：
{user_request}

要求：
- 代码要符合 Java 编码规范
- 添加必要的注释
- 包含错误处理

在配置中引用模板

{
  "templates": {
    "java": "templates/java-template.txt"
  }
}

代理配置

如果您的网络环境需要代理：

设置代理环境变量

$env:HTTP_PROXY = "http://proxy.example.com:8080"
$env:HTTPS_PROXY = "http://proxy.example.com:8080"

或在配置文件中设置

{
  "proxy": {
    "http": "http://proxy.example.com:8080",
    "https": "http://proxy.example.com:8080"
  }
}

日志配置

启用详细日志

{
  "logging": {
    "level": "debug",
    "file": "claude.log",
    "maxSize": "10MB",
    "maxFiles": 5
  }
}

查看日志

Get-Content $env:USERPROFILE\.claude\claude.log -Tail 50

批量处理

处理多个文件

Get-ChildItem -Path "src\main\java" -Filter "*.java" | ForEach-Object {
  claude review $_.FullName
}

使用脚本批量处理

创建 batch-process.ps1：

$files = Get-ChildItem -Path "src\main\java" -Recurse -Filter "*.java"
foreach ($file in $files) {
    Write-Host "处理文件: $($file.Name)"
    claude review $file.FullName
}

常见问题与解决方案

1. 安装时遇到权限问题

问题：permission denied 或 EACCES 错误

解决方案：

以管理员身份运行 PowerShell

或使用用户目录安装：

npm config set prefix %APPDATA%\npm
npm install -g @anthropic-ai/claude-code

2. 找不到 `claude` 命令

问题：安装后无法识别 claude 命令

解决方案：

检查 npm 全局路径是否在 PATH 中：
```
npm config get prefix
```
将该路径添加到系统 PATH 环境变量
重新打开 PowerShell

3. PowerShell 执行策略错误

问题：无法加载文件，因为在此系统上禁止运行脚本

解决方案：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

4. API 密钥验证失败

问题：Invalid API key 或 Authentication failed

解决方案：

检查环境变量是否正确设置：
```
echo $env:ANTHROPIC_API_KEY
```
确认 API 密钥有效且未过期
重新启动 PowerShell 使环境变量生效

5. 网络连接问题

问题：无法连接到 API 服务器

解决方案：

检查网络连接
配置代理（如需要）
检查防火墙设置
尝试使用 VPN

6. 模型切换不生效

问题：切换模型后仍使用默认模型

解决方案：

检查配置文件语法是否正确
确认模型配置完整

清除缓存：

Remove-Item -Path "$env:USERPROFILE\.claude\cache" -Recurse -Force

重新启动 Claude Code

7. 代码生成质量不佳

问题：生成的代码不符合预期

解决方案：

提供更详细的提示词
调整 temperature 参数（降低值以获得更确定的结果）
使用模板定制提示词
分步骤生成代码

8. 内存占用过高

问题：Claude Code 占用大量内存

解决方案：

限制并发请求数量
减少 maxTokens 参数
定期清理缓存
关闭不必要的功能

9. 中文支持问题

问题：中文提示词处理不正确

解决方案：

确保 PowerShell 编码为 UTF-8：

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8

在配置文件中设置编码：
```
{
  "encoding": "utf-8"
}
```

10. GLM4.6 模型无法使用

问题：配置 GLM4.6 后无法调用

解决方案：

确认 API 密钥有效
检查 baseUrl 是否正确
验证 modelId 是否匹配
查看日志文件获取详细错误信息
确认 GLM API 服务可用

最佳实践

1. 提示词编写技巧

明确具体：描述清晰的需求
提供上下文：包含相关代码和文件信息
分步骤：复杂任务分解为多个步骤
示例驱动：提供期望的输出示例

2. 代码审查流程

使用 Claude Code 进行初步审查
人工复核关键部分
运行测试验证
迭代改进

3. 性能优化

使用缓存避免重复请求
批量处理相似任务
合理设置超时时间
监控 API 使用量

4. 安全建议

不要在代码中硬编码 API 密钥
使用环境变量存储敏感信息
定期更新 API 密钥
审查生成的代码安全性

附录

A. 常用命令速查表

命令	说明
`claude --help`	显示帮助信息
`claude --version`	显示版本号
`claude --model <model-name>`	切换模型
`claude --config`	显示配置信息
`claude review <file>`	代码审查
`claude explain <file>`	代码解释
`claude refactor <file>`	代码重构
`claude interactive`	启动交互模式

B. 配置文件完整示例

{
  "apiKey": "your-default-api-key",
  "defaultModel": "claude-3-5-sonnet-20241022",
  "models": {
    "claude-3-5-sonnet": {
      "provider": "anthropic",
      "apiKey": "your-anthropic-api-key",
      "baseUrl": "https://api.anthropic.com/v1",
      "modelId": "claude-3-5-sonnet-20241022"
    },
    "glm-4.6": {
      "provider": "glm",
      "apiKey": "your-glm-api-key",
      "baseUrl": "https://open.bigmodel.cn/api/paas/v4",
      "modelId": "glm-4-all"
    },
    "gpt-4": {
      "provider": "openai",
      "apiKey": "your-openai-api-key",
      "baseUrl": "https://api.openai.com/v1",
      "modelId": "gpt-4"
    }
  },
  "temperature": 0.7,
  "maxTokens": 4096,
  "timeout": 30000,
  "proxy": {
    "http": "",
    "https": ""
  },
  "logging": {
    "level": "info",
    "file": "claude.log"
  },
  "encoding": "utf-8"
}

C. 相关资源链接

D. 更新日志

版本 1.0.0（2024-01-XX）

初始版本
支持 Claude 模型
支持多模型切换
基础代码生成和审查功能

技术支持

如果您遇到本文档未涵盖的问题，可以通过以下方式获取帮助：

查看日志文件：%USERPROFILE%\.claude\claude.log
访问官方文档：Claude Code 官方文档
社区支持：GitHub Issues
联系支持：support@anthropic.com

文档版本：1.0.0
最后更新：2024-01-XX
维护者：Claude Code 团队

Claude Code Windows 使用完整指南

目录

系统要求

硬件要求

软件要求

安装步骤

步骤 1：安装 Node.js

步骤 2：配置 npm（可选但推荐）

步骤 3：安装 Claude Code

步骤 4：配置 API 密钥

基础使用

启动 Claude Code

常用命令

1. 查看帮助

2. 代码生成

3. 代码审查

4. 代码解释

5. 代码重构

交互式使用

配置文件

配置 GLM4.6 等其他大模型

方法一：通过配置文件切换模型

方法二：使用环境变量

方法三：通过命令行参数

GLM4.6 具体配置

支持的其他模型

OpenAI 模型

本地模型（Ollama）

其他兼容 OpenAI API 的模型

高级配置

自定义提示词模板

代理配置

日志配置

批量处理

常见问题与解决方案

1. 安装时遇到权限问题

2. 找不到 claude 命令

3. PowerShell 执行策略错误

4. API 密钥验证失败

5. 网络连接问题

6. 模型切换不生效

7. 代码生成质量不佳

8. 内存占用过高

9. 中文支持问题

10. GLM4.6 模型无法使用

最佳实践

1. 提示词编写技巧

2. 代码审查流程

3. 性能优化

4. 安全建议

附录

A. 常用命令速查表

B. 配置文件完整示例

C. 相关资源链接

D. 更新日志

技术支持

2. 找不到 `claude` 命令