AI Coding - Claude code 使用笔记

Claude Code 概述 - Claude Code Docs

1. 安装

1.1. 下载

1
npm install -g @anthropic-ai/claude-code

1.2. 配置

配置参考：Claude Code 设置 - Claude Code Docs

以 wsl 为例，在 ~/.bashrc 中添加如下配置即可：

1
2
3
4
5
6
7
8
# claude code
# 设置权限跳过模式，核心作用是绕过代码执行前的权限校验环节
alias claude='claude --dangerously-skip-permissions'
# 百炼 API EP
export ANTHROPIC_BASE_URL=https://dashscope.aliyuncs.com/apps/anthropic
export ANTHROPIC_AUTH_TOKEN=sk-**************
# model id
export ANTHROPIC_MODEL=qwen3-coder-plus

vscode 中的 Claude Code for VS Code 插件配置：

打开下面3个配置：

  1. 保证 vscode 可以设置权限跳过模式

image.png

  1. 初始化时使用权限跳过模式，Claude Code 在控制台中开启

image.png

1.3. 使用 zcf 来配置 Claude Code

🔗 GitHub - UfoMiao/zcf: Zero-Config Code Flow for Claude code & Codex
🔗 ZCF - Zero-Config Code Flow | ZCF

前提：需要本地安装 node 环境

快速启动：

1
npx zcf

会出现如下提示：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
[mungdong@dev ~]$ npx zcf
Need to install the following packages:
[email protected]
Ok to proceed? (y) y

✔ Select ZCF display language / 选择ZCF显示语言 1. 简体中文

╔════════════════════════════════════════════════════════════════╗
║                                                                ║
║   ███████╗  ██████╗ ███████╗                                   ║
║       ██╔╝  ██╔═══╝  ██╔═══╝                                   ║
║      ██╔╝   ██║      █████╗                                    ║
║    ██╔╝     ██║      ██╔══╝                                    ║
║   ███████╗  ╚██████╗ ██║                                       ║
║   ╚══════╝   ╚═════╝ ╚═╝        for Claude Code                ║
║                                                                ║
║   Zero-Config Code Flow                                        ║
║                                                                ║
╚════════════════════════════════════════════════════════════════╝

  Version: 3.4.2  |  https://github.com/UfoMiao/zcf

请选择功能
  -------- Claude Code --------
  1. 完整初始化 - 安装 Claude Code + 导入工作流 + 配置 API 或 CCR 代理 + 配置 MCP 服务
  2. 导入工作流 - 仅导入/更新工作流相关文件
  3. 配置 API 或 CCR 代理 - 配置 API URL、认证信息或 CCR 代理
  4. 配置 MCP - 配置 MCP 服务（含 Windows 修复）
  5. 配置默认模型 - 设置默认模型（opus/sonnet/sonnet 1m/自定义）
  6. 配置 Claude 全局记忆 - 配置 AI 输出语言和输出风格
  7. 导入推荐环境变量和权限配置 - 导入隐私保护环境变量和系统权限配置

  --------- 其他工具 ----------
  R. CCR - 配置 Claude Code Router 以使用多个 AI 模型
  U. ccusage - Claude Code 用量分析
  L. CCometixLine - 基于 Rust 的高性能 Claude Code 状态栏工具，集成 Git 信息和实时使用量跟踪

  ------------ ZCF ------------
  8. 更改显示语言 / Select display language - 更改 ZCF 界面语言
  S. 切换代码工具 - 在支持的代码工具之间切换 (Claude Code, Codex)
  -. 卸载和删除配置 - 从系统中删除 Claude Code 配置和工具
  +. 检查更新 - 检查并更新 Claude Code、CCR 和 CCometixLine 的版本
  Q. 退出

如果是第一次使用选择 1 进行完整初始化，否则根据自己需要修改配置即可，它会帮助我们初始化好本地所有的 Claude Code 环境，而且会带有一些工作流以及 git worktree 的使用方法，相对来说还是挺不错的。具体可以查看官网，不做赘述。（注意选择 中文 时会耗费更多的 token）

