一、Claude Code 简介

Claude Code 是 Anthropic 推出的 AI 编程助手，它直接集成在终端中，让开发者无需离开命令行就能完成代码编写、调试、重构等任务。结合 PowerShell 环境，Claude Code 能极大提升 Windows 开发者的工作效率。

二、安装与配置

1. 安装方式

Claude Code 支持多种安装方式，推荐使用 npm 全局安装：

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

安装完成后，在终端中运行 claude 即可启动交互式会话。

2. 环境变量配置

在 PowerShell 中，可以通过设置环境变量来配置 Claude Code 的行为：

### 3. 使用 DeepSeek 作为后端模型

Claude Code 支持通过配置兼容 OpenAI API 的第三方模型作为后端，DeepSeek 就是其中一种高性价比的选择。

#### 3.1 获取 DeepSeek API 密钥

前往 [DeepSeek 开放平台](https://platform.deepseek.com/) 注册账号并创建 API Key。

#### 3.2 配置环境变量

在 PowerShell 中设置 DeepSeek 的 API 密钥和端点：

```powershell


### 4. 使用阿里 AI（通义千问）作为后端模型

除了 DeepSeek，Claude Code 同样支持接入阿里云的通义千问系列模型，通过兼容 OpenAI API 的方式实现。

#### 4.1 获取阿里云 API 密钥

前往 [阿里云百炼平台](https://bailian.console.aliyun.com/) 开通模型服务，在「API-KEY 管理」中创建并获取 API Key。

#### 4.2 配置环境变量

在 PowerShell 中设置阿里 AI 的 API 密钥和端点：

```powershell
# 设置阿里 AI API 密钥
$env:CLAUDE_API_KEY = "sk-你的阿里云百炼API密钥"

# 设置阿里 AI 的 API 端点
$env:CLAUDE_API_BASE = "https://dashscope.aliyuncs.com/compatible-mode/v1"

# 设置使用的模型（推荐通义千问系列）
$env:CLAUDE_DEFAULT_MODEL = "qwen-plus"

可选模型：阿里云百炼平台提供多种通义千问模型，可根据需求选择：

• qwen-plus：平衡性能与成本，适合日常开发
• qwen-max：最强推理能力，适合复杂代码生成
• qwen-turbo：快速响应，适合简单问答

4.3 验证配置

配置完成后，启动 Claude Code 验证是否成功连接阿里 AI：

claude --version

如果配置正确，Claude Code 将使用通义千问模型进行对话和代码生成。

4.4 永久配置（推荐）

将阿里 AI 配置写入 PowerShell 配置文件，避免每次启动都重复设置：

# 打开 PowerShell 配置文件
notepad $PROFILE

# 在文件中添加以下内容
$env:CLAUDE_API_KEY = "sk-你的阿里云百炼API密钥"
$env:CLAUDE_API_BASE = "https://dashscope.aliyuncs.com/compatible-mode/v1"
$env:CLAUDE_DEFAULT_MODEL = "qwen-plus"

保存后执行 . $PROFILE 使配置立即生效。

提示：阿里云百炼平台提供免费额度，适合初次体验和测试。通义千问系列模型在中文理解和代码生成方面表现优异，尤其适合国内开发者使用。如果遇到网络问题，可以检查是否需要配置代理。

设置 DeepSeek API 密钥

$env:CLAUDE_API_KEY = “sk-你的DeepSeekAPI密钥”

设置 DeepSeek 的 API 端点

$env:CLAUDE_API_BASE = “https://api.deepseek.com/v1”

设置使用的模型（DeepSeek 推荐模型）

$env:CLAUDE_DEFAULT_MODEL = “deepseek-chat”

#### 3.3 验证配置

配置完成后，启动 Claude Code 验证是否成功连接 DeepSeek：

```powershell
claude --version

如果配置正确，Claude Code 将使用 DeepSeek 模型进行对话和代码生成。

3.4 永久配置（推荐）

将 DeepSeek 配置写入 PowerShell 配置文件，避免每次启动都重复设置：

# 打开 PowerShell 配置文件
notepad $PROFILE

# 在文件中添加以下内容
$env:CLAUDE_API_KEY = "sk-你的DeepSeekAPI密钥"
$env:CLAUDE_API_BASE = "https://api.deepseek.com/v1"
$env:CLAUDE_DEFAULT_MODEL = "deepseek-chat"

保存后执行 . $PROFILE 使配置立即生效。

提示：DeepSeek 的 API 价格远低于 Claude 官方 API，适合日常开发调试和大量代码生成场景。如果遇到响应速度问题，可以尝试切换为 deepseek-reasoner 模型以获得更深入的推理能力。

设置 API 密钥

$env:CLAUDE_API_KEY = “你的API密钥”

设置默认模型

$env:CLAUDE_DEFAULT_MODEL = “claude-3-5-sonnet-20241022”

### 3. 项目初始化

在项目目录中启动 Claude Code 时，可以指定项目根目录：

```powershell
# 在当前目录启动
claude

# 指定项目目录
claude --add-dir "C:\Projects\MyApp"

三、核心命令详解

1. 基础命令

命令	功能	示例
/help	显示帮助信息	/help
/clear	清除当前会话上下文	/clear
/status	查看当前会话状态	/status
/exit	退出 Claude Code	/exit

2. 代码操作命令

命令	功能	示例
/diff	显示所有未提交的文件变更	/diff
/diff <文件>	显示指定文件的变更	/diff Program.cs
/apply	应用建议的变更	/apply
/reject	拒绝建议的变更	/reject
/save	保存当前会话到文件	/save ./session.md
/export [文件名]	导出对话为 Markdown	/export ./conversation.md

3. 任务与计划模式

命令	功能	示例
/plan [描述]	进入计划模式，先制定步骤再执行	/plan 实现用户登录功能
/approve	批准当前计划	/approve
/cancel	取消当前计划	/cancel
/todo	查看当前任务列表	/todo

4. 工具与集成

命令	功能	示例
/mcp	管理 MCP（模型上下文协议）服务器	/mcp list
/git	执行 Git 命令	/git status
/run <命令>	直接运行终端命令	/run dotnet build
/debug	进入调试模式	/debug
/bug	报告 Bug 给 Anthropic	/bug 无法识别.csproj文件

5. 快捷键（PowerShell 会话中）

快捷键	功能
Ctrl+C	中断当前响应
Ctrl+R	搜索历史提示
Esc（按两次）	回退到上一个检查点
Tab	自动补全命令和文件名
Shift+Enter	换行输入多行内容

四、PowerShell 环境特殊说明

1. 路径问题

PowerShell 中路径包含空格时需要用引号括起来：

claude --add-dir "C:\Program Files\My Project"

2. 编码问题

如果输出中文乱码，先设置 PowerShell 编码：

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

3. 别名冲突

如果之前遇到 Bun 覆盖 claude.ps1 的问题，建议使用完整命令：

claude.cmd --version

4. 永久配置

可以在 PowerShell 配置文件中设置环境变量，避免每次启动都重复配置：

# 打开配置文件
notepad $PROFILE

# 添加以下内容
$env:CLAUDE_API_KEY = "你的API密钥"
$env:CLAUDE_DEFAULT_MODEL = "claude-3-5-sonnet-20241022"

五、实战技巧

1. 高效调试工作流

使用 Claude Code 的调试模式可以快速定位问题：

# 进入调试模式
/debug

# 在调试过程中运行测试
/run dotnet test

2. 代码审查流程

结合 /diff 和 /apply 命令，可以高效完成代码审查：

# 查看所有变更
/diff

# 审查后应用变更
/apply

3. 复杂任务分解

对于大型功能开发，使用计划模式将任务分解为可管理的步骤：

/plan 实现用户注册功能

Claude Code 会先生成详细的实施计划，待你批准后再逐步执行。

六、常见问题与解决方案

Q1：启动时提示命令未找到

确保 Claude Code 已正确安装，并且 npm 全局包路径已添加到系统环境变量 PATH 中。

Q2：API 密钥无效

检查环境变量 CLAUDE_API_KEY 是否设置正确，或确认 API 密钥是否过期。

Q3：中文显示乱码

按照上文「编码问题」一节设置 PowerShell 编码即可解决。

Q4：命令执行超时

对于大型项目，Claude Code 处理时间可能较长，可以耐心等待或使用 /cancel 取消当前操作后重试。

七、总结

Claude Code 结合 PowerShell 为 Windows 开发者提供了强大的 AI 辅助编程能力。通过掌握本文介绍的命令和技巧，你可以：

• 快速上手 Claude Code 的安装与配置
• 熟练使用各类命令进行代码操作
• 利用计划模式处理复杂开发任务
• 解决 PowerShell 环境下的常见问题

希望这份命令大全能帮助你更高效地使用 Claude Code，让 AI 编程助手真正成为你日常开发中的得力伙伴。