claudeCode使用总结

简介

Claude Code是由人工智能公司Anthropic推出的一系列AI编程助手，旨在帮助开发者通过自然语言更高效地编写、调试和维护代码。

ClaudeCode是目前市面上最成熟的编码专用 Agent之一。

官网：https://claude.com/

Claude Desktop App、Claude Code CLI

Claude Desktop App：桌面客户端，面向普通用户、研究人员、创意工作者及需要图形化界面的开发者。

Claude Code CLI：面向开发者、DevOps 工程师和极客。它是专为终端工作流设计的 AI 代理（Agent），强调对文件系统的直接操作能力和自动化集成。

特性	Claude Desktop App	Claude Code CLI
界面类型	图形界面 (GUI)	命令行 (TUI/Text)
文件操作能力	只读/建议 (通常生成代码让你复制粘贴)	读写/执行 (直接修改文件、运行命令)
代理能力 (Agent)	较弱 (主要是对话助手)	极强 (自主规划、执行、验证循环)
多模态 (Vision)	支持 (可上传图片/截图)	不支持 (纯文本/代码交互)
主要用户	产品经理、设计师、普通开发者、学生	资深开发者、系统管理员、自动化工程师
MCP 支持	支持 (图形化配置)	支持 (配置文件/环境变量)
安装方式	下载 `.dmg` / `.exe` 安装包	`npm install -g @anthropic-ai/claude-code`
典型指令	"帮我解释这段代码"	"把这个函数的错误修好并提交 git"

官网

https://claude.com/

在国内，很多内容还看不了

使用方式

目前，Claude Code主要通过以下形式提供服务，以满足不同开发者的工作习惯：

类型	名称	访问方式	核心特点	可选模型	适合场景
Web	Claude.ai	浏览器访问 (claude.ai)	无需安装，开箱即用。支持上传文件、图片，有 Artifacts 预览功能，代码任务在云端沙盒执行。	Claude 3.5 Sonnet, Claude 3.5 Opus, Claude 3.5 Haiku	快速问答、文档分析、创意写作、快速原型设计、临时代码片段生成。
App	Claude Desktop	独立应用程序 (macOS/Windows)	比Web版更稳定，深度集成 MCP (可连接本地数据)，支持长对话记忆，界面体验更好。	Claude 3.5 Sonnet, Claude 3.5 Opus, Claude 3.5 Haiku	深度工作流、需要连接本地数据库/GitHub、长时间复杂任务。
CLI	Claude Code	终端命令 (claude)	唯一能直接操作本地文件系统和执行命令的形态。自动化程度最高，像是一个真正的员工。	Claude 3.5 Sonnet, Claude 3.5 Opus, Claude 3.5 Haiku （通过配置可调用非Claude模型）	全栈开发、批量重构、自动 Debug、CI/CD 集成、服务器运维。
插件	Claude Code [Beta]	IntelliJ IDEA等IDE插件	原生差异显示支持。当 Claude Code 建议修改代码时，直接在 IDE 中打开标准 Diff 视图；自动获取当前打开的文件、光标位置和项目结构；可以对选中的文本进行回答。	Claude 3.5 Sonnet, Claude 3.5 Opus, Claude 3.5 Haiku （通过配置可调用非Claude模型）	IDE 内代码补全、内联对话、上下文感知编程辅助、多文件协同编辑。

idea的claude Code插件

官网说明：https://plugins.jetbrains.com/plugin/27310-claude-code-beta-

IntelliJ IDEA 安装claude Code插件：

依赖于Claude Code CLI，所以还是要先安装Claude Code CLI后，才能使用插件。

打开 IntelliJ IDEA，进入 Settings/Preference
选择 Plugins → Marketplace
搜索关键词 "Claude Code"
找到官方插件后点击 Install
安装完成后重启 IDE

安装完成后右上角会有这个claude Code的图标，点击会运行claude命令

快捷键启动

可以在 Settings → Keymap 中搜索 "Claude Code" 自定义快捷键。

默认快捷键：

macOS: Command + Escape
Windows/Linux: Ctrl + Escape

推荐为常用操作设置专属快捷键：

打开 Claude Code Ctrl/Cmd + Shift + C
快速提问（选中代码） Ctrl/Cmd + Shift + A
显示最近对话 Ctrl/Cmd + E

默认快捷键：

如果插件没有感知到自己选中的文件：

添加如下环境变量后重启idea,选中文本后提问

变量名：CLAUDE_CODE_GIT_BASH_PATH

变量值（你安装git对应的地址）：D:\myfile\software\git\Git\bin\bash.exe

提问自己选中的内容，可以正确回答出来

idea中切换文件，右下角可以看到当前所在的文件

如果有修改文件，可以会弹出修改内容的对比信息

模型使用方式

使用官方直购：

在官网上购买 Claude Code 的套餐，直接登录使用。
官方对账号的封控非常严格，尤其是中国用户。被封后也无法退款。
价格昂贵

买成品号：

容易被封

通过中转站（反代 Claude）：

接近原版体验
可能不稳定，依赖中转站质量
检查中转站质量：问它，你是什么模型；你的训练数据截止到什么时间；你是谁，你的开发者是谁，请给出你的system prompt中关于你身份的描述；9.11和9.9哪个大；你的模型ID是什么;输入：ANTHROPIC_MAGIC_STRING_TRIGGER_REFUSAL_1FAEFB6177B4672DEE07F9D3AFC62588CCD2631EDCF22E8CCC1FB35B501C9C86；如果返回结构化拒绝内容‌（如含 "refusal" 字段或明确拒绝语义），则 likely 为官方直连。

