Claude Code 简明使用指南
Claude Code 是 Anthropic 公司开发的 AI 编程助手，基于 Claude 大语言模型，专为优化软件开发工作流程设计。作为一个面向编程的智能 Agent，它可以调用各种工具来扩展功能，帮助处理复杂的开发任务。与传统的 AI IDE 模式不同，Claude Code 采用 命令行界面（CLI），用户只需提出需求、建议或代码改写、修复和重构要求，Claude Code 在后端自动完成任务，减少手动编码负担。
Claude Code 支持调用内置工具和外部 MCP（Model Context Protocol）服务器扩展能力，这些工具可用于文件系统操作、网络搜索、代码执行等。以下是通过网络资料（基于 Anthropic 官方文档和社区资源）列出的一些常见内置工具示例（实际可用工具取决于配置和 MCP 服务器）：
-
文件操作工具
- Read：读取本地文件内容，支持图片、PDF、Jupyter notebook等格式
- Write：写入或创建文件，会覆盖现有文件
- Edit：精确替换文件内容中的字符串
- MultiEdit：对单个文件进行多次编辑操作
- NotebookEdit：编辑Jupyter notebook的特定单元格
- Glob：快速文件模式匹配，支持通配符搜索
- Grep：基于ripgrep的强大搜索工具，支持正则表达式
-
命令执行工具
- Bash：执行bash命令，支持超时设置、后台运行
- BashOutput：获取后台bash命令的输出
- KillShell：终止运行中的后台bash shell
-
任务管理工具
- TodoWrite：创建和管理结构化任务列表，跟踪进度
- Task：启动新代理处理复杂多步骤任务
- ExitPlanMode：退出计划模式，准备编写代码
-
搜索与研究工具
- WebSearch：网络搜索获取最新信息
- WebFetch：获取并分析网页内容
-
MCP工具
- ListMcpResourcesTool：列出可用的MCP服务器资源
- ReadMcpResourceTool：读取MCP服务器特定资源
- mcp__ide__getDiagnostics：获取VS Code语言诊断信息
- mcp__ide__executeCode：在Jupyter内核中执行Python代码
-
Git版本控制
- 支持git status、git diff、git log等查看命令
- 支持创建git提交，自动生成提交消息
- 支持创建和管理pull request
- 自动遵循git提交规范，包含署名信息
-
功能特点
- 多任务并行：可同时运行多个工具以提高效率
- 安全限制：仅协助防御性安全任务，拒绝恶意代码创建
- 代码风格：遵循现有代码约定，优先编辑而非创建文件
- 简洁响应：保持回答简洁，避免不必要的解释
- 任务管理：自动使用TodoWrite工具跟踪复杂任务进度
这些工具能够全面协助程序员完成各种软件工程任务，包括代码编写、文件管理、调试、测试、版本控制等。
核心功能特点
🤖 智能代码辅助
- 代码生成、补全和重构：自动生成代码片段，补全现有代码，或优化代码结构。
- 错误检测和调试帮助：识别代码中的错误并提供修复建议，简化调试过程。
- 代码解释和文档生成：为代码生成注释或文档，提升可读性和维护性。
📝 上下文记忆系统
- 分层记忆管理：支持企业、项目和用户级别的记忆层级，确保上下文一致性。
- 自动加载相关上下文：根据项目自动加载相关配置和历史信息。
- 个性化偏好设置：允许用户自定义行为和输出风格。
🛠️ 开发工具集成
- 终端命令行界面：通过 CLI 与开发流程无缝交互。
- 与现有环境集成：兼容多种 IDE 和工具链。
- 多语言支持：支持主流编程语言和框架（如 Python、JavaScript 等）。
🔧 实用功能
- /memory 命令：管理项目和用户级记忆文件，便于记录和复用上下文。
- # 快捷方式：快速添加待办事项或记忆条目。
- 递归查找配置文件：自动加载项目中的
CLAUDE.md或CLAUDE.local.md文件。
主要优势
- 一致性：通过记忆系统确保代码风格和团队规范统一。
- 效率：自动化重复性编码任务，显著提升开发效率。
- 协作：支持团队共享项目记忆和规范，促进协作。
- 可定制：根据组织或个人需求灵活配置功能。
Claude Code 旨在成为开发者的智能编程伙伴，通过深入理解代码上下文和团队规范，提供精准、高效的编程协助。
claude
╭───────────────────────────────────────────────────╮
│ ✻ Welcome to Claude Code! │
│ │
│ /help for help, /status for your current setup │
│ │
│ cwd: H:\codes\a8-agent │
│ │
│ ─────────────────────────────────────────────── │
│ │
│ Overrides (via env): │
│ │
│ • API Base URL: │
│ https://open.bigmodel.cn/api/anthropic │
╰───────────────────────────────────────────────────╯
安装 Claude Code
通过 npm 全局安装 Claude Code：
npm install -g @anthropic-ai/claude-code
如果已经安装了
@anthropic-ai/claude-code，再次执行该命令会安装最新版本（升级）
环境变量设置
Claude Code 不仅仅可以对接 Anthropic 的模型，还可以对接其他模型（如 GLM、DeepSeek、KIMI 等），形成一个中立的工具。通过自定义 API 端点和模型配置，可以更好地利用其 Agent 能力，支持多提供商集成，实现更灵活的 AI 驱动开发。
Claude Code 支持通过环境变量配置 API 端点、认证和模型选择，以适应不同服务提供商或自定义需求。
- ANTHROPIC_BASE_URL：指定 Anthropic API 的基础 URL，用于覆盖默认端点（如
https://api.anthropic.com），适用于自定义服务器或代理。 - ANTHROPIC_AUTH_TOKEN：提供 API 认证令牌（API Key），用于验证请求权限。
- ANTHROPIC_MODEL：指定默认使用的 Claude 模型（如
glm-4.5-air、claude-3-sonnet）。 - ANTHROPIC_SMALL_FAST_MODEL：指定快速或轻量任务的备用模型，优化速度和成本。
1. GLM-4.5 配置示例
适用于使用 GLM-4.5 模型的场景：
export ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic
export ANTHROPIC_AUTH_TOKEN=sk-****
export ANTHROPIC_MODEL=glm-4.5-air
export ANTHROPIC_SMALL_FAST_MODEL=glm-4.5-air
2. DeepSeek 配置示例
适用于 DeepSeek API 的配置：
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=sk-****
export ANTHROPIC_MODEL=deepseek-chat
export ANTHROPIC_SMALL_FAST_MODEL=deepseek-chat
3. KIMI2 配置示例
适用于 Moonshot KIMI2 模型的配置：
export ANTHROPIC_BASE_URL=https://api.moonshot.cn/anthropic
export ANTHROPIC_AUTH_TOKEN=sk-****
export ANTHROPIC_MODEL=kimi-k2-turbo-preview
export ANTHROPIC_SMALL_FAST_MODEL=kimi-k2-turbo-preview
各个模型的API Key可以到各模型提供商的开发平台网站获取
Claude 目录结构
Claude Code 使用以下目录和文件存储配置和缓存：
-
~/.claude/：缓存文件夹，包含以下子目录：
-
projects：存储项目相关信息。 todos：存储待办事项。-
plugins：存储扩展插件。 -
~/.claude.json：主配置文件，存储全局设置（如 MCP 服务器、工具权限）。
Claude 选项
以下是 Claude Code CLI 的常用子命令和配置选项，用于管理设置和功能。
1. 配置（config）
管理 Claude Code 的配置项，如工具权限、主题等。
- 获取全部配置： 查看当前配置：
claude config list
{
"allowedTools": [],
"hasTrustDialogAccepted": false
}
-
显示所有配置项，例如工具权限（
allowedTools）和信任对话框状态（hasTrustDialogAccepted）。 -
更改设置： 修改特定配置项：
claude config set hasTrustDialogAccepted true
-
将信任对话框状态设为已接受，允许工具调用。
-
config 子命令： 查看帮助：
claude config --help
- get [options]
：获取指定配置项的值。 - set [options]
- remove|rm [options]
[values...] ：移除配置项或数组中的值。 - list|ls [options]：列出所有配置项。
- add [options]
<values...] ：向配置数组添加值（支持空格或逗号分隔）。
2. MCP 操作
管理 Model Context Protocol（MCP）服务器，用于扩展 Claude Code 功能（如文件系统访问、Web 搜索）。
- 增加 SSE 的 MCP 服务： 添加基于 Server-Sent Events（SSE）的 MCP 服务器：
# add 模式
claude mcp add bocha-mcp https://mcp.bochaai.com/sse --header "Authorization=Bearer sk-***"
Added stdio MCP server bocha-mcp with command: https://mcp.bochaai.com/sse to local config
File modified: C:\Users\***\.claude.json [project: C:\Users\***\.claude]
# add-json 模式
claude mcp add-json bocha-search '{"type": "sse","url":"https://mcp.bochaai.com/sse","headers": {"Authorization": "Bearer sk-***"}}'
Added sse MCP server bocha-search to local config
-
配置存储在
~/.claude.json中，指定服务器 URL 和认证头。 -
增加 STDIO 的 MCP 服务： 添加基于标准输入输出的 MCP 服务器（如文件系统访问）：
claude mcp add filesystem --scope user -- npx -y @modelcontextprotocol/server-filesystem ~/Documents ~/Projects
-
指定用户级作用域，允许访问
~/Documents和~/Projects。 -
清理默认选择项： 重置项目级 MCP 批准状态，清除之前的拒绝记录：
claude mcp reset-project-choices
3. 类 Unix 模式
Claude Code 作为 CLI 工具，提供了类 Unix 工具能力，可以作为 CI/CD pipeline 的一个环节，完整保留了所有 Agent 的能力。
如下例，利用内置工具列举出当前路径的文件:
claude -p "列出当前目录的sh文件"
jdk8.sh
或者直接分析运行日志，排查错误:
tail -f app.log | claude -p "Slack me if you see any anomalies appear in this log stream"
利用 | 管道符，可以串联执行和输出:
cat jdk8.sh | claude -p "详细解释该脚本作用"
这是一个bash脚本，用于配置Java开发环境并验证安装：
**脚本作用详解：**
1. **设置JAVA_HOME环境变量**：
- 将`JAVA_HOME`设置为`/e/jdk-8u45-windows-x64/jdk1.8.0_45`
- 这指定了JDK 8 Update 45的安装路径
2. **配置PATH环境变量**：
- 将Java的bin目录添加到系统PATH中
- 确保可以在任何目录直接使用Java命令
3. **验证Java安装**：
- 执行`java -version`检查Java是否正确安装
- 显示Java版本信息以确认环境配置成功
**使用场景：**
- 临时配置Java开发环境
- 在没有永久设置环境变量的系统上运行Java程序
- 确保使用特定版本的JDK（此脚本使用JDK 8u45）
**注意：**
- 路径`/e/jdk-8u45-windows-x64/jdk1.8.0_45`是Linux/Unix风格的路径，在Windows系统上可能需要调整为`E:\jdk-8u45-windows-x64\jdk1.8.0_45`
4. 与 VSCode 连接
Claude Code CLI 也能通过 IDE 的 Claude Code 插件配合,在 Claude Code CLI 中直接对 IDE 当前活动代码进行修改,如下:
VSCode 连接示例
claude --ide "VSCode"
╭───────────────────────────────────────────────────╮
│ ✻ Welcome to Claude Code! │
│ │
│ /help for help, /status for your current setup │
│ │
│ cwd: H:\codes\A8\aip-querymodel │
│ │
│ ─────────────────────────────────────────────── │
│ │
│ Overrides (via env): │
│ │
│ • API Base URL: │
│ https://open.bigmodel.cn/api/anthropic │
╰───────────────────────────────────────────────────╯
> VSCode
● I'll help you with whatever you need in VSCode. What would you like to do?
╭─────────────────────────────────────────────────────────────────╮
│ > Try "edit <filepath> to..." │
╰─────────────────────────────────────────────────────────────────╯
? for shortcuts ⧉ In QueryModel.tsx
当前 VSCode 当前代码是 QueryModel.tsx，如果切换到其他代码，Claude Code CLI 也会切换到对应的代码上下文
Cursor 连接示例
claude --ide "Cursor"
╭───────────────────────────────────────────────────╮
│ ✻ Welcome to Claude Code! │
│ │
│ /help for help, /status for your current setup │
│ │
│ cwd: H:\codes\s7-deploy\s7-backend │
│ │
│ ─────────────────────────────────────────────── │
│ │
│ Overrides (via env): │
│ │
│ • API Base URL: │
│ https://open.bigmodel.cn/api/anthropic │
╰───────────────────────────────────────────────────╯
Tips for getting started:
Run /init to create a CLAUDE.md file with instructions for Claude
Use Claude to help with file analysis, editing, bash commands and git
Be as specific as you would with another engineer for the best results
> Cursor
● I'll help you with your work. What would you like me to do?
╭─────────────────────────────────────────────────────────────────╮
│ > Try "edit <filepath> to..." │
╰─────────────────────────────────────────────────────────────────╯
? for shortcuts ⧉ In ConditionController.java
当前 Cursor 当前代码是 ConditionController.java，如果切换到其他代码，Claude Code CLI 也会切换到对应的代码上下文
环境诊断和升级
1. 运行环境诊断
检查 Claude Code 的安装、配置和网络状态：
claude doctor
Diagnostics
└ Currently running: npm-global (1.0.109)
└ Path: D:\nvm\v22.9.0\node.exe
└ Invoked: C:\Users\***\AppData\Roaming\npm\node_modules\@anthropic-ai\claude-code\cli.js
└ Config install method: unknown
└ Auto-updates enabled: default (true)
└ Update permissions: Yes
└ Search: OK (vendor)
- 输出包括版本、安装路径、自动更新状态等，帮助排查问题。
2. 版本升级
检查并安装最新版本：
claude update
Current version: 1.0.109
Checking for updates...
New version available: 1.0.110 (current: 1.0.109)
Installing update...
Using global installation update method...
Successfully updated from 1.0.109 to version 1.0.110
- 确保使用最新功能和修复已知 bug。
Claude 内置指令
在 Claude Code REPL 环境中使用以 / 开头的指令管理会话和功能。
/context
显示当前上下文使用情况，以彩色网格形式可视化：
/context
⎿
⛁ ⛀ ⛀ ⛀ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶
⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶
⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ Context Usage
⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ glm-4.5-air • 3k/200k tokens (2%)
⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶
⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛁ System prompt: 3.3k tokens (1.7%)
⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛁ System tools: 1 tokens (0.0%)
⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛁ Messages: 105 tokens (0.1%)
⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ Free space: 196.5k (98.3%)
⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶
- 显示模型、已用标记数（tokens）和剩余空间，帮助管理上下文限制。
/agents
管理代理配置，定义特定任务的行为：
/agents
╭────────────────────────────────────────────────────────────────────────────────────────
│ Create new agent
│ Describe what this agent should do and when it should be used (be comprehensive for best results)
│
│ 帮我整理国内外新闻信息，优先使用 mcp 中的web search相关功能
╰─────────────────────────────────────────────────────────────────────────────────────────
Press Enter to submit · Esc to go back
- 创建代理后，Claude Code 根据用户输入自动调用相应代理：
今天有什么国内外新闻
● I'll help you get today's news from both domestic and international sources.
news-organizer(Organize today's news)
⎿ Fetch(https://www.people.com.cn)
Error: Claude Code is unable to fetch from www.people.com.cn
+1 more tool use
✢ Whatchamacalliting… (esc to interrupt)
生成的
agent默认以markdown格式保存在~/.claude/agents/news-organizer.md，也可以自行在 Claude Code之外参考其格式增加新的agent，网络上也有一些提供agent的模板网站：https://www.aitmpl.com/
/config
打开配置面板，管理偏好设置：
/config
╭─────────────────────────────────────────────────────────╮
│ Settings │
│ Configure Claude Code preferences │
│ │
│ Auto-compact true │
│ │
│ Use todo list true │
│ │
│ Verbose output false │
│ │
│ ❯ Theme Dark mode │
│ (colorblind-friendly) │
│ Notifications Auto │
│ │
│ Output style default │
│ │
│ Editor mode normal │
│ │
│ Model Default │
│ (recommended) │
│ Auto-connect to IDE (external terminal) false │
│ │
╰─────────────────────────────────────────────────────────╯
↑/↓ to select · Enter/Tab/Space to change · Esc to close
- 配置主题、通知、输出样式等，提升用户体验。
/cost
显示当前会话的成本和持续时间：
/cost
⎿ Total cost: $0.2176 (costs may be inaccurate due to usage of unknown models)
Total duration (API): 46.1s
Total duration (wall): 1h 45m 47.0s
Total code changes: 0 lines added, 0 lines removed
Usage by model:
glm-4.5-air: 45.8k input, 584 output, 20.4k cache read, 0 cache write
claude-sonnet: 10.3k input, 1.2k output, 57.0k cache read, 0 cache write
- 跟踪 API 使用情况，便于订阅用户关注用量和费用情况。
/status
显示当前会话状态，包括版本、工作目录和配置：
/status
Claude Code v1.0.110
L Session ID: b36df2de-c284-4e3e-829b-3a31a2934b3f
Working Directory
L H:\codes\a8-agent
System Diagnostics • /doctor
⚠ Config mismatch: running npm-global but config says unknown
Account
L Auth Token: ANTHROPIC_AUTH_TOKEN
API Configuration
L Anthropic Base URL: https://open.bigmodel.cn/api/anthropic
Model • /model
L glm-4.5-air
- 提供运行环境和配置概览。
/export
将当前会话内容复制到剪贴板或者文件：
/export
⎿ Conversation copied to clipboard
/compact
压缩对话历史，保留总结以节省上下文：
/compact
✶ Compacting conversation… (esc to interrupt)
- 支持
Ctrl + R查看完整总结。
/clear
清除对话历史并重置上下文：
/clear
- 释放上下文标记，开始全新会话，在回话上下文超出的时候，或者进入全新主题的场景使用。
/memory
管理项目和用户级记忆文件：
- 项目记忆：
./CLAUDE.md，存储项目特定上下文。 - 用户记忆：
~/.claude/CLAUDE.md，存储用户级上下文。 - 递归读取：从当前目录向上查找
CLAUDE.md或CLAUDE.local.md，子目录中的文件在访问时加载。 - 用法：
/memory
Learn more:
https://docs.anthropic.com/en/docs/claude-code/memory
╭─────────────────────────────────────────────────────────╮
│ │
│ Select memory to edit: │
│ │
│ ❯ 1. User memory Saved in ~/.claude/CLAUDE.md │
│ 2. Project memory Checked in at ./CLAUDE.md │
│ │
╰─────────────────────────────────────────────────────────╯
- 使用
#快捷方式快速添加记忆，系统提示选择存储位置。
/model
选择或切换 Claude Code 使用的模型：
/model
╭─────────────────────────────────────────────────────────────────╮
│ │
│ Select Model │
│ Switch between Claude models. Applies to this session and │
│ future Claude Code sessions. For custom model names, specify │
│ with --model. │
│ │
│ 1. Default (recommended) Use the default model │
│ (currently Sonnet 4) · … │
│ 2. Opus Opus 4.1 for complex tasks │
│ · $15/$75 per Mtok │
│ 3. Opus Plan Mode Use Opus 4.1 in plan mode, │
│ Sonnet 4 otherwise │
│ ❯ 4. glm-4.5-air Custom model ✔ │
│ │
╰─────────────────────────────────────────────────────────────────╯
- 支持动态切换模型，适用于不同任务需求。
/permissions
管理工具和服务器权限：
/permissions
╭─────────────────────────────────────────────────────────────────╮
│ Permissions: Allow Ask Deny Workspace │
│ │
│ Claude Code won't ask before using allowed tools. │
│ │
│ ❯ 1. Add a new rule… │
│ 2. Bash(gh pr:*) │
│ 3. mcp__bocha-mcp__* │
│ 4. WebFetch(domain:news.sina.com.cn) │
│ 5. WebFetch(domain:www.bbc.com) │
│ 6. WebFetch(domain:www.people.com.cn) │
│ 7. WebFetch(domain:www.reuters.com) │
│ 8. WebSearch │
│ │
╰─────────────────────────────────────────────────────────────────╯
- 控制工具访问权限（如 MCP、Web 搜索），确保安全性和合规性。
输入模式
Claude Code REPL 支持多种输入模式，便于不同任务。
1. Shell 模式
执行 shell 命令：
-
触发：输入
!进入 bash 模式。 -
快捷键：
- 双击
Esc：清除输入。 -
Ctrl + _：撤销操作。 -
示例：
! pwd
⎿ /h/codes/a8-agent
2. 指令模式
执行内置指令，这些指令可以更好的获取Claude Code相关信息或进行一些配置：
- 触发：输入 / 进入指令模式。
- 快捷键：
Alt + M：自动接受代码编辑。-
Alt + V：粘贴图片（支持图像输入）。 -
示例：
/config
3. 引用文件
引用项目中的文件，更具针对性的对话或者描述需求：
- 触发：使用 @ 指定文件路径。
- 快捷键：
- Ctrl + R：启用详细输出。
- 示例：
@my-project/main.py
4. 记忆指令
管理待办事项和记忆：
- 触发：使用 # 标记待记忆项（如待办事项）。
- 快捷键：
Ctrl + T：显示待办列表。-
\ + ⏎：插入换行符，支持多行输入。 -
示例：
# Fix MCP connection issue
\
Check API key
- 按
Ctrl + T查看待办。
常见问题与故障排除
- MCP 连接失败：
- 检查密钥：
curl -v -H "Authorization: Bearer sk-***" <MCP_URL>。 -
重置权限：
/permissions或claude mcp reset-project-choices。 -
选项未知：
- 确认版本：
claude --version。 -
更新：
claude update或npm install -g @anthropic-ai/claude-code@latest。 -
上下文溢出：
-
使用
/clear或/compact释放上下文。 -
参考文档：https://docs.anthropic.com/en/docs/claude-code/overview。
2025-09-10 于北京用友产业园