Claude Code 简明使用指南

Claude Code 简明使用指南Claude Code 是 Anthropic 公司开发的 AI 编程助手 基于 Claude 大语言模型 专为优化软件开发工作流程设计 作为一个面向编程的智能 Agent 它可以调用各种工具来扩展功能 帮助处理复杂的开发任务 与传统的 AI IDE 模式不同 Claude Code 采用 命令行界面 CLI 用户只需提出需求 建议或代码改写 修复和重构要求 Claude Code

大家好,我是讯享网,很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



Claude Code 是 Anthropic 公司开发的 AI 编程助手,基于 Claude 大语言模型,专为优化软件开发工作流程设计。作为一个面向编程的智能 Agent,它可以调用各种工具来扩展功能,帮助处理复杂的开发任务。与传统的 AI IDE 模式不同,Claude Code 采用 命令行界面(CLI),用户只需提出需求、建议或代码改写、修复和重构要求,Claude Code 在后端自动完成任务,减少手动编码负担。

image-20250910132922674

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 Code 旨在成为开发者的智能编程伙伴,通过深入理解代码上下文和团队规范,提供精准、高效的编程协助。

 
  

通过 npm 全局安装 Claude Code:

 
  

如果已经安装了 ,再次执行该命令会安装最新版本(升级)

Claude Code 不仅仅可以对接 Anthropic 的模型,还可以对接其他模型(如 GLM、DeepSeek、KIMI 等),形成一个中立的工具。通过自定义 API 端点和模型配置,可以更好地利用其 Agent 能力,支持多提供商集成,实现更灵活的 AI 驱动开发。

Claude Code 支持通过环境变量配置 API 端点、认证和模型选择,以适应不同服务提供商或自定义需求。

  • ANTHROPIC_BASE_URL:指定 Anthropic API 的基础 URL,用于覆盖默认端点(如 ),适用于自定义服务器或代理。
  • ANTHROPIC_AUTH_TOKEN:提供 API 认证令牌(API Key),用于验证请求权限。
  • ANTHROPIC_MODEL:指定默认使用的 Claude 模型(如 、)。
  • ANTHROPIC_SMALL_FAST_MODEL:指定快速或轻量任务的备用模型,优化速度和成本。

适用于使用 GLM-4.5 模型的场景:

 
  

适用于 DeepSeek API 的配置:

 
  

适用于 Moonshot KIMI2 模型的配置:

 
  

各个模型的API Key可以到各模型提供商的开发平台网站获取

Claude Code 使用以下目录和文件存储配置和缓存:

  • ~/.claude/:缓存文件夹,包含以下子目录:
  • :存储项目相关信息。
  • :存储待办事项。
  • :存储扩展插件。
  • ~/.claude.json:主配置文件,存储全局设置(如 MCP 服务器、工具权限)。

以下是 Claude Code CLI 的常用子命令和配置选项,用于管理设置和功能。

管理 Claude Code 的配置项,如工具权限、主题等。

  • 获取全部配置: 查看当前配置:
 
  
  • 显示所有配置项,例如工具权限()和信任对话框状态()。
  • 更改设置: 修改特定配置项:
 
  
  • 将信任对话框状态设为已接受,允许工具调用。
  • config 子命令: 查看帮助:
 
  
  • get [options] :获取指定配置项的值。
  • set [options] :设置配置项的值。
  • remove|rm [options] [values...] :移除配置项或数组中的值。
  • list|ls [options]:列出所有配置项。
  • add [options] :向配置数组添加值(支持空格或逗号分隔)。

管理 Model Context Protocol(MCP)服务器,用于扩展 Claude Code 功能(如文件系统访问、Web 搜索)。

  1. 增加 SSE 的 MCP 服务: 添加基于 Server-Sent Events(SSE)的 MCP 服务器:
 
  
  • 配置存储在 中,指定服务器 URL 和认证头。
  • 增加 STDIO 的 MCP 服务: 添加基于标准输入输出的 MCP 服务器(如文件系统访问):
 
  
  • 指定用户级作用域,允许访问 和 。
  • 清理默认选择项: 重置项目级 MCP 批准状态,清除之前的拒绝记录:
 
  

Claude Code 作为 CLI 工具,提供了类 Unix 工具能力,可以作为 CI/CD pipeline 的一个环节,完整保留了所有 Agent 的能力。

如下例,利用内置工具列举出当前路径的文件:

 
  

或者直接分析运行日志,排查错误:

 
  

利用 管道符,可以串联执行和输出:

 
  

Claude Code CLI 也能通过 IDE 的 Claude Code 插件配合,在 Claude Code CLI 中直接对 IDE 当前活动代码进行修改,如下:

VSCode 连接示例

 
  

当前 VSCode 当前代码是 QueryModel.tsx,如果切换到其他代码,Claude Code CLI 也会切换到对应的代码上下文

Cursor 连接示例

 
  

当前 Cursor 当前代码是 ConditionController.java,如果切换到其他代码,Claude Code CLI 也会切换到对应的代码上下文

检查 Claude Code 的安装、配置和网络状态:

 
  
  • 输出包括版本、安装路径、自动更新状态等,帮助排查问题。

检查并安装最新版本:

 
  
  • 确保使用最新功能和修复已知 bug。

在 Claude Code REPL 环境中使用以 开头的指令管理会话和功能。

显示当前上下文使用情况,以彩色网格形式可视化:

 
  
  • 显示模型、已用标记数(tokens)和剩余空间,帮助管理上下文限制。

管理代理配置,定义特定任务的行为:

 
  
  • 创建代理后,Claude Code 根据用户输入自动调用相应代理:
 
  

生成的 默认以 格式保存在 ,也可以自行在 Claude Code之外参考其格式增加新的 ,网络上也有一些提供 的模板网站:https://www.aitmpl.com/

打开配置面板,管理偏好设置:

 
  
  • 配置主题、通知、输出样式等,提升用户体验。

显示当前会话的成本和持续时间:

 
  
  • 跟踪 API 使用情况,便于订阅用户关注用量和费用情况。

显示当前会话状态,包括版本、工作目录和配置:

 
  
  • 提供运行环境和配置概览。

将当前会话内容复制到剪贴板或者文件:

 
  

压缩对话历史,保留总结以节省上下文:

 
  
  • 支持 查看完整总结。

清除对话历史并重置上下文:

 
  
  • 释放上下文标记,开始全新会话,在回话上下文超出的时候,或者进入全新主题的场景使用。

管理项目和用户级记忆文件:

  • 项目记忆:,存储项目特定上下文。
  • 用户记忆:,存储用户级上下文。
  • 递归读取:从当前目录向上查找 或 ,子目录中的文件在访问时加载。
  • 用法
 
  
  • 使用 快捷方式快速添加记忆,系统提示选择存储位置。

选择或切换 Claude Code 使用的模型:

 
  
  • 支持动态切换模型,适用于不同任务需求。

管理工具和服务器权限:

 
  
  • 控制工具访问权限(如 MCP、Web 搜索),确保安全性和合规性。

Claude Code REPL 支持多种输入模式,便于不同任务。

执行 shell 命令:

  • 触发:输入 进入 bash 模式。
  • 快捷键
  • 双击 :清除输入。
  • :撤销操作。
  • 示例
 
  

执行内置指令,这些指令可以更好的获取Claude Code相关信息或进行一些配置:

  • 触发:输入 进入指令模式。

  • 快捷键
  • :自动接受代码编辑。
  • :粘贴图片(支持图像输入)。
  • 示例
 
  

引用项目中的文件,更具针对性的对话或者描述需求:

  • 触发:使用 指定文件路径。
  • 快捷键
    • :启用详细输出。
  • 示例

 
  

管理待办事项和记忆:

  • 触发:使用 标记待记忆项(如待办事项)。

  • 快捷键
  • :显示待办列表。
  • :插入换行符,支持多行输入。
  • 示例
 
  
  • 按 查看待办。

  • MCP 连接失败
  • 检查密钥:。
  • 重置权限: 或 。
  • 选项未知
  • 确认版本:。
  • 更新: 或 。
  • 上下文溢出
  • 使用 或 释放上下文。
  • 参考文档:https://docs.anthropic.com/en/docs/claude-code/overview。

2025-09-10 于北京用友产业园

小讯
上一篇 2026-04-03 11:35
下一篇 2026-04-03 11:33

相关推荐

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/225139.html