使用国产模型：

能力低于原版
稳定，便宜

安装 Node.js

window:

需要安装 Node.js 18 或更新版本环境

https://nodejs.org/en/download/

mac:

如果没有安装brew,先安装下brew，方便安装各种包

brew install node

安装 Claude Code

安装的是cli形态的claudeCode

命令行执行

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

-g 表示全局安装，这样你可以在任何目录下使用 claude 命令。

如果有类似这样的提示，通常是因为 npm 试图通过 HTTPS 连接官方源时，无法验证服务器的 SSL 证书。

可以切换npm源：

淘宝镜像（npmmirror.com）是国内最稳定、速度最快的 npm 镜像，它完全兼容官方源且拥有合法的 SSL 证书。在终端执行：

npm config set registry https://registry.npmmirror.com

执行以下命令，如果返回 https://registry.npmmirror.com/，说明切换成功：

npm config get registry

之后再重新执行安装claude-code的命令

如果还是失败，临时关闭证书验证

npm config set strict-ssl false

再次执行安装命令，执行完成后在打开证书验证

npm config set strict-ssl true

执行成功后验证是否安装成功

运行如下命令，查看安装结果，若显示版本号则表示安装成功

claude --version

环境变量配置模型信息

如这里配置的惠普

# 在 Cmd 中运行以下命令
# 注意替换里面的 `your_zhipu_api_key` 为您上一步获取到的 API Key
setx ANTHROPIC_AUTH_TOKEN your_zhipu_api_key
setx ANTHROPIC_BASE_URL https://api.z.ai/api/anthropic
setx CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 1

指定模型

配置 Claude Code 使用的模型主要有两种方式：

一种是直接使用官方 Anthropic 模型（需网络和账号）
另一种是通过兼容接口配置第三方或国产大模型（如 DeepSeek、Qwen、GLM 等）。

通过环境变量配置（适用于第三方/国产模型）：

获取 API Key 和 Base URL，在提供兼容接口的平台上获取信息，如阿里云千问/智普/硅基流动/DeepSeek/ModelScope (魔搭社区)等
设置环境变量：

Windows (PowerShell):：

$env:ANTHROPIC_BASE_URL="https://你的服务商地址/v1"
$env:ANTHROPIC_API_KEY="你的API_KEY"
# 可选：指定具体模型名称（如果服务商需要显式指定）
$env:ANTHROPIC_MODEL="deepseek-coder-v2-0506"

macOS / Linux (Bash/Zsh):

export ANTHROPIC_BASE_URL="https://你的服务商地址/v1"
export ANTHROPIC_API_KEY="你的API_KEY"
export ANTHROPIC_MODEL="deepseek-coder-v2-0506"

使用配置文件 (config.json)：

通常位于 ~/.claude-code/config.json 或项目根目录的 .claude-code.json。

{
  "provider": "custom",
  "base_url": "https://api.deepseek.com/v1",
  "api_key": "sk-...",
  "model": "deepseek-coder"
}

手动修改配置文件 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_MODEL": "glm-4.6"  // 未指定模型时，默认使用 Sonnet 4.5
  }
}

使用中修改后，要关闭下claude服务（ctrl+c），之后在运行claude命令来使用新模型

使用 Claude Code

在终端中输入claude命令，按下回车键即可启动Claude Code

进入一个您的代码工作目录，在终端中执行 claude 命令即可开始使用 Claude Code

输入1，即代表同意

处理地区限制

执行claude 命令如果出现这样的提示，要进行处理地区限制

在当前登录用户的根目录下找到.claude.json文件

文件最后加入这个配置

"hasCompletedOnboarding": true

提示 Missing API key · Run /login

国内用户环境变量ANTHROPIC_BASE_URL设置值为https://api.z.ai/api/anthropic

Unable to connect to API: SSL certificate verification failed. Check your proxy or corporate SSL certificates

mac电脑安装claudeCode后，进行对话或者其他命名需要模型时报这个错，可以根据这篇文章给的访问进行处理：

https://blog.csdn.net/chaofan980/article/details/150018367

我这里是这样处理的，聚焦搜索钥匙串访问

找到这个证书：DigiCert Global Root G2进行导出，比如导入到了用户目录，之后执行

mv ~/"DigiCert Global Root G2.pem" ~/.ssl/digicert-root.pem
echo 'export NODE_EXTRA_CA_CERTS="$HOME/.ssl/digicert-root.pem"' >> ~/.zshrc
source ~/.zshrc

之后在使用ClaudeCode就没有这个问题了

查看当前使用的模型

使用/model名称查看

配置文件

配置说明文档：https://code.claude.com/docs/zh-CN/settings#%E5%8F%AF%E7%94%A8%E8%AE%BE%E7%BD%AE

用户级设置文件：%USERPROFILE%\.claude\settings.json

其他偏好 / MCP 状态文件：%USERPROFILE%\.claude.json

项目级配置文件：你的项目根目录下 .claude/settings.json

项目 MCP 配置：项目根目录下.mcp.json

settings.json 配置说明

