什么是 Claude Code？

Claude Code 是 Anthropic 推出的一款终端原生AI编程工具（agentic coding tool）。它直接运行在你的终端里，能理解你的整个代码库，通过自然语言和你协作完成编码任务——写代码、修 Bug、重构、写测试、跑命令，全部在命令行完成。

和 GitHub Copilot 这类"补全式"工具不同，Claude Code 更像一个驻扎在终端里的高级程序员：你说需求，它来干活，还能主动读文件、跑测试、查日志。

环境准备

系统要求

• 操作系统：macOS 10.15+、Ubuntu 20.04+/Debian 10+、Windows（通过 WSL）
• Node.js ≥ 18
• 需要 Anthropic API Key（或通过 Amazon Bedrock / Google Vertex AI 接入）

安装

# 全局安装
npm install -g @anthropic-ai/claude-code

# 进入你的项目目录
cd /path/to/your/project

# 启动
claude

首次运行会引导你完成 API Key 配置（或 OAuth 登录），按提示操作即可。

核心用法

1. 直接对话模式

启动 claude 后进入交互式对话，直接用自然语言描述你要干什么：

> 帮我看看 src/api/auth.py 里的登录逻辑有没有安全问题

> 给这个项目加一个 /health 健康检查接口

> 把所有 print 语句替换成 logging 模块的调用

Claude Code 会自动读取相关文件、分析代码、给出修改方案，确认后直接帮你改。

2. 单次命令模式（-p / --print）

不想进入交互模式？用 -p 参数做一次性任务：

# 快速提问
claude -p "解释一下这个项目的目录结构"

# 管道输入
cat error.log | claude -p "分析这个报错的原因"

# 配合其他工具
git diff HEAD~3 | claude -p "总结最近3次提交改了什么"

适合脚本化、CI/CD 集成等场景。

3. 常用斜杠命令

在交互模式中，这些命令很实用：

Claude Code 能做什么？

代码理解与导航

> 这个项目的入口在哪？启动流程是怎样的？
> UserService 类都被哪些地方引用了？
> 解释一下 middleware/rateLimit.js 的限流逻辑

Claude Code 会自动搜索文件、读取代码、追踪调用链，不需要你手动指定文件路径。

写代码与重构

> 用 FastAPI 写一个文件上传接口，支持 S3 存储
> 把这个类从继承模式重构成组合模式
> 给 utils/ 目录下所有函数加上类型注解

修 Bug

> 运行测试报错了，帮我看看怎么修
> 用户反馈登录后 token 过期太快，排查一下

它能主动执行测试命令、读取日志、定位问题。

Git 操作

> 帮我把当前改动提交，写个有意义的 commit message
> 创建一个 PR，描述这次改了什么

运行命令

Claude Code 能直接在终端执行命令（首次会请求权限）：

> 跑一下单元测试
> 检查一下 docker-compose 服务状态
> 看看 8080 端口被谁占了

权限管理

Claude Code 对安全性的设计比较谨慎，操作分三档：

• 只读操作（读文件、搜索代码）：默认允许，无需确认
• 写操作（编辑文件、写新文件）：首次需要确认
• 命令执行（bash 命令）：首次需要确认

可以通过 /permissions 或启动参数来调整：

# 允许所有操作（适合自动化场景，注意安全）
claude --dangerously-skip-permissions

# 交互模式中管理
/permissions

建议日常使用保持默认权限，需要确认时看一眼再放行。

用 CLAUDE.md 定制项目规范

在项目根目录创建 CLAUDE.md 文件，Claude Code 每次启动都会自动读取。适合写：

# CLAUDE.md

## 项目简介
这是一个 Python FastAPI 后端服务，连接 PostgreSQL。

## 开发规范
- 使用 Python 3.11+，类型注解必须完整
- 测试框架：pytest，覆盖率要求 >80%
- 提交信息格式：<type>(<scope>): <description>

## 常用命令
- 启动服务：uvicorn app.main:app --reload
- 跑测试：pytest -v
- 数据库迁移：alembic upgrade head

## 注意事项
- 不要直接修改 migrations/ 目录下的文件
- 环境变量在 .env.example 中有模板

有了这个文件，Claude Code 就能按照你团队的规范来工作，减少反复交代的成本。

实用技巧

1. 善用上下文

Claude Code 理解整个项目结构。你不需要贴代码，直接说文件名或功能描述即可：

> 看看 auth 模块最近一次改动有没有引入 bug

2. 用 /compact 节省 Token

长对话后 token 消耗会变大，用 /compact 压缩历史：

/compact 保留关于数据库迁移的讨论

3. 多实例并行

可以开多个终端窗口，每个跑一个 claude 实例处理不同任务——比如一个写功能、一个修 Bug。

4. 和 Git 工作流结合

# 开始新功能前
git checkout -b feature/xxx
claude

# 在 Claude Code 里完成开发后
> 帮我提交代码并创建 PR

费用参考

Claude Code 按 API token 计费。根据 Anthropic 官方数据，典型的开发者使用场景：

• 日常编码任务：大约 $5-10/天
• 一次中等复杂度的重构：约 $2-5
• 可以通过 /cost 随时查看当前会话费用

建议设置 API 用量上限（在 Anthropic Console 里配置），避免意外超支。

总结

Claude Code 的核心价值：让 AI 在你的终端里当一个靠谱的编程搭档。它不是简单的代码补全，而是能理解项目全貌、主动执行操作、按你的规范干活的 Agent。

适合的场景： - 快速上手不熟悉的代码库 - 重复性编码（测试、重构、迁移） - 需要 AI 帮你跑命令、查日志、定位问题 - 个人开发提效

上手门槛很低——装好、启动、说人话就行。试试看。