Claude Code 安装与配置指南
本篇文章介绍我在 Windows 11 环境下配置的 Claude Code 开发环境,包含自定义模型、权限管理和插件扩展。
环境概览
- 操作系统: Windows 11 Pro (10.0.26200)
- 终端: bash
- 当前模型: GLM-5
- 配置路径 :
C:\Users\hello\.claude\
核心配置
自定义模型
我在配置中使用了 GLM-5 模型替代默认的 Claude 模型:
json
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-sp-***",
"ANTHROPIC_BASE_URL": "https://xxx",
"ANTHROPIC_MODEL": "glm-5"
}
}
这里使用了自定义的 API 端点 https://xxx:8443,并配置了 GLM-5 作为默认模型。这种配置方式允许用户接入兼容 Anthropic API 的第三方模型服务。
努力级别
json
{
"effortLevel": "high"
}
设置为高努力级别后,Claude Code 会进行更深入的代码分析和优化建议。
权限管理
Claude Code 采用三层权限模型:Allow(自动允许)、Deny(自动拒绝)、Ask(需要询问)。
自动允许 (allow)
json
"allow": [
"Bash(git status)",
"Bash(git log:*)",
"Bash(git diff:*)",
"Bash(git add:*)",
"Bash(git stash:*)",
"Bash(git branch:*)",
"Bash(git switch:*)",
"Bash(git checkout:*)",
"Bash(swift build:*)",
"Bash(swift test:*)",
"Bash(swift run:*)",
"Bash(xcodebuild:*)",
"Bash(npm test:*)",
"Bash(npm run lint:*)",
"Bash(npm run dev:*)",
"Bash(npm run typecheck:*)",
"Bash(npx tsc:*)",
"Bash(bun run:*)",
"Bash(bun test:*)",
"Bash(node:*)",
"Bash(python3:*)",
"Bash(mkdir -p:*)",
"Bash(cp:*)",
"Bash(mv:*)",
"Bash(cat:*)",
"Bash(echo:*)",
"Bash(ls:*)",
"Bash(find:*)",
"Bash(grep:*)",
"Bash(wc:*)",
"Bash(which:*)",
"Bash(gh api:*)",
"Bash(gh repo:*)",
"Bash(xcodegen generate:*)",
"WebSearch",
"WebFetch(domain:developer.apple.com)",
"WebFetch(domain:developers.figma.com)",
"WebFetch(domain:github.com)",
"WebFetch(domain:raw.githubusercontent.com)",
"Read(**)",
"Edit(src/**)",
"Edit(Sources/**)",
"Edit(Tests/**)",
"Edit(tests/**)",
"Write(src/**)",
"Write(Sources/**)",
"Write(Tests/**)"
]
允许的操作包括:
- Git 操作: 状态查看、日志、差异、分支管理等基础操作
- Swift 开发: 编译、测试、运行
- Node.js/npm: 测试、lint、开发服务器、类型检查
- Bun: 运行和测试
- GitHub CLI: API 调用和仓库操作
- 文件读取: 所有文件
- 代码编辑: src、Sources、Tests 目录下的代码文件
自动拒绝 (deny)
json
"deny": [
"Bash(rm -rf:*)",
"Bash(sudo:*)",
"Bash(curl * | *)",
"Bash(wget * | *)",
"Write(/Users/changyou/.ssh/*)",
"Edit(.env.production)",
"Edit(.env.prod)",
"Read(.env.production)"
]
安全防护:
- 防止递归强制删除
- 禁止 sudo 权限提升
- 禁止管道命令执行远程脚本
- 保护 SSH 密钥文件
- 保护生产环境配置文件
需要询问 (ask)
json
"ask": [
"Bash(git commit:*)",
"Bash(git push:*)",
"Bash(git merge:*)",
"Bash(git rebase:*)",
"Bash(npm install:*)",
"Bash(npm run build:*)",
"Bash(pod install:*)",
"Bash(brew install:*)",
"Edit(package.json)",
"Edit(Package.swift)",
"Edit(Podfile)",
"Edit(tsconfig.*)",
"Edit(vite.config.*)",
"Write(**)"
]
需要确认的操作:
- 危险的 Git 操作(提交、推送、合并、变基)
- 安装依赖和构建操作
- 配置文件修改
- 所有文件写入操作
插件系统
已安装插件
json
{
"enabledPlugins": {
"superpowers@claude-plugins-official": true
}
}
Superpowers 插件
Superpowers 是一个完整的软件开发生 methodology,为 Claude Code 带来了专业级的开发流程。
核心工作流
- brainstorming - 编写代码前的头脑风暴,精炼需求并验证设计
- using-git-worktrees - 创建隔离的工作空间进行并行开发
- writing-plans - 制定详细的实现计划
- subagent-driven-development - 子代理驱动的开发模式
- test-driven-development - TDD 测试驱动开发
- requesting-code-review - 代码审查请求
- finishing-a-development-branch - 开发分支完成工作流
技能库
| 类别 | 技能 |
|---|---|
| 测试 | test-driven-development |
| 调试 | systematic-debugging, verification-before-completion |
| 协作 | brainstorming, writing-plans, requesting-code-review, receiving-code-review |
| Git | using-git-worktrees, finishing-a-development-branch |
安装指南
1. 安装 Claude Code
bash
# Windows (使用 winget)
winget install Anthropic.Claude
# 或者使用 npm
npm install -g @anthropic-ai/claude-code
2. 配置自定义模型
编辑 ~/.claude/settings.json:
json
{
"env": {
"ANTHROPIC_MODEL": "glm-5",
"ANTHROPIC_BASE_URL": "https://your-api-endpoint.com",
"ANTHROPIC_AUTH_TOKEN": "your-token"
}
}
3. 配置权限
根据你的开发需求,配置合适的权限级别。建议:
- 开发初期: 宽松配置,快速迭代
- 生产环境: 严格配置,保护关键文件
4. 安装插件
bash
# 安装 Superpowers
/plugin install superpowers@claude-plugins-official
# 浏览更多插件
/plugin discover
总结
通过以上配置,我建立了一个高效且安全的 Claude Code 开发环境:
- ✅ GLM-5 模型提供强大的代码生成能力
- ✅ 细粒度的权限管理平衡了安全性和便利
- ✅ Superpowers 插件带来了专业的开发工作流