目录
[步骤二:安装 Git for Windows](#步骤二:安装 Git for Windows)
[步骤三:安装 Claude Code](#步骤三:安装 Claude Code)
[步骤五:获取API Key](#步骤五:获取API Key)
[步骤六:配置 claude 环境变量](#步骤六:配置 claude 环境变量)
[步骤七:开始使用Claude Code](#步骤七:开始使用Claude Code)
[步骤八:claude code使用技巧](#步骤八:claude code使用技巧)
最近AI编程越来越火,本教程整理了比较流行的claude code使用方法,结合智谱平台的key,可以大大减少使用费用,比claude api费用低很多,能够满足常用编程需求。具体教程如下:
步骤一:安装node.js
下载地址:https://nodejs.org/en/download/

下载后,直接安装即可。
步骤二:安装 Git for Windows
下载地址:https://git-scm.com/install/windows

下载后,直接安装即可。
步骤三:安装 Claude Code
进入命令行界面,运行以下命令,安装 Claude Code
bash
npm install -g @anthropic-ai/claude-code
运行如下命令,查看安装结果,若显示版本号则表示安装成功
bash
claude --version

步骤四:注册智谱平台
按照提示完成账号注册流程。

步骤五:获取API Key
登录后,在个人中心页面,点击 API Keys,创建一个新的 API Key。

步骤六:配置 claude 环境变量
进入命令行界面,执行如下运行 Coding Tool Helper
bash
npx @z_ai/coding-helper
根据界面提示,配置key


步骤七:开始使用Claude Code
配置完成后,进入一个您的代码工作目录,在终端中执行 claude 命令即可开始使用 Claude Code进行开发了。

步骤八:claude code使用技巧
基础操作技巧
1.文件操作
读取文件
- 直接请求:"读取 xxx 文件"或"查看 xxx 文件"
- 示例:"读取 package.json 文件"
编辑文件
- 描述需要的修改:"把 xxx 函数改成 xxx"
- 示例:"将 setTimeout 改为 async/await 模式"
搜索文件
- 用自然语言描述:"找到所有包含 xxx 的文件"
- 示例:"找出所有包含 useEffect 的文件"
搜索代码内容
- "在代码中搜索 xxx 关键字"
- 示例:"搜索所有调用 apiClient 的地方"
2.代码操作
解释代码
- 选中代码后问:"这段代码是做什么的?"
- "解释 xxx 函数的工作原理"
调试代码
- 描述问题:"这个函数有 bug,xxx 时候会报错"
- "帮我调试这段代码,报错信息是 xxx"
重构代码
- "重构这个函数,使其更易读"
- "提取这段代码中的重复逻辑"
生成代码
- "创建一个 xxx 组件"
- "写一个函数来实现 xxx 功能"
常用命令
1.系统命令
| 命令 | 功能 | 说明 |
|---|---|---|
| /help | 获取帮助信息 | 查看所有可用命令和使用说明 |
| /clear | 清除对话历史 | 开始新的对话会话 |
| /tasks | 查看后台任务 | 查看正在运行的任务列表 |
| /commit | 创建 Git 提交 | 自动生成 commit message 并提交 |
| /review-pr | 审查 Pull Request | 查看并评论 PR |
2.Bash 命令操作
Git 操作
查看状态
git status
查看改动
git diff
查看提交历史
git log
添加文件并提交
git add . && git commit -m "描述"
推送到远程
git push
创建并切换分支
git checkout -b feature/xxx
包管理
npm
npm install
npm run build
npm test
npm run dev
yarn
yarn install
yarn build
yarn test
yarn dev
pnpm
pnpm install
pnpm build
pnpm test
文件操作
列出文件
ls
ls -la
查找文件
find . -name "*.js"
查看文件内容
cat file.txt
搜索文件内容
grep "keyword" file.txt
Docker 操作
构建镜像
docker build -t appname .
运行容器
docker run -p 3000:3000 appname
查看运行中的容器
docker ps
查看日志
docker logs container_id
高级技巧
1. 上下文利用
对话记忆
- Claude 会记住整个对话历史
- 可以基于前面的讨论继续深入
- 示例:"基于刚才的讨论,重构一下那个函数"
代码库理解
- 首次对话时可以让 Claude 先探索代码库结构
- "帮我了解这个项目的整体架构"
- "这个项目使用什么技术栈?"
2. 任务分解
自动分解
- 复杂任务自动分解为多个步骤
- 使用 TodoList 跟踪进度
- 可以随时查看当前任务状态
任务示例
- "实现一个完整的用户认证系统"
- Claude 会自动分解为:
- 设计数据模型
- 创建 API 端点
- 实现前端组件
- 添加测试
- 集成到应用
3. 并行操作
并行执行
- 请求"并行执行 xxx"可以同时运行多个独立操作
- 适合同时运行测试、检查多个文件等
示例
并行运行多个命令
git status && git diff && git log
4. 计划模式
何时使用
- 复杂任务、新功能实现
- 需要架构决策的修改
- 影响多个文件的变更
工作流程
- Claude 探索代码库
- 制定实施计划
- 用户确认后再执行
- 避免方向错误
示例场景
- "添加用户认证功能"(需要选择 JWT vs Session)
- "优化应用性能"(需要先分析瓶颈)
- "重构状态管理"(架构决策)
最佳实践
1. 提问技巧
✅ 好的提问方式
- "在 src/auth.ts 文件中找到处理用户认证的代码"
- "重构这个组件,提取重复的表单验证逻辑"
- "找出所有调用 processPayment 函数的地方"
- "这个组件的性能问题在哪里?"
❌ 不够明确的提问
- "帮我看看代码"(太模糊)
- "优化一下"(缺少具体目标)
- "有问题"(缺少上下文)
2. 任务描述
包含的要素
- 明确目标 :说明最终想要的结果
- 提供上下文 :相关的错误信息、预期行为
- 指定范围 :哪些文件需要修改
示例
目标:修复登录页面的表单验证问题
上下文:用户输入无效邮箱时,没有显示错误提示
范围:Login.tsx 和 validation.ts
3. 代码审查
指定审查角度
- "检查安全性问题"(SQL 注入、XSS 等)
- "从性能角度审查这段代码"
- "检查代码的可维护性"
- "审查错误处理是否完善"
4. 学习探索
架构理解
- "解释这个项目的整体架构"
- "数据流是如何在这个应用中流动的?"
- "这个项目用了哪些设计模式?"
实现细节
- "xxx 功能是如何实现的?"
- "这个算法的时间复杂度是多少?"
- "为什么要用这种方式实现?"
常见工作流
1. Bug 修复流程
步骤 1:描述 Bug 现象
"用户登录后,刷新页面会丢失登录状态"
步骤 2:Claude 定位问题代码
Claude 会分析相关代码,找出问题所在
步骤 3:Claude 提供修复方案
"建议使用 localStorage 持久化 token"
步骤 4:确认后应用修复
"应用这个修复方案"
步骤 5:运行测试验证
"运行测试确保修复有效"
2. 新功能开发
步骤 1:描述功能需求
"添加用户头像上传功能"
步骤 2:Claude 进入计划模式
-
分析现有代码结构
-
确定实施方案
-
评估影响范围
步骤 3:审查实施计划
查看 Claude 提供的详细计划
步骤 4:批准后开始实现
"批准这个计划,开始实施"
步骤 5:自动测试和验证
Claude 会运行测试并修复问题
3. 代码重构
步骤 1:指定重构范围
"重构 services/auth.ts,提高可读性"
步骤 2:说明重构目标
-
提取重复逻辑
-
改善命名
-
添加必要的注释
步骤 3:Claude 分析并执行
分析代码结构,执行重构
步骤 4:运行测试
"确保测试通过,没有破坏性变更"
4. 代码审查
步骤 1:指定审查范围
"审查 src/api/ 目录下的所有文件"
步骤 2:指定审查重点
"重点关注错误处理和边界情况"
步骤 3:获取建议
Claude 提供详细的审查意见
步骤 4:选择性修复
"修复第 1 和第 3 个问题"
专业建议
1. 安全性
自动检测
- Claude 会自动检测常见安全漏洞
- XSS(跨站脚本攻击)
- SQL 注入
- CSRF(跨站请求伪造)
- 命令注入
安全实践
- 代码修改时会考虑安全性最佳实践
- 验证用户输入
- 使用参数化查询
- 敏感数据加密存储
2. 性能优化
分析方法
- "分析这段代码的性能瓶颈"
- "找出应用中的慢查询"
- "评估这个组件的渲染性能"
优化原则
- 优化时会考虑实际影响
- 避免过早优化
- 基于数据做决策
- 不破坏可读性
3. 代码质量
风格一致性
- 遵循项目现有代码风格
- 不引入不一致的命名
- 保持代码格式统一
适度设计
- 除非必要,不添加过度抽象
- 保持代码简洁
- 避免"为了未来"的过度设计
- 三行相似代码优于过度抽象
测试覆盖
- 重要功能添加测试
- 边界情况处理
- 错误场景覆盖
4. Git 操作
提交规范
- 自动生成规范的 commit message
- 遵循约定式提交格式
- 包含清晰的变更说明
Pull Request
- 支持创建 PR
- 自动生成 PR 描述
- 包含测试计划
代码格式化
- 自动处理格式化(如果配置了 hooks)
- 不跳过 pre-commit hooks
- 保留重要的代码检查
实用技巧
1.快捷操作
| 快捷命令 | 功能 |
|---|---|
| /help | 查看帮助信息 |
| /clear | 清除对话,重新开始 |
| /tasks | 查看后台运行的任务 |
2.进度跟踪
查看任务状态
- 任何时间都可以问:"任务进行到哪里了?"
- Claude 会显示当前进度和剩余工作
任务优先级
- 可以指定:"先完成 xxx,再做 yyy"
- 可以调整优先级:"暂停当前任务,先处理紧急的 xxx"
3.多文件操作
批量操作
- "在所有 .tsx 文件中替换 xxx 为 yyy"
- "为所有组件添加错误边界"
模式匹配
- "找到所有 test 文件并运行测试"
- "处理所有 src/components/ 下的文件"
4.代码片段
提取代码
- "从 xxx 文件中提取表单验证逻辑"
- "把这个工具函数移到 utils 目录"
代码复用
- "找出可以复用的组件"
- "创建一个共享的 xxx 组件"
Agent 工具
1. Bash Agent
用途 :命令执行专家
- Git 操作
- 运行测试
- 包管理
- Docker 操作
何时使用 :需要执行终端命令时
2. Explore Agent
用途 :代码库快速探索
- 查找文件模式
- 搜索代码关键词
- 理解代码库架构
何时使用 :
- "xxx 功能在代码库的哪里实现?"
- "这个项目用了哪些设计模式?"
- "找到所有 API 端点定义"
探索级别
- quick:快速搜索
- medium:适度探索
- very thorough:全面分析
3. Plan Agent
用途 :软件架构设计
- 制定实施计划
- 识别关键文件
- 评估架构权衡
何时使用 :
- 实现复杂功能
- 需要架构决策
- 多文件变更
4. General Purpose Agent
用途 :通用任务处理
- 复杂问题研究
- 多步骤任务
- 代码搜索和分析