Claude Code 实战指南 · 颜值笔记

实战分享

Claude Code
使用指南

来自 Anthropic 技术团队的私房技巧 · Boris 现场实录

📋 中文整理适合收藏全文精编

导读

Claude Code 是 Anthropic 推出的新一代 agentic（代理式）AI 编码助手。它不只是补全代码，而是能自主构建功能、修复错误、调用工具完成任务。

在 Anthropic，工程师的技术 onboarding 从 2〜3 周缩短到约 2 天。本文整理 Boris 在技术分享会上的实用建议，帮你快速上手、进阶使用。

核心观点

Key Takeaways

从代码 Q&A 开始，别急着让它写代码
让模型先思考规划，再动手实现
CLAUDE.md 是提升效果的最小投入
给模型反馈工具（测试、截图），它会自我迭代
善用团队共享：MCP、CLAUDE.md、配置

Claude Code 是什么

What is Claude Code

新一代 AI 编程助手，不是逐行补全，而是端到端的智能体：帮你写好完整功能、修复全部报错。

核心特性

不改变你的工作流，兼容所有 IDE（Xcode、JetBrains 等）
可在终端、SSH、TMUX 等任何环境运行
通用性极强，不局限于特定编辑器

快速上手指南

Setup & First Steps

安装：只需 Node.js，终端运行安装命令行
terminal setup：开启 Shift+Enter 换行，告别反斜杠
/theme：切换浅色 / 深色 / 色弱模式
GitHub App：今天发布，可在 issue 里 @Claude 直接处理
自定义工具白名单：减少每次弹窗确认，更顺手

在 macOS 系统设置 → 辅助功能 → 听写中，可以开启「双击 fn 键」语音输入，直接说出你的需求。 —— Boris 的私人工作流

入门首选：代码问答

Code Q&A

最推荐的起步方式——直接向 Claude 提问你的代码库。

无需索引、无需配置，打开立即使用
示例：「这个类是如何被实例化的？」
示例：「这段代码怎么用？」
它会深入源码寻找真实用法，而不只是文本搜索

80% Anthropic 技术人员每天使用 Claude Code

2〜3周 → 2天新工程师 onboarding 时长变化

高效编辑与规划

Planning & Editing

关键技巧：在写代码之前，先让 Claude 思考。

「先别写代码，先做计划。我想先和你探讨思路。」 —— Boris 最常用的提示词之一

让模型自己构建方案： brainstorm → 规划 → 等你确认 → 再执行。

自动化能力：commit、push、创建 Pull Request，模型都能自主完成，会自动遵循你仓库的 commit 规范。

团队工具与 MCP

Team Tools & MCP

两类工具

Batch CLI

通过 `--help` 让 Claude 了解你的命令行工具，也能写进 CLAUDE.md

MCP

Cloud Code 支持 MCP 协议，可接入 Tailwind、Puppeteer 等服务器

团队共享的 MCP 配置文件（mcp.json）签入仓库后，所有成员自动获得同一套工具能力。

CLAUDE.md：上下文管理的秘诀

Context Management

在项目根目录放置 CLAUDE.md，每次会话自动加载。

建议内容：常用命令、架构决策、核心文件指引、代码风格
子目录也可放 CLAUDE.md，按需触发
团队共享一份，只需维护一次
层级：项目级 → 子目录级 → 企业级全局配置

上下文越多，决策越聪明。上下文越丰富，表现越好。 —— Boris 的实践经验

层级配置体系

Hierarchical Config

项目级：跟随 Git 仓库，适合团队共享
全局：适用于你所有项目
企业策略：批量授权或禁止命令（如允许 `test`，禁止访问某些 URL）
MCP 服务器也可以分级管理

终端技巧

Terminal Tips

Tab / Shift+Tab：查看 / 切换工具参数
Shift+Tab：自动接受建议（写测试时很有用）
Escape 键：任何时候打断反馈，告诉它「换一种做法」
双击 Escape：回到历史会话
Ctrl+R：查看模型视角的完整输出
Ctrl+Shift+·：终端内快速触发指令

Claude Code SDK

SDK & Automation

与 Claude Code 相同的 SDK，可以在脚本中调用：

claude -p "你的提示" --tools ... --format json

用作 Unix 工具：输入提示 → 得到 JSON
可用于 incident response、日志分析
配合 git status + jq 实现无限组合
读取 CI 日志、GCP 通知，让 Claude 提取关键信息

进阶：并行工作流

Advanced Parallel Work

多开终端会话 + TMUX 隧道
同一 repo 多个 checkout / Git worktree 隔离
并行跑多个 Claude Code 任务
适用于重度用户（power user）

团队正在优化该场景的易用性，但当前已可组合出非常强大的工作流。

Q&A 精选

Q&A Highlights

最难实现的部分？
Bash 命令权限系统。既要避免危险操作，又不能每次弹窗打断开发节奏。我们通过静态分析和精细的权限分级来解决。

支持图片输入吗？
支持！可以直接拖拽/粘贴图片到终端，也可以传文件路径。我经常在实现 UI 时给它 mock 图做参考。

为什么做在终端里？
因为 Anthropic 内部 IDE 不统一；而且我们认为未来开发者可能不再依赖传统 IDE，终端是最大公约数。

行动建议

今天就开始：打开 Claude Code，从问它「这个代码库是怎么组织的」开始
写一份 CLAUDE.md：放在项目根目录，花 10 分钟写下常用命令和架构要点
配一个验证工具：单元测试、Puppeteer 或模拟器，让 Claude 能自检
和团队共享：把 CLAUDE.md 和 MCP 配置签入仓库，集体提效
升级工作流：尝试 SDK + Unix 管道组合，发现自动化新玩法

好的工具，会改变你写代码的方式

从代码问答开始，逐步深入 agentic 编程

⚡ CuteNote.app 颜值笔记

Claude Code使用指南

Claude Code
使用指南