常见 `env` 参数

ANTHROPIC_AUTH_TOKEN
- 作用：用于身份验证的 API 密钥。
- 示例："ANTHROPIC_AUTH_TOKEN": "your_api_key"
ANTHROPIC_BASE_URL
- 作用：指定 Claude API 的基础 URL。这对于使用自定义或兼容的 API 端点（如阿里百炼、智谱 GLM、DeepSeek 等）非常有用。
- 示例："ANTHROPIC_BASE_URL": "https://api.example.com"
API_TIMEOUT_MS
- 作用：设置 API 请求的超时时间（毫秒）。
- 示例："API_TIMEOUT_MS": "3000000"（即 3000 秒或 50 分钟）
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC
- 作用：禁用非必要流量，以减少带宽使用或提高性能。
- 示例："CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
ANTHROPIC_MODEL
- 作用：指定默认使用的模型名称。
- 示例："ANTHROPIC_MODEL": "claude-sonnet-4-5-20250929"
BASH_DEFAULT_TIMEOUT_MS
- 作用：设置 Bash 命令的默认超时时间（毫秒）。
- 示例："BASH_DEFAULT_TIMEOUT_MS": "10000"（即 10 秒）
MAX_THINKING_TOKENS
- 作用：扩展思考的 Token 预算。
- 示例：该参数可能因 Claude Code 版本而异，具体需参考官方文档。
DISABLE_TELEMETRY
- 作用：禁用遥测功能，以保护用户隐私。
- 示例："DISABLE_TELEMETRY": "true"
MCP_TIMEOUT
- 作用：MCP 服务器启动超时（毫秒）。
- 示例：该参数可能因 Claude Code 版本而异，具体需参考官方文档。
MAX_MCP_OUTPUT_TOKENS
- 作用：MCP 工具输出限制（默认 25000）。
- 示例："MAX_MCP_OUTPUT_TOKENS": "50000"

模型选择

若追求与原生 Claude 模型相近的体验，可通过合规中转服务调用 Claude Opus

若注重性价比与低延迟，国产模型（如 GLM-4.7、DeepSeek V3.2、Qwen3-Coder-Plus、Kimi K2）是更优选择

国产模型在长上下文逻辑推理上可能稍逊于 Claude Opus，但日常任务表现无明显差距。

模型配置

官方文档：https://code.claude.com/docs/zh-CN/model-config#environment-variables

涉及的配置文件字段：

model：

这会决定 Claude Code 启动时默认使用哪个模型，但用户仍可以通过 /model 或 --model 切换。

可以配置的值：

别名：别名始终指向最新版本。"default", "sonnet", "opus", "haiku", "sonnet[1m]", "opusplan" 等

完整模型名称：要固定到特定版本，请使用完整模型名称（例如 claude-opus-4-6）或设置相应的环境变量，如 ANTHROPIC_DEFAULT_OPUS_MODEL。

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "sonnet",
  "permissions": {
    "allow": [
      "Bash(npm run lint)"
    ],
    "deny": [
      "Bash(curl *)"
    ]
  }
}

通过环境变量设置默认模型：

在 settings.json 的 env 里，可以通过这些环境变量控制默认模型

ANTHROPIC_MODEL：当前默认模型
ANTHROPIC_DEFAULT_OPUS_MODEL：opus 别名指向的模型
ANTHROPIC_DEFAULT_SONNET_MODEL：sonnet 别名指向的模型
ANTHROPIC_DEFAULT_HAIKU_MODEL：haiku 别名指向的模型

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-api-key-here",
    "ANTHROPIC_BASE_URL": "https://api.qnaigc.com",
    "ANTHROPIC_MODEL": "moonshotai/kimi-k2-thinking",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "moonshotai/kimi-k2-thinking",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "moonshotai/kimi-k2-thinking"
  }
}

启动时默认用 ANTHROPIC_MODEL 指定的模型；当你在 Claude Code 里选 sonnet / haiku 时，实际会用你在这里指定的对应模型。

模型列表配置：

availableModels字段可以配置模型范围，限制用户可以通过 /model、--model 或 ANTHROPIC_MODEL 选择的模型范围

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "sonnet",
  "availableModels": [
    "sonnet",
    "haiku"
  ],
  "permissions": {
    "allow": [
      "Bash(npm run lint)"
    ]
  }
}

多模型映射配置：

如果你想要的是：配置多个模型 ID，让不同别名指向不同模型（比如 sonnet→Kimi、opus→DeepSeek），那不是在 settings 里写“模型列表”，而是在 env 里分别设置各个默认模型环境变量。

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-api-key-here",
    "ANTHROPIC_BASE_URL": "https://api.qnaigc.com",

    "ANTHROPIC_MODEL": "moonshotai/kimi-k2-thinking",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "moonshotai/kimi-k2-thinking",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "moonshotai/k2.5",

    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-chat",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-chat"
  }
}

默认主模型：ANTHROPIC_MODEL（Kimi）
选 sonnet 时：ANTHROPIC_DEFAULT_SONNET_MODEL（Kimi）
选 opus 时：ANTHROPIC_DEFAULT_OPUS_MODEL（DeepSeek）
后台子任务模型：CLAUDE_CODE_SUBAGENT_MODEL

ccswitch

