Windows下安装Claude Code及使用

与Claude Desktop的区别：请注意，Claude Desktop（图形化桌面应用程序）的配置文件位于 %AppData%\Claude\ 目录（通常是 C:\Users\用户名\AppData\Roaming\Claude\），其配置文件名通常为 claude_desktop_config.json，用于配置MCP服务器等，与Claude Code的命令行配置不是一回事。

环境准备

安装Claude Code

在Wrap终端中执行安装

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

相关文件

1
2
C:\Users\用户\.claude.json
C:\Users\用户\.claude

.claude目录下的文件说明

文件/目录名 功能说明
settings.json 核心配置文件，用于设置API密钥、模型等全局参数。
CLAUDE.md 全局指导文件，包含适用于你所有项目的通用说明和规范。
commands/ 目录 存放自定义命令的文件夹，你可以将常用指令封装成命令，通过/user:调用。

settings.json

1
2
3
4
5
6
7
8
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.v3.cm",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxx",
    "ANTHROPIC_MODEL": "claude-3-7-sonnet-20250219",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-3-7-haiku-20241022"
  }
}

claude.md 的核心作用

claude.md文件是Claude Code的核心配置文件，它的作用类似于Cursor的rules文件，主要用于规定AI如何生成代码。通过这个文件，你可以精确控制代码风格、开发环境配置、仓库规范等各个方面，让AI更好地理解你的项目需求和编码习惯。

文件路径 作用
项目根目录/claude.md 团队共享的项目级配置，提交至Git供所有成员使用
项目根目录/claude.local.md 个人本地覆盖配置，通常加入.gitignore避免影响他人
父目录/claude.md 在monorepo结构中自动继承的上级配置，递归向上查找
子目录/claude.md 针对特定子模块/功能的独立配置，优先于父级配置加载
~/.claude/claude.md 用户全局默认配置，适用于所有Claude会话的基线设定

文件位置与加载优先级

Claude Code支持多层级的配置文件系统，不同位置的文件具有不同的作用域和优先级：

项目级配置

  • 项目根目录/claude.md：这是团队共享的项目级配置文件，应该提交至Git仓库供所有团队成员使用。它定义了整个项目的通用规则和约定。

  • 项目根目录/claude.local.md：这是个人本地覆盖配置文件，通常需要添加到.gitignore中以避免影响其他团队成员。你可以在这里添加个人偏好的配置。

继承式配置

  • 父目录/claude.md：在monorepo结构中，Claude Code会自动继承上级目录的配置，采用递归向上查找的方式。这样可以确保子项目继承统一的基础规范。

  • 子目录/claude.md：针对特定子模块或功能的独立配置文件，优先于父级配置加载。这允许你为不同的模块设置特定的规则。

全局配置

  • ~/.claude/claude.md：用户全局默认配置文件，适用于所有Claude会话的基线设定。这是你个人开发习惯的体现。

编辑方式

ClaudeCode支持支持命令行与对话框交互两种灵活的claude.md编辑方式：

  1. 通过斜杠命令编辑
    在Claude Code会话中输入 /memory，会唤起系统记忆文件列表。选中后，可以在默认编辑器中打开claude.md进行编辑，非常适合批量配置或团队规则维护。

  2. 对话中动态添加内容
    还有一种更轻量的方式：直接在对话框输入 # 开头的内容，Claude会自动识别为你想写入规则文件的内容。

Claude命令

会话管理命令

1
2
3
4
5
/clear (reset, new)	清空当前对话历史和上下文，开始全新会话
/compact	压缩对话历史但保留摘要，节省 token 消耗
/exit (quit)	退出 Claude Code REPL 环境
/resume	恢复之前的对话会话
/rewind (checkpoint)	将代码和/或对话恢复到之前的某个时间点

配置与设置命令

1
2
3
4
5
6
7
/config (theme)	打开配置面板，设置主题等偏好
/model	设置 Claude Code 使用的 AI 模型
/output-style	设置输出样式（可直接设置或从菜单选择）
/output-style:new	创建自定义输出样式
/statusline	设置 Claude Code 的状态行 UI
/terminal-setup	安装 Shift+Enter 键绑定用于换行
/vim	在 Vim 和普通编辑模式之间切换

账户与成本管理

1
2
3
4
5
/login	使用 Anthropic 账户登录
/logout	登出当前账户
/cost	显示当前会话的总成本和持续时间
/usage	显示计划使用限制
/upgrade	升级到 Max 计划以获得更高频率限制和更多 Opus 使用

