Claude Code：终端里的 AI 编程代理深度使用记录

安装完进入项目目录，直接运行 claude。首次会弹出浏览器让你登录 Claude 账号授权。用 API Key 的话：

export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxx"
claude

走第三方代理：

export ANTHROPIC_BASE_URL="https://your-proxy-endpoint.com"
export ANTHROPIC_API_KEY="your-key"
claude

日常怎么用？

进到项目根目录，敲 claude 就进入交互会话。你可以像聊天一样说：

> 帮我找出所有没有单元测试覆盖的函数，并为它们生成测试用例
> 我的 API 在高并发下会报 500 错误，帮我排查原因
> 把 src/components 目录下所有 Class Component 重构为 Function Component

Claude Code 会自动扫描代码库、分析文件、执行必要的 Shell 命令，改完文件之后展示 Diff 等你确认。

一次性执行模式

适合放进脚本或 CI：

# 单次任务，-p 指定 prompt，跑完就退出
claude -p "检查本次 git diff 中是否有安全漏洞"

# 搭配管道
tail -f app.log | claude -p "如果发现异常日志，立刻通知我"

# 批量处理
git diff main --name-only | claude -p "Review 这些改动文件中的安全问题"

# 跨文件批量
find . -name "*.py" | claude -p "把所有 Python 文件的 print 语句替换为 logging"

继续之前的会话

claude -c          # 接上次最后一条
claude -r <session-id>  # 指定历史会话

内置斜杠命令

在会话里输入 / 就能看到不少内置命令，挑几个最实用的列一下：

对话里用 @ 可以快速引用文件：@src/auth/login.ts 这里的 token 验证逻辑有 Bug，帮我修复，用 ! 直接跑 Shell 命令把输出塞到上下文：! npm test，根据报错帮我修复。

CLAUDE.md：给 AI 看的项目说明书

如果说 Claude Code 有什么让我觉得最值的功能，那就是 CLAUDE.md。它在项目根目录放一个 Markdown 文件，每次新会话都会自动读取，相当于你预先告诉 Claude 项目的技术栈、规范、命令、禁忌。这样就不用每次都说一遍'我们用 Zod 校验数据，不是手写 if'。

多级配置，就近优先

~/.claude/CLAUDE.md       → 全局，放个人偏好
./CLAUDE.md               → 项目级，团队共享，提交到 git
./src/components/CLAUDE.md → 子目录级，针对特定模块

一个实际例子

# 项目说明：电商后台管理系统
## 技术栈
- 前端：React 18 + TypeScript + Tailwind CSS
- 后端：Node.js + Fastify + Prisma + PostgreSQL
- 测试：Vitest + Testing Library
- 包管理：pnpm
## 常用命令
- 启动开发服务器：`pnpm dev`
- 运行测试：`pnpm test`
- 数据库迁移：`pnpm prisma migrate dev`
- 构建生产包：`pnpm build`
## 代码规范
- 所有新组件必须是 Function Component，禁止 Class Component
- API 调用统一通过 `src/lib/api.ts` 的 `apiClient` 封装
- 数据校验使用 Zod schema，不要用手写 if 判断
- 组件文件名用 PascalCase，工具函数用 camelCase
## 架构原则
- 业务逻辑不允许放在 UI 组件中，应抽到 hooks 或 service 层
- 数据库查询必须放在 Repository 层（src/repositories/）
- 错误处理统一通过 GlobalErrorHandler 中间件
## 注意事项
- `src/legacy/` 目录是历史遗留代码，不要修改，也不要在新功能中引用
- 支付相关逻辑在 `src/payment/`，修改前必须通知 @张三
- 数据库没有级联删除，手动处理关联数据删除

自动记忆（Auto Memory）

2026 年 2 月起，Claude Code 在工作过程中会自己发现并记录一些有价值的信息——构建技巧、调试方法、项目规律，后续会话自动调用。存放目录可以通过 settings.json 的 autoMemoryDirectory 自定义，记得把自动记忆目录加到 .gitignore，免得把个人积累的'知识'推上仓库。

Skills：按需加载的专项能力

CLAUDE.md 放核心约定，Skills 则处理数量多、细节杂的专项规范。在 .claude/skills/ 下放 Markdown 文件，Claude 会根据任务相关性自动加载，免得 CLAUDE.md 被撑爆。

.claude/
└── skills/
    ├── react-component.md
    ├── api-design.md
    └── code-review.md

注意沙盒模式下 .claude/skills/ 是只读的。

MCP：让 Claude 和外部工具握手

MCP（Model Context Protocol）是 Anthropic 发布的开放协议，让 Claude Code 能直接调用第三方服务。配置好 MCP Server 后，就能让它读 Google Drive 里的设计文档、在 Jira 里创建任务、拉取 Slack 消息、查数据库——基本就是想象中的'AI 与你的工作流打通'。

添加一个 MCP Server：

claude mcp add
# 支持 OAuth 的服务（如 Slack）
claude mcp add --client-id <id> --client-secret <secret>

使用起来像这样：

> 帮我在 Jira 里找到所有标记为 "blocked" 的 tickets，汇总一下原因
> 把 Google Drive 里的 API 设计文档读一遍，然后帮我实现对应的接口
> 查一下 Slack 里 #backend 频道今天讨论的数据库 schema 变更，同步到代码注释里

自定义命令与 Hooks

团队可以把常用流程封装成自定义命令，放在 .claude/commands/ 目录，例如 review-pr.md：

# .claude/commands/review-pr.md
请对当前 git diff 做一次全面的 Code Review，检查：
1. 潜在的安全漏洞
2. 性能问题
3. 未处理的边界情况
4. 是否缺少单元测试
用中文输出结构化的 Review 报告。

之后在会话里输入 /review-pr 就会走这个流程。类似的还可以做 /deploy-staging、/gen-changelog、/i18n-check。

Hooks 能在 Claude Code 动作前后自动触发 Shell 命令，比如每次改完文件就格式化、提交前跑测试。

// .claude/settings.json
{
  "hooks": {
    "afterFileEdit": ["prettier --write {{file}}", "eslint --fix {{file}}"],
    "beforeCommit": ["pnpm test --run"],
    "PostCompact": ["echo '上下文已压缩，继续工作'"]
  }
}

目前支持的触发时机有 afterFileEdit、beforeCommit、PostCompact、MCP 交互输入前后的 Elicitation / ElicitationResult，以及多 Agent 工作流中的 WorktreeCreate/Remove、TeammateIdle、TaskCompleted 等。

塞进 CI/CD 流水线

Claude Code 的设计天然适合自动化，一个 GitHub Actions 示例：

name: AI Code Review
on:
  pull_request:
    types: [opened, synchronize]
jobs:
  claude-review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Claude Code Review
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          claude -p "请对本次 PR 的改动做 Code Review，重点检查安全性和性能，输出 Markdown 格式报告"

其他玩法：CI 里自动翻译 i18n 字符串，或者 tail 生产日志发现异常时通过 Slack Webhook 告警。

多 Agent 并行

处理大型重构或 monorepo 时，可以用 Git Worktree 隔离任务：

claude --worktree

在 settings.json 里通过 worktree.sparsePaths 只 checkout 需要的目录，能省不少时间。Web 版可以直接在浏览器里并行跑多个任务，修 Bug 的同时写文档、挂后台做长任务。

常用配置与环境变量

# API Key
export ANTHROPIC_API_KEY="sk-ant-xxxx"

# 第三方代理
export ANTHROPIC_BASE_URL="https://your-proxy.com"

# 禁用后台定时任务（调试时用）
export CLAUDE_CODE_DISABLE_CRON=1

# MCP 工具太多时启用搜索
export ENABLE_TOOL_SEARCH=1

settings.json 可以这样放：

{
  "model": "claude-opus-4-6",
  "theme": "dark",
  "hooks": {
    "afterFileEdit": ["prettier --write {{file}}"]
  },
  "worktree": {
    "sparsePaths": ["src/", "tests/"]
  },
  "feedbackSurveyRate": 0
}

几个需要留意的点

Token 消耗：分析大代码库时 Token 烧得很快。记得用 /compact 压缩上下文、用 /clear 起新话题、配好 .gitignore 避开 node_modules 这种目录。一个中型项目的复杂任务，API 按量付费模式下单次对话可能花掉 $0.5～$3，Pro 订阅有用量限制，重度折腾建议 Max 或 API Key。

安全与权限：它能执行任意 Shell 命令和改写文件。危险操作之前会请求确认（除非你设了自动批准白名单）。CI 里用的 Key 最好给只读权限。生产环境先上 staging 验证。官方声明收集使用数据（代码接受/拒绝情况、对话片段），但不会拿来训练模型。

代码质量：别让它'莽'改。复杂任务先用 /plan 出规划；小步提交而不是一大坨变动；在 beforeCommit 里挂上测试命令；再配合 IDE 的可视化 Diff 做好 Review。

CLAUDE.md 的维护：这个文件是团队知识库，要提交到版本控制。技术栈变化、新规范、重要决策及时更新，但别写成长篇小说，精简的信息比面面俱到管用。

国内网络：没法直连的话，走代理是最省心的：

export HTTPS_PROXY="http://127.0.0.1:7890"
export HTTP_PROXY="http://127.0.0.1:7890"
claude

或者找靠谱的第三方 API 中转：

export ANTHROPIC_BASE_URL="https://reliable-proxy.example.com"
export ANTHROPIC_API_KEY="your-api-key"
claude

实战片段

接手一个老项目：

cd legacy-project
claude
> /init
> 帮我读一遍这个项目的代码结构，写一份给新人看的项目说明文档
> 这个项目有哪些技术债？优先级最高的 3 个是什么？

线上报错时：

> 生产环境报错：TypeError: Cannot read properties of undefined (reading 'userId')
> 错误发生在 src/middleware/auth.ts:47，帮我找到根本原因并修复

大规模重构：

> /plan
> 把整个项目的数据访问层从直接 SQL 查询迁移到 Prisma ORM，先给我一个迁移计划
# 计划没问题了
> 好，开始执行第一步

自动化开发流：

claude -p "读取 GitHub Issue #142 的内容，实现对应的功能，写好测试，然后提交 PR"

小结

Claude Code 不是帮你补全代码的工具，而是直接替你干活。它尤其适合独立开发者、接手老代码的人、需要自动化重复任务的团队，以及想用自然语言描述想法就能出代码的'Vibe Coding'场景。当然，Token 花费不小，网络环境有要求，复杂任务仍然需要人工把关。但能看出来，Anthropic 在这里投入的力度让它在 Agentic 编程工具里跑到了前面。

参考链接：

• 官方文档：https://code.claude.com/docs
• GitHub 仓库：https://github.com/anthropics/claude-code
• Anthropic 官网：https://www.anthropic.com