CCSwitch 是一款跨平台的桌面级 AI Coding 中控台工具，专为管理 Claude Code、Codex 和 Gemini CLI 等 AI 编程工具的 API 配置而设计，旨在解决开发者在多个 AI 服务提供商之间频繁切换配置的痛点，提升开发效率。
支持一键切换不同的 API 提供商，无需手动修改配置文件或重启服务。
提供预设服务模板，简化配置流程，用户只需输入 API Key 即可完成配置。
内置技能库，提供超过 500 个 Claude 技能供用户发现和安装，支持一键安装和管理技能，扩展 AI 的功能。
内置端点测试功能，自动识别最快的 API 提供商，优化开发体验。
提供详细的费用监控功能，包括已使用金额统计、剩余额度显示和使用历史记录，帮助用户控制成本。

地址：https://github.com/farion1231/cc-switch

mac下载安装更新

brew tap farion1231/ccswitch
brew install --cask cc-switch
brew upgrade --cask cc-switch

工作模式

使用Shift+Tab进行切换

普通模式（默认模式）：基础交互模式，用户输入指令后，ClaudeCode会生成代码或执行操作，但每次编辑需用户确认。
自动编辑模式：（Shift+Tab 一次）免确认批量操作，ClaudeCode直接修改文件或生成代码，无需用户逐次确认。

计划模式：（Shift+Tab 两次）改模式下只讨论，不进行修改文件，适合需求讨论、前置规划、系统设计、拆解任务、制定执行计划。

在计划模型再进行Shift+Tab就又回到普通模式

记忆类型

User Memory（用户记忆）:

存储与用户个人相关的全局偏好、长期属性及跨项目共享的规则。
适用于所有项目，不绑定特定代码库或开发环境。
数据保存在本地文件系统（如 ~/.claude/CLAUDE.md），支持版本控制（如 Git）。
当与项目记忆冲突时，项目级规则优先生效。
代码风格、工具链等

Project Memory（项目记忆） :

存储与特定项目相关的上下文、历史决策及动态经验，支持团队共享。
每个 Git 仓库或代码目录拥有独立记忆目录（如 ~/.claude/projects/<project-hash>/memory/）。
Claude 在会话过程中主动记录关键信息（如调试经验、架构决策），生成 MEMORY.md 索引文件及主题分块文件（如 debug.md、architecture.md）。
新会话启动时，自动加载索引文件的前 200 行到上下文窗口，按需加载详细内容以避免 Token 消耗。
记忆文件存储在项目根目录（如 ./CLAUDE.md），可通过 Git 同步给团队成员。

CLAUDE.md

CLAUDE.md写什么

claude.md 是 Claude Code 的“项目级系统提示词”。Claude 每次启动时都会自动读取它，以此来理解你的项目背景、约束和规范。

claude.md 的核心策略是：定规范、立边界、强测试、防反模式。

忽略目录/文件

可以在 CLAUDE.md 中用自然语言告诉 Claude **“不要修改”或“不要关注”**某些目录。

也可以利用.claudeignore和.gitignore文件

建议采用以下策略：

无脑加 .claudeignore：把 node_modules/、dist/、build/、package-lock.json、yarn.lock 这种又大又没营养的文件加进去。这些文件动辄几万行，会让 Claude 瞬间爆掉上下文窗口。
保护敏感信息：含有 API Key、数据库密码的 .env 文件一定要加进 .claudeignore，防止敏感数据被读取。

.claudeignore

Claude Code 支持专属的忽略文件，名为 .claudeignore。它的语法和 .gitignore 完全一致，但只对 Claude Code 生效。

在项目根目录下创建一个名为 .claudeignore 的文件。将你不想让 Claude 读取的目录或文件写进去。

# 依赖目录
node_modules/
vendor/
.venv/

# 编译产物
dist/
build/
out/
*.class
*.pyc
*.o

# 大型数据文件或日志
*.csv
*.sql
*.log
data/

# 敏感信息
.env
.env.local
credentials.json
id_rsa

利用.gitignore

Claude Code 默认会自动尊重你项目中的 .gitignore 文件。也就是说，凡是被 Git 忽略的文件，Claude Code 通常也不会去扫描。

如果你发现 Claude 还在试图读取某些已被 Git 忽略的文件，可能是缓存问题，可以通过 /compact 命令清理一下上下文。

思考模式

在输入的关键词后面加入think关键词

有几个档位：

think->think hard->think harder->ultra think

快捷键

按上下键可以选择要使用的命令

按下tab,会用高亮的命令补全输入；

按回车就会执行命令

按shift+回车换行

按esc可以取消执行命令/中断执行

按两下ctrl + c 可以退出 claude code对话

双击esc:

输入框有内容时快速清空输入的内容
输入框没有内容时，展示历史对话记录，使用上下键可以选择历史记录，按回车界面会调整到你选择记录的那个时间点的内容，相当于回滚上下文，也就是对话记录，不会撤销已修改的内容

ctrl+g:Claude Code 会立即启动你系统配置的默认文本编辑器（如 VS Code, Vim, Nano, Sublime Text 等），保存并关闭编辑器后，你编辑好的内容会自动返回到 Claude Code 的会话中，并发送给 AI 处理。读取的$EDITOR 环境变量。mac默认是vi，使用i配合esc和英文:wq 进行编辑保存即可。

ctrl+b: 将当前运行的服务放到后台运行，输入/tasks 来查看后台运行的服务，选中对应的服务，按k可以关闭对应的服务