系统状态与诊断

1
2
3
4
/status	显示 Claude Code 状态（版本、模型、账户、API 连接性等）
/doctor	诊断和验证 Claude Code 安装和设置
/context	以彩色网格可视化当前上下文使用情况
/release-notes	查看发布说明

项目与文件管理

1
2
3
4
/init	初始化新的 CLAUDE.md 文件，用于代码库文档
/add-dir	添加新的工作目录
/memory	编辑 Claude 记忆文件
/export	将当前对话导出到文件或剪贴板

高级功能与集成

1
2
3
4
5
6
7
8
/agents	管理代理配置
/bashes	列出和管理后台任务
/hooks	管理工具事件的钩子配置
/ide	管理 IDE 集成并显示状态
/mcp	管理 MCP 服务器
/permissions (allowed-tools)	管理允许和拒绝的工具权限规则
/plugin (plugins)	管理 Claude Code 插件
/todos	列出当前待办事项

代码审查与安全

1
2
3
/pr-comments	从 GitHub pull request 获取评论
/review	审查 pull request
/security-review	完成当前分支上待更改的完全安全审查

反馈与帮助

1
2
3
4
/help	显示帮助和可用命令
/feedback (bug)	提交关于 Claude Code 的反馈
/install-github-app	为仓库设置 Claude GitHub Actions
/migrate-installer	从全局 npm 安装迁移到本地安装

实用技巧与场景

开发工作流示例

1
2
3
4
5
6
7
8
9
10
11
12
13
# 1. 初始化项目
/init

# 2. 检查系统状态
/status

# 3. 进行代码开发，使用 /compact 定期压缩历史

# 4. 完成更改后进行安全审查
/security-review

# 5. 查看成本统计
/cost

团队协作场景

1
2
3
4
5
6
7
8
# 审查 PR
/review

# 管理待办事项
/todos

# 导出会话分享给团队
/export

系统管理

1
2
3
4
5
6
7
8
# 诊断问题
/doctor

# 管理插件
/plugin

# 配置权限
/permissions

配置GLM-4.6模型

前往智谱官方 Bigmodel 开放平台,创建 API Key

环境变量名 变量值
ANTHROPIC_AUTH_TOKEN 你的智谱API Key (例如 9b0...mb4)
ANTHROPIC_BASE_URL https://open.bigmodel.cn/api/anthropic
ANTHROPIC_MODEL glm-4.6
ANTHROPIC_SMALL_FAST_MODEL glm-4.6

在Wrap终端中输入claude命令测试配置是否成功

用量查看

1
npm install -g ccusage

常用命令

1
2
3
4
5
6
7
8
9
10
ccusage                      # = ccusage daily（默认日汇总）
ccusage daily --since 20241201 --until 20241231
ccusage weekly               # 周汇总
ccusage monthly              # 月汇总
ccusage session              # 按会话（对话）查看
ccusage blocks               # 按 5 小时计费窗查看（含 Active/预测等）
ccusage blocks --active      # 只看当前活跃窗口
ccusage blocks --recent      # 近几天窗口
ccusage daily --breakdown    # 分模型拆解
ccusage monthly --json > usage.json  # 导出 JSON 做二次分析

MCP市场

1
2
3
4
5
6
7
8
9
10
11
https://modelcontextprotocol.io/docs/getting-started/intro
https://mcpmarket.cn/ *
https://www.claudemcp.com/
https://www.mcpservers.cn/servers
https://www.mcpworld.com/
https://maomu.com/mcp
https://openmcp.store/
https://lobehub.com/zh/mcp
https://www.mcp-cn.com/
https://www.modelscope.cn/mcp
https://www.mcpset.cn/

规范驱动开发

1
2
3
spec-kit
openspec
BMAD-METHOD

有哪些AI助手

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
Claude Code
Cursor
Gemini CLI
Windsurf
Roo Code
GitHub Copilot
Qwen Code
OpenCode
Codex CLI
Kilo Code
Auggie CLI
CodeBuddy
Amazon Q Developer
Trea
QCoder
iFlow CLI

问题

PowerShell 脚本执行限制问题

这个错误是由于 PowerShell 的执行策略（Execution Policy）阻止了脚本运行。要解决这个问题，请在 PowerShell 中执行以下命令，当系统提示时，输入 Y 并回车确认：

1
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned