过去一周,我用 Claude Code 做了三个 side project,彻底被这个“自主化 AI 编程工具”惊艳到了。
如果说 Cursor 是 AK47,那么 Claude Code 就是
自动巡航导弹
——可以独立运行任务、解释代码、自动创建 PR、甚至一句话生成一个应用!
本文将从安装入门到高阶技巧,一步步教你如何用好 Claude Code。
一、安装与基本使用
1. 使用 npm 安装 Claude Code
npm install -g @anthropic-ai/claude-code
2. 进入你的项目目录并启动 Claude
cd your-project-directory
claude
首次启动会要求你登录 Anthropic 账户,或者输入 API Key。
注意:API 模式需要绑定信用卡,会按 Token 计费,费用不低!
二、配置 Claude Code
查看当前配置:
claude config list
修改配置:
claude config set <KEY> <VALUE>
例如切换默认模型:
claude config set preferredModel claude-3-opus
友情提醒:慎用 Opus 模型,容易“上头”,用完后回不去了……
三、系统与依赖要求
支持系统:
- macOS 10.15+
- Ubuntu 20.04+ / Debian 10+
- Windows(必须安装 WSL2)
建议直接使用 macOS 或 Linux,才能发挥 Claude Code 的全部功能。
建议安装的工具:
- GitHub CLI (
gh
) - GitLab CLI (
glab
) - ripgrep (
rg
)
这些命令行工具可提升代码分析和自动化效率。
四、推荐版本与降级操作
最新版本存在交互弹窗等干扰行为,推荐使用稳定版 v1.0.17
:
npm install -g @anthropic-ai/claude-code@1.0.17
claude config set-g autoUpdateStatus disabled
五、项目理解与初始化
项目初始化命令:
/init
Claude 会自动分析项目结构并生成 CLAUDE.md
项目说明文档(可附加“请生成中文”的指令)。
你也可以用:
/init --force
来覆盖更新。
六、Git 自动化操作
自动创建 PR 示例:
“帮我把当前分支改动创建一个 Pull Request 到 main 分支,标题为:Feature: Add Registration Validation,并总结改动。”
需要提前安装 gh
CLI,Claude 会自动执行 PR 操作。
七、测试与调试
示例指令:
“运行
tests/auth.test.js
中的测试。如果有失败的测试,分析报错并修复src/utils/auth.js
中的代码。”
Claude 能执行测试 + 修复代码,极大提高效率。
八、提示词编写技巧(Prompt Engineering)
这是 Claude Code 使用的精髓!
推荐写法
- 明确目标 + 风格 + 限定范围
“给我一个现代化的设计”
“创建一个类似 Linear 的仪表盘风格 UI,深色主题,卡片布局”
避免提示歧义
使用:
only modify this function
do not do anything else
来限制 Claude 的行为范围。
两步策略
先说:分析思路并列出重构步骤(先不写代码)
然后:等我确认后再执行代码修改
这样更可控、更稳定。
九、长任务管理技巧
任务太多,难以一次说清楚且容易忘记之前 Claude 的上下文,这时我们就可以用一个Markdown 文件当作 Claude 的工作笔记本,比如对于跨天任务或大型项目,创建计划文件:
refactor_plan.md
并持续更新:
“我们完成了第一步和第二步,请列出第三步的子任务”
还能结合 Gemini、ChatGPT 等多模型,混合使用效果更好!(Claude 虽然很强,但有时你希望: 验证 Claude 的建议是否合理,多一个脑子更好,看看 ChatGPT / Gemini / Cursor 有没有更优思路)
十、编辑与历史记录功能
Esc
两次 → 编辑上一条消息claude --resume
→ 恢复中断的会话
十一、使用 SDK 自动化操作
第一步:以自动生成 Git 提交标题为例:
npm install @anthropic-ai/claude-sdk
第二步:创建脚本 git-commit-title.js
:
import { ClaudeSDK } from '@anthropic-ai/claude-sdk';
import { execSync } from 'child_process';
const sdk = new ClaudeSDK();
async function generateCommitTitle() {
const diff = execSync('git diff --staged').toString();
if (!diff.trim()) return console.log("没有暂存的更改。");
const prompt = `
Based on the following git diff, create a concise, one-line git commit title in Conventional Commit format.
Only reply with the title itself.
Diff:
---
${diff}
`;
const response = await sdk.sendMessage(prompt);
console.log(response.message.trim());
}
generateCommitTitle();
第三步:然后配合:
git commit -m "$(node git-commit-title.js)"
自动生成符合规范的提交信息。
注意:Claude SDK 是为了让你「在不打开 Claude 窗口、自动化批量操作、或者集成到 CI 流程」中使用 Claude 的智能。
比如:
自动生成 Git 提交标题(如你提到的例子)
批量分析文件夹中所有文件的结构
每天自动读取数据库数据,交给 Claude 总结写日报
集成到 CI/CD:测试失败时调用 Claude 自动解释错误原因
定时清理日志,生成摘要并归档发送给管理员
十二、自定义 Claude 命令
在 .claude/commands/
目录中添加:
.claude/commands/lintfix.prompt
内容如下:
Read the currently open file in my IDE and identify all linter warnings.
Then, apply the necessary changes to fix all of them automatically.
Provide a summary of the changes you made.
使用:
/lintfix
即可执行。
十三、Token 成本管理技巧
1. 查看成本:
/cost
2. 减少上下文消耗:
/compact
Claude 会总结历史并释放上下文,降低后续成本。
总结
Claude Code 并不是简单的 AI 编程助手,而是一个全栈 AI 开发工作站。
它能帮你:
- 理解项目结构
- 自动提交代码
- 生成文档 / 创建 PR
- 执行测试 / 修复 bug
- 编写脚本 / 管理成本
- 配合其他 AI 模型,实现混合编程
只要你用得好,它甚至可以 1 人完成一整套 SaaS 工程的全流程开发!