一周深度使用 Claude Code 的总结与实用技巧（安装、配置、高阶玩法全指南）

众乐乐_2016

22781人浏览 · 2025-06-15 16:36:37

众乐乐_2016 · 2025-06-15 16:36:37 发布

过去一周，我用 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 使用的精髓！

避免提示歧义

使用：

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.

使用：