常用斜杠命令

输入/会有命令提示，后面是对命令的说明信息

启动交互模式

claude：直接进入交互式对话界面。
claude "初始问题"：带问题启动，执行后退出。
claude -p "指令"：一次性执行并退出（非交互模式）。
cat 文件.py | claude -p "优化代码"：通过管道输入内容处理。
claude --dangerously-skip-permissions启动 Claude Code 并自动批准所有操作，包括文件编辑、Shell 命令执行、工具调用等，不再弹出权限确认提示

claude --permission-mode auto 低危操作自动通过，高危操作仍会阻止或提示，兼顾效率与安全

继续或恢复会话

claude --continue 或 claude -c：快速恢复最近中断的任务。
- 单次指令 (Command) claude -c "优化这段代码" 直接在命令行提交 Prompt，无需进入交互式界面。
- 上下文引用 (Context) claude -c [ID/Path] 指定特定的上下文缓存 ID 或本地文件作为背景资料。
- 管道输入 (Piping) cat error.log | claude -c 接收来自其他命令的输出作为输入内容进行分析。

#快速重构：
claude -c "将此函数转换为异步函数" < main.py
#日志诊断：
tail -n 100 app.log | claude -c "分析导致崩溃的根本原因"
#Git 协作：
git diff | claude -c "根据这些更改生成 Commit Message"

claude --resume 或 claude -r：恢复历史对话，支持交互式选择会话。
claude --resume <会话名>：恢复指定名称的会话。

退出与清空

/exit 或 /quit：退出交互模式。
/clear：清空当前对话历史，释放上下文。

初始化项目文档

/init：生成或更新项目根目录下的 CLAUDE.md 文件，存储代码库文档和上下文信息。它会自动扫描你的代码库，生成/更新一个 CLAUDE.md 文件，把项目结构、技术栈、常用命令等写进去，以后每次对话都自动加载这个文件。
CLAUDE.me文件内容:内容包括：项目概述、技术栈、目录结构、常用命令、开发规范等,这个文件会被 Claude Code 在每次会话开始时自动读取，并注入系统提示
使用场景：首次在新项目中启用 Claude Code 时，项目结构或规范发生重大变更时（所以这个命令不是只执行一次）

文件操作

读取文件：直接输入文件名（如 @main.py）或路径（如 @src/utils.js），Claude会加载内容到上下文。
搜索文件：使用@/可以检索文件，也可以直接在输入框中输入文件名称，按tab键也会在当前项目下搜索文件
编辑文件：使用 /edit <文件路径> 旧内容:<旧字符串> 新内容:<新字符串> 精确修改内容。
写入文件：通过 /write <文件路径> 内容 创建新文件或覆盖现有文件。

目录管理：

/add-dir <目录路径>：将额外目录添加到当前会话的工作目录列表，便于跨目录分析。

自动审查代码

/review：自动检测代码漏洞与优化点。
/security-review：对当前分支的待提交更改进行安全审查。

搜索与匹配