1.4. 基本使用常见命令

  • /resume ： 查看历史对话记录，选中后继续对话

  • /context ： 输出当前会话的上下文长度，过长的话需要清理后再使用，否则会导致 Claude 出现幻觉，或者可以尝试清理掉不常用的 mcp

  • /clear : 清理当前会话的上下文

  • /stats : 可以查看用了多少 token

  • 双击 ESC 键：当代码被 C C 在某次对话中改错的时候，可以双击 esc ，然后选择对应的对话记录，选择重新存储对应对话的代码记录即可

  • UltraThink 关键字：当设计某个复杂任务的时候，可以试试在提示词中加上 UltraThink 关键字，会消耗更多的 token 和时间，但是代码质量会得到提升

  • ctrl + s : 暂存提示词，它会自动保存提示词，当你在对话输入新的提示词并提交后，你保存的提示词会自动填充到对话框中，什么时候用：写长提示词时突然想起其他事，需要先查看某个文件再继续，临时被打断但不想丢失思路

  • /export [文件名] ： 导出本次的精彩会话到指定文件中（这里的文件名不用写后缀，默认是txt 文件）

2. 插件配合 Claude code 开发探索

2.1. Claude Code SubAgents

2.1.1. github.com/wshobson/agents

73个专家智能体让vibe coding效率翻倍

在 Claude Code 对话框中安装：

1
/plugin marketplace add wshobson/agents

或者直接用这个 prompt 让 Claude Code 帮助我们安装：

1
https://github.com/wshobson/agents 把这些Agents 全部安装到我的 ClaudeCode CLI里, 跳过重复的。

2.2. 自动化工作流

2.2.1. github.com/eyaltoledano/claude-task-master

一个面向使用 Claude 进行人工智能驱动开发的任务管理系统，旨在与 Cursor AI 无缝协作。

提示词（这里是直接把 agent 的权限下放给 Claude Code，让其充分使用）：

1
用尽量多的agent 检查我们的项目,只检查,不修改代码。

TODO 需要整理自动化工作流相关的知识 github.com/eyaltoledano/claude-task-master

3. 有了上述技能，我们应该如何使用 Claude Code

TODO

TODO 待归类

2.1.2 OpenSpec

项目地址： GitHub - Fission-AI/OpenSpec: Spec-driven development for AI coding assistants.

参考：

2.1.1 安装 OpenSpec

1
npm install -g @fission-ai/openspec@latest

2.1.2 OpenSpec 使用

  1. 进入到项目下，使用 OpenSpec 初始化项目：
1
2
# cd /path/to/your-project
openspec init

初始化过程中会发生什么：

  1. 提示你选择使用的 AI 工具（选择 Claude Code）
  2. 自动配置 Claude Code 的斜杠命令（slash commands）
  3. 在项目根目录创建 AGENTS.md 文件
  4. 创建 openspec/ 目录结构
  1. 填充项目信息，对于 OpenSpec 来说，所有的项目信息都保存在 openspec/project.md 下，这里使用 Claude Code 填充下项目要信息，提示词如下：
1
请阅读 openspec/project.md 文件，帮我填写项目的技术栈、架构模式和编码规范

Claude Code 会分析你的项目并生成类似这样的内容：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
# Project Context

## Tech Stack
- **Backend**: Node.js 18, Express.js
- **Database**: PostgreSQL 14
- **Frontend**: React 18, TypeScript
- **Authentication**: JWT, bcrypt
- **Testing**: Jest, Supertest

## Architecture Patterns
- RESTful API design
- MVC pattern
- Repository pattern for data access
- Middleware-based request processing

## Coding Conventions
- Use TypeScript for type safety
- Follow Airbnb JavaScript style guide
- Use async/await for asynchronous operations
- Comprehensive error handling with custom error classes
- Write unit tests for all business logic
  1. 需求开发示例：

在开发需求前，先补充说明下 OpenSpec 为 Claude Code 都安装了哪些插件功能：

/openspec:proposal Scaffold a new OpenSpec change and validate strictly. (project) [搭建一个新的 OpenSpec 变更并进行严格验证]
/openspec:archive Archive a deployed OpenSpec change and update specs. (project) [归档已部署的 OpenSpec 变更并更新规范]
/openspec:apply Implement an approved OpenSpec change and keep tasks in sync. (project) [实施已批准的 OpenSpec 变更并保持任务同步]

TODO

2.2. superpowers - 使用 Claude Code 进行测试驱动开发

项目地址：GitHub - obra/superpowers: Claude Code superpowers: core skills library

参考文章

  1. 我花2天整理了GitHub上17个Claude Code优秀开源项目 | BadAGI.org
  2. 生产级Claude Code SubAgents：73个专家智能体让vibe coding效率翻倍 | BadAGI.org
代码笔记
#AI #VibeCoding
AI Coding - Claude code 使用笔记
https://yangfanbin.cn/代码笔记/AI Coding - Claude code 使用笔记/
作者
Yang Fanbin
发布于
2025年11月11日
许可协议