终端里跑 AI,已经不是什么新鲜事了。但 Claude Code 和之前的 Copilot 插件不太一样——它能直接读你的整个项目目录,帮你改代码、修 bug、跑测试,全流程都在终端里完成。
我用了两周,把它当成日常主力工具。下面是踩坑后的实战总结。
安装与环境准备
Claude Code 目前需要 Anthropic API Key,通过 npm 安装:
npm install -g @anthropic-ai/claude-code
安装完成后直接运行:
claude
第一次启动会让你输入 API Key,支持环境变量方式配置:
export ANTHROPIC_API_KEY="sk-ant-api03-xxxx"
claude
关键一步:在 Claude Code 会话里输入 @permission,开启对项目的文件读写权限。不开权限的话,它只能看不能改。
会话模式:和终端 AI 对话的正确姿势
Claude Code 启动后,你会进入一个交互式会话。每次输入都当作一条指令。
基本对话流程
> 帮我找到项目里所有的 API 路由定义
> 把这些路由统一加上请求限流中间件
> 跑一下测试,看看有没有报错
三句话搞定。Claude Code 会依次执行,每一步都会显示它做了什么改动。
多轮对话的优势
不用像 Copilot 那样每次都写 prompt。对话是连续的,你能基于上一轮的结果继续说:
> 刚才那个改法不够优雅,换用装饰器模式
> 同时更新对应的单元测试
核心功能实战
功能一:批量代码重构
假设你有一个 Django 项目,30 个视图函数都用了相同的查询模式。你想统一改成自定义 Manager:
> 在 models.py 里添加一个 CustomQuerySet 类
> 把所有 views.py 里的 .filter().count() 查询换成 .custom_count()
> 确保导入语句也同步更新
Claude Code 会自动:
- 创建新类并写入 models.py
- 定位所有视图文件
- 逐文件修改查询调用
- 补充 import 语句
整个过程大约 2 分钟。比手动找、手动改快至少 10 倍。
功能二:Bug 修复工作流
遇到一个报错,但 stack trace 很长,不知道从哪下手:
> 这个报错是哪里来的?
> 帮我定位根因
> 给出修复方案并直接修改
Claude Code 会先解释错误原因,然后定位到具体代码行,最后直接改好。你可以随时打断它,说"先别改,我再想想"。
功能三:代码审查
写完功能后,让 Claude Code 帮你 review:
> @review 帮我审查这个 PR 的所有改动
> 关注点是:错误处理是否完整、有没有内存泄漏风险
它会逐文件检查,给出问题列表和改进建议。比你自己逐行看,效率高很多。
快捷键和快捷命令
Claude Code 内置了不少快捷方式:
| 命令 | 作用 |
|---|---|
@files | 引用特定文件 |
@terminal | 插入终端输出到上下文 |
@git | 引入 git diff 作为上下文 |
/edit | 编辑最后一条消息 |
/clear | 清空会话历史 |
@git 特别好用。你刚改了几个文件但还没 commit,输入 @git 就能让 Claude Code 基于你的改动给出建议。
和 VS Code 的配合
虽然 Claude Code 是纯终端工具,但你可以和 VS Code 搭配使用:
- 用 Claude Code 做批量重构或复杂 bug 修复
- 改完后用 VS Code 的 diff 工具做最终确认
- 有问题直接在终端里跟 Claude Code 对话
这种分工效率最高。纯编辑器交互适合快速调试,终端 AI 适合大范围改动。
注意事项
- 费用:按 API 调用量计费,日常开发大概每月几美元。大量代码生成会消耗更多 tokens
- 权限控制:
@permission里的规则要设好,不要让 AI 随意删除文件 - 版本控制:改之前先 commit,万一改坏了可以直接 revert
- 大型项目:Claude Code 能处理几千行代码的项目,但如果是百万级代码库,建议按模块分段处理
总结
Claude Code 不是万能的,但它确实把"让 AI 帮我改代码"这件事从概念变成了日常操作。终端里说一句话,改完代码,跑下测试——比打开 IDE 写 prompt 快多了。
如果你已经在用 Claude API,Claude Code 是最值得尝试的姿势。