查找文件：支持 Glob 模式（如 **/*.js 递归搜索所有 JS 文件）。
内容搜索：使用 /grep "模式" 在文件中搜索文本，支持正则表达式和上下文显示（如 -C 3 显示匹配行前后3行）。

上下文控制

/compact：压缩对话历史，保留摘要以节省 Token，支持自定义摘要指令。可以命令+提示词要增加自己的压缩需求如/compact 尽可能保留完整需求描述信息，也可以不加提示词，压缩完可以按ctrl+o看压缩后的上下文信息，再按ctrl+o返回
/context：查看当前内存和 Token 使用情况。

记忆编辑

/memory：编辑用户/项目记忆文件（如设置技术栈、API地址等），内容保存到 CLAUDE.md 或全局配置文件。
# 记忆模式：输入 # 后跟随的内容会被永久记录，成为AI处理未来请求的基础知识。

模型切换

/model <模型名>：切换使用的模型（如 /model opus 切换高性能模型）。

权限管理

/permissions：查看或修改工具权限（如允许或禁止 Read 操作）。
--dangerously-skip-permissions：跳过所有权限检查（仅限受信任环境，慎用）。

回滚

使用/rewind命令或按两下esc 选择回滚点

选择回滚内容：回滚代码和会话/只回滚回话/只回滚代码/不回滚

回滚代码，只能回滚claude 写入的文件，由终端命令生成的不能被回滚；推荐使用git进行回滚

导出对话

/export：将当前对话导出为文件或复制到剪贴板，便于分享或归档。

团队协作

将 .claude/ 目录提交到 Git，共享 CLAUDE.md 文件和自定义命令，统一团队环境配置。

其他命令

/status:查看当前会话状态：版本、路径、模型、记忆文件、配置信息。

/copy:复制Claude的最后一次响应到剪贴板，或者用/copy N复制第N次之前的响应。

/cost:查看当前会话 token 消耗与预估费用，适合按量计费场景下控制成本。

/doctor:环境诊断工具，检查 API、依赖、权限、版本是否正常。

/simplify —— 进一步精炼 Claude 生成出来的代码

/effort —— 调整 Claude 在执行任务时的思考深度

/rename：给会话设置唯一名称，方便根据名字快速判断这个窗口主要做什么

/color:给当前会话提示栏换个颜色,多个窗口开claude的时候可以标记下颜色，方便快速识别那个窗口做什么内容

/loop：用于自动化重复任务，每隔多久，重复执行一次什么事情，/loop 1m remind me to check email，可以把 /loop 和其他 Claude Code 命令搭配起来用，/loop 1m /stats

/ide ：

让终端中的 Claude Code 与 IDE 建立连接，实现双向协同；Claude 建议的修改会在 IDE 中以 diff 形式展示；在 IDE 中选中一段代码，Claude 会自动看到上下文，你可以直接说 “解释这段代码” 或 “优化它”

选择None的话，会断开与任何 IDE 的连接

/btw:

全称就是 “By the way”（顺便提一下）。核心作用：允许你“插嘴”补充背景信息或离题想法，同时强制 Claude 保持专注，不偏离当前的主线任务。插入临时问题‌、‌不中断主任务‌、‌不污染对话上下文‌的高效交互功能。

特点：

并行处理‌：主任务继续运行，同时独立回答你的问题。
零上下文污染‌：提问与回答‌不会加入主对话上下文。
自动清理‌：回答后按空格、回车或 Esc 即可关闭，不留痕迹。

使用：

直接以 /btw 开头输入内容即可

后台任务

ctrl+b: 将当前运行的服务放到后台运行，输入/tasks 来查看后台运行的服务，选中对应的服务，按k可以关闭对应的服务

图片/文件问答

到文件所在文件夹

拖拽图片/文件到终端命令行窗口
复制文件，到终端命令行窗口使用快捷键（mac:command+v）或右键选择粘贴

截图：

复制后使用快捷键粘贴（mac:control+v）

Hooks 使用

Hooks 是绑定到 Claude Code 工具生命周期事件的自动化脚本。当事件触发时（如文件编辑、命令执行、会话开始），绑定的 hook 会自动执行，通过返回值控制后续行为

可以实现代码风格强制、命令拦截、自动格式化等功能

Hook 事件类型：

事件	触发时机	特殊能力
PreToolUse	工具执行前	可阻止工具调用（exit code 2）
PostToolUse	工具执行后	可访问工具执行结果
SessionStart	会话开始时	注入项目上下文、环境检查
SessionEnd	会话结束时	清理、日志记录
Stop	Claude 完成响应时	可阻止停止，强制继续工作
PreCompact	对话压缩前	保存上下文
Notification	需要用户注意时	发送桌面通知
UserPromptSubmit	用户提交提示时	任务复杂度分析

hook 配置方式

互式配置：使用/hooks命令，按照步骤进行选择和输入命令，自动生成配置到 settings.json

选择事件类型（PreToolUse/PostToolUse/SessionStart 等）
选择匹配的工具（Bash/Edit/Read 等）
输入要执行的命令
要保存到什么级别（用户/项目）

配置文件：settings.json/settings.local.json

# 全局配置 该用户所有项目生效
~/.claude/settings.json

# 项目配置  所有人本项目生效
.claude/settings.json
# 本机/本用户本项目 
.claude/settings.local.json

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash|Edit",  // 正则匹配多个工具
        "hooks": [
          {
            "type": "command",
            "command": "bash .claude/hooks/validate.sh",
            "async": false,
            "timeout": 30
          }
        ]
      }
    ],
    "SessionStart": [...],
    "PostToolUse": [...]
  }
}

bash命令

输入!接要输入的命令，就跟在命令行一样执行系统命令

MCP 相关命令

官方文档：https://code.claude.com/docs/zh-CN/mcp

# 添加一个 MCP 服务器（HTTP/SSE/stdio）
claude mcp add --transport <http|sse|stdio> <name> <url-or-command>

# 真实示例：连接到 Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp

# 带有 Bearer 令牌的示例
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"
  
  # 显式指定本地范围
claude mcp add --transport http stripe --scope local https://mcp.stripe.com


# 列出所有已配置的服务器
claude mcp list

# 查看某个服务器详情
claude mcp get <name>

# 删除某个服务器
claude mcp remove <name>

# 在 Claude Code 会话中查看 / 管理 MCP 状态
/mcp

使用 --scope 标志指定配置的存储位置：

local（默认）：仅在当前项目中对您可用（在较旧版本中称为 project）
project：通过 .mcp.json 文件与项目中的每个人共享
user：在所有项目中对您可用（在较旧版本中称为 global）

使用 --env 标志设置环境变量（例如，--env KEY=value）

使用 MCP_TIMEOUT 环境变量配置 MCP 服务器启动超时（例如，MCP_TIMEOUT=10000 claude 设置 10 秒超时）

当 MCP 工具输出超过 10,000 个令牌时，Claude Code 将显示警告。要增加此限制，请设置 MAX_MCP_OUTPUT_TOKENS 环境变量（例如，MAX_MCP_OUTPUT_TOKENS=50000）

安装了mcp的情况下，在# 在 Claude Code 会话中查看 / 管理 MCP 状态

skills说明

Skill 文件格式

---
name: code-review
description: Review code for style and security issues
allowed-tools: Read, Grep, Glob
---

## Task
Review the specified code file...

## Steps
1. Read the code file
2. Analyze for issues
3. Generate report

skills安装

在claude中插件市场安装/下载好放到指定文件夹中的文件系统安装方式/使用部分软件有安装功能也是安装到指定文件夹/插件详情有安装命令进行安装等

通过插件市场安装（推荐）

以官方 Anthropic Skills 市场为例,在 Claude Code 输入

/plugin marketplace add anthropics/skills

安装完成后，你就已经具备了使用官方 Skills 的能力。

安装插件：

输入：/plugin

选择第一个回车，选择插件市场

选择要安装的skill

也可以直接指定插件市场和skills进行安装

/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills

document-skills：PDF、Excel 等文档的读取和分析

example-skills，展示各种领域的 Skill 实现示例，供学习和参考

claude-api：直接调用 Claude API 的高级功能

example-skills：

example-skills是 Anthropic 官方维护的官方示例技能合集，托管在 GitHub 的 anthropics/skills 仓库中

是否可以直接使用：大部分可以直接使用，但部分需要调整

需要调整的技能主要是哪些需要放入自己个性化的内容的技能，修改修改可以用

文档技能：

docx - Word 文档创建、编辑和分析（支持修订追踪、评论、格式保留）
pdf - PDF 提取和生成（文本、表格、表单处理）
pptx - PowerPoint 演示文稿创建（布局、模板、图表）
xlsx - Excel 电子表格生成（公式、格式化、数据分析）
doc-coauthoring - 文档协作修订

创意与设计类：

algorithmic-art - 艺术创作工作流
music - 音乐相关任务
design - 设计工作流

开发与技术类：

web-app-testing - Web 应用测试
mcp-server-generation - MCP 服务器生成
webapp-testing - 测试相关技能，Playwright自动化测试，安装即用

企业与通信类：

brand-guidelines - 应用 Anthropic 官方品牌颜色和字体
internal-comms - 撰写内部通讯（状态报告、新闻稿、FAQ）
theme-factory - 使用 10 种预设专业主题或生成自定义主题

元技能：

skill-creator - 帮你写技能的技能，通用性强，几乎无需改动
template-skill - 新技能的基础模板

通过市场安装的位置是到了这里

本地安装

根据情况在如下文件夹中存放skill文件夹

用户级别（当前用户可用）：~/.claude/skills

项目级别：your-project/.claude/skills/

会话/临时级别：

# 临时加载本地 Skill（不安装）
/plugin load /path/to/temp-skill.md

优先级（高优先级覆盖低优先级）：临时>项目级别>用户级别

安装skills的时候会问安装到那个级别

使用ccswitch安装

可以看到它是按照的用户级别的

skills更新

使用skills仓库的skills也需要手动进行更新

#强制更新
/plugin install document-skills@anthropic-agent-skills --force
# 或先卸载再安装
/plugin uninstall document-skills
/plugin install document-skills@anthropic-agent-skills

skills使用

# 自动触发（根据 description 匹配）
"请帮我审查这段代码"

# 斜杠命令手动调用
/code-review
# 或提示词中说明用什么skill
use code-review

subagent

SubAgent（子代理）是一种让主 Claude 会话委派任务给独立工作单元的机制。每个子代理拥有独立的上下文窗口（200K tokens），工作完成后只返回结果摘要，避免主会话上下文被噪声污染

特性	说明
隔离上下文	子代理有独立的 200K token 上下文，不继承主对话历史
并行执行	最多可同时运行约 10 个子代理
工具白名单	可限制子代理只能使用特定工具（如只读）
自动/手动触发	根据 `description` 自动匹配，或手动 `/agent-name` 调用

创建 SubAgent 的两种方式

claude
/agents

按向导操作：

选择 Create new agent
设置作用域（Personal 全局可用 / Project 仅当前项目）
让claude初始化还是完全手动创建，选择让claude初始化
输入描述让 Claude 自动生成 prompt
选择允许的工具（如仅 Read-only）
选择模型
选择颜色

生成完成后可以根据提示按快捷键进行修改

手动配置文件：

创建 .claude/agents/<name>.md 或~/.claude/agents/<name>.md

---
name: code-reviewer
description: Review code for security issues. Use after code changes.
tools: Read, Grep, Glob          # 工具白名单
model: sonnet                    # 模型选择
permissionMode: plan             # 权限模式
---

你是一个代码审查专家。检查安全问题、代码规范，提供具体行号的改进建议。

输出格式：
- 安全问题：[列表]
- 规范问题：[列表]

调用 SubAgent

自动触发：Claude 根据 description 自动判断何时调用。

手动调用：

/code-reviewer
# 或
use code-reviewer

plugin说明

plugin把一系列的skill,hooks,subagent打包到一起，安装一个plugin就可以获得一套能力

YOLO模式

YOLO 模式是 Claude Code 的一种高自主性运行模式，其核心特点是 AI 自动执行所有操作，无需人工确认，此模式会跳过所有权限提示，存在安全风险

建议仅在沙箱或受控环境中使用

命令行启动

claude --dangerously-skip-permissions

使用经验

已有项目

命令行定位到项目目录后，执行claude命令启动claude
/init：让claude了解项目结构信息，并生成CLAUDE.md文件
shift+tab:切换到 plan模式，进行沟通需求，看需求实现计划，要执行还是继续调整，执行的话就会操作文件了

启动子代理

在 Claude Code 对话中直接请求创建子代理：

帮我并行处理以下任务

使用Task工具创建多个子代理并行开发

启动多个独立 Claude Code 实例：

在不同终端分别执行，每个实例在独立的 Git worktree 中工作，互不干扰

# 终端 1 - 功能 A
claude --worktree feat-1024-payments

# 终端 2 - 功能 B  
claude --worktree fix-987-auth-timeout

# 终端 3 - 重构任务（后台模式）
claude --worktree refactor-api-layer --tmux

查看所有进行中的任务

git worktree list

输出示例：

/path/to/project              [main]
/path/to/.claude/worktrees/feat-1024-payments    [worktree-feat-1024-payments]
/path/to/.claude/worktrees/fix-987-auth-timeout  [worktree-fix-987-auth-timeout]

查看后台任务：

/bashes

配合git使用

配合codex和Gemini

Claude code 负责设计与指挥，codex负责后端代码和处理bug，gemini负责前端代码

协作方式：

openai官方插件

codex-plugin-cc 是 OpenAI 官方于 2026年3月30日-31日发布的一个 Claude Code 插件

允许开发者直接在 Claude Code 工作流中调用 OpenAI 的 Codex 进行代码审查和任务委派

文档方式：

claude code 把要做的工作markdown的方式写到文件，codex和Gemini根据文档干活，干完活把总结摘要写成文件，claude code 读取结果

mcp方式：

mr-tomahawk/codex-cli-mcp-tool

Claude 需承载 Codex 返回的所有输出

开源项目协同处理

ccb

https://github.com/bfly123/claude_code_bridge

简称 CCB，是一个多 AI 协作终端中枢，专门解决"多个 AI 代理上下文混乱"的问题。

让多个 AI 代理在同一个终端里协同工作，同时保持上下文隔离和最小化 token 开销。

比 MCP 模式更好的上下文隔离（状态持久化到磁盘，不占用 Claude 上下文）

比手动 tmux更系统的会话管理（恢复、权限控制、布局自动化）

支持多 AI 同时运行（Claude + Codex + Gemini 三方协作）

CCB 的解决方案：
┌─────────────────────────────────────────┐
│ WezTerm 终端（底层承载） │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ Claude │ │ Codex │ │ Gemini │ │
│ │ 面板 │ │ 面板 │ │ 面板 │ │
│ │ (独立) │ │ (独立) │ │ (独立) │ │
│ └────┬────┘ └────┬────┘ └────┬────┘ │
│ │ │ │ │
│ └───────────┴───────────┘ │
│ CCB 桥接层 │
│ （消息路由，状态持久化） │
└─────────────────────────────────────────┘
↑
上下文隔离：每个 AI 在自己的面板运行
持久化：会话状态保存在文件系统，不占用 Claude 上下文

OmO

https://github.com/code-yeongyu/oh-my-openagent

原名为oh-my-opencode，更名为了oh-my-openagent，是一个功能强大的 OpenCode 插件/封装层，主打多 Agent 智能编排。

智能体矩阵：

Oh My OpenCode 的核心是11个专业AI智能体，各自负责不同领域。主脑 Sisyphus 负责拆分和协调复杂任务；Prometheus 专注于高精度的代码生成与调试；Librarian 则能快速探索和理解陌生的代码库。这些智能体如同一个专业团队，协同工作，共同应对不同的开发挑战。

Sisyphus（默认主脑）
特长：任务规划与智能执行
模型：Claude Opus 4.6（超强大脑）
作用：像个项目经理，自动拆分复杂任务，协调其他智能体并行工作
场景："帮我重构这个模块"、"给我搭个REST API"
Prometheus（精准专家）
特长：高精度代码生成与调试
用法：按 Tab 键切换进入
作用：当你需要精确控制时，它就是你的狙击手
场景：修复特定bug、实现复杂算法
Librarian（知识管家）
特长：代码库探索与文档管理
作用：帮你快速理解陌生代码库，找到需要的代码
场景：接手老项目、学习新框架
Explore（代码侦探）
特长：深度代码搜索与分析
作用：在海量代码中精准定位
场景：查找特定功能的实现、代码审查
Oracle（智慧顾问）
特长：技术问答与架构咨询
作用：遇到技术难题？它就是你的技术导师
场景：架构设计、技术选型
️ Multimodal Looker（多模态助手）
特长：图像分析、PDF解读、图表理解
作用：不只是代码，连设计稿都能看懂
场景：根据UI图生成代码、分析技术文档
还有其他智能体：
Momus：任务管理专家
Atlas：系统架构师
Metis：性能优化师

自动化钩子：

项目内置了超过40+个生命周期钩子，能自动化处理许多繁琐的开发环节。例如，当工具输出过长时，钩子会自动进行压缩和摘要；它能自动注入项目的README文档以提供上下文；甚至在token即将超限时，也会提前进行上下文压缩。这些自动化流程显著减少了手动干预。

Grep输出截断：搜索结果太长？自动帮你精简

工具输出压缩：大段输出自动摘要

目录README注入：自动读取项目文档，提供上下文

空任务检测：智能识别无意义的任务请求

自动更新检查：保持插件始终最新

上下文压缩：快要超token限制？提前帮你精简

其他：

用提示词让Claude code调用codex exec "prompt"来调用Codex：Codex思考过程会占用Claude code 的上下文

posted @ 2025-11-03 10:30 星光闪闪阅读(2470) 评论(0) 收藏举报

刷新页面返回顶部

星光闪闪