Claude Code深度操作指南：从零到专家的AI编程助手实战

发布于：2025-08-05 ⋅ 阅读:(14) ⋅ 点赞:(0)

Claude Code 直接进行交互：

您可了解 Claude Code 常见的工作流，但Claude Code 比您想象的更强大。

Claude Code 提供两种主要的交互方式：

  • 交互模式：运行 claude 启动 REPL 会话
  • 单次模式：使用 claude -p "查询" 进行快速命令

您可以参考：

# 启动交互模式
claude

# 以初始查询启动
claude "解释这个项目"

# 运行单个命令并退出
claude -p "这个函数做什么？"

# 处理管道内容
cat logs.txt | claude -p "分析这些错误"

 对于 Claude Code Client的常用参数和功能，您可以访问官方文档：CLI 使用和控制 - Anthropic

Claude Code 支持连接到主流IDE：

您可以直接在IDE中看到Claude Code的改动，在IDE中与其交互。

Claude Code 现在支持 VSCode 与 JetBrains

如果您使用Linux / MacOS，您可以直接使用该插件

  • 如果您使用VSCode，在VSCode的内置终端唤起Claude Code，插件将被自动安装
  • 如果您使用JetBrains，您需要通过此链接下载：Claude Code [Beta] - IntelliJ IDEs Plugin | Marketplace

 您可能需要手动指定IDE或检查DIE连接，通过以下命令测试：

> /ide

如果您使用 VSCode+WSL，请您提前在VSCode 插件商店安装 WSL 插件

对于更多的用法，您可以参考Claude Code的官方文档：IDE integrations - Anthropic

Claude Code 支持 Claude 4 Opus 与 Claude 4 Sonnet 灵活切换：

我们强烈推荐您使用Claude 4 Sonnet，其使用体验与Claude 4 Opus没有明显差别，但计费倍率仅为opus的1/5。我们为您默认选择了Claude 4 Sonnet，您可以在登录后在配置中修改这一选项。

  • 如果您没有在站点中关闭"强制使用 Sonnet"，您在/model中切换的模型不会被切换。

在 Claude Code 中使用此命令切换模型：

> /model

Claude Code 支持压缩上下文以节省点数：

Claude Code 通常会有长上下文，我们建议您使用以下斜杠命令来压缩以节省点数，较长的上下文往往需要更多点数。

/compact [您的描述]

 

Claude Code 支持恢复上一步修改：

Claude Code 支持使用 Ctrl+Z 或在Vim模式下使用 u 撤销 Claude Code 的上一步修改。

Claude Code 能够恢复以前的对话：

使用以下命令可以恢复您上次的对话

claude --continue

 这会立即恢复您最近的对话，无需任何提示。

您如果需要显示时间，可以输入此命令

claude --resume

这会显示一个交互式对话选择器，显示：

  • 对话开始时间
  • 初始提示或对话摘要
  • 消息数量

使用箭头键导航并按Enter选择对话，您可以使用这个方法选择上下文。

Claude Code 可以处理图像信息：

您可以使用以下任何方法：

  • 将图像拖放到Claude Code窗口中（在MacOS上）
  • 复制图像并使用Ctrl+v粘贴到CLI中（在MacOS上）
  • 提供图像路径

> 分析这个图像：/path/to/your/image.png

 您可以完全使用自然语言要求他进行工作，如：

> 这是错误的截图。是什么导致了它？ 
> 这个图像显示了什么？ 
> 描述这个截图中的UI元素 
> 生成CSS以匹配这个设计模型 
> 什么HTML结构可以重新创建这个组件？

Claude Code 支持深入思考：

您需要通过自然语言要求其进行深入思考

> 我需要使用OAuth2为我们的API实现一个新的身份验证系统。深入思考在我们的代码库中实现这一点的最佳方法。
> 思考这种方法中潜在的安全漏洞 
> 更深入地思考我们应该处理的边缘情况

推荐您在使用复杂问题的时候使用这一功能，这也会消耗大量的额度点数。

Claude Code 支持管理命令历史：

  • 历史按工作目录存储
  • 使用 /clear 命令清除
  • 使用上/下箭头导航（参见上面的键盘快捷键）
  • Ctrl+R：反向搜索历史（如果终端支持）
  • 注意：历史扩展（!）默认禁用

Claude Code 通过 Claude.md 存储重要记忆：

您可以使用以下命令设置一个CLAUDE.md文件来存储重要的项目信息、约定和常用命令。

> /init

  • 包括常用命令（构建、测试、lint）以避免重复搜索
  • 记录代码风格偏好和命名约定
  • 添加特定于您项目的重要架构模式
  • CLAUDE.md记忆可用于与团队共享的指令和您的个人偏好。
  • 更多关于记忆的设置，您可以访问此官方文档了解：Claude Code 概述 - Anthropic
  • 在官方文档中，此部分记录了记忆的常用用法：管理Claude的记忆 - Anthropic

Claude Code 拥有SDK：

  • Claude Code 支持Python SDK，请参考官方文档：Claude Code SDK - Anthropic
  • 直接访问 Python SDK Github 仓库：GitHub - anthropics/claude-code-sdk-python

Claude Code 支持上下文通用协议（MCP）：

  • 模型上下文协议(MCP)是一个开放协议，使LLM能够访问外部工具和数据源。
  • 这是高级功能，您可以访问此文档获取更多配置信息：Introduction - Model Context Protocol
  • Claude Code不仅支持接入MCP，同样支持作为MCP服务器等各类高级功能，您可以访问此文档获得更多信息：教程 - Anthropic 

 Claude Code 在 Git 中的高级设置：

Claude Code 支持使用自然语言操作Git，如：

> 提交我的更改
> 创建一个 pr
> 哪个提交在去年十二月添加了 markdown 测试？
> 在 main 分支上变基并解决任何合并冲突

 您可以使用工作树创建隔离的编码环境。

如果您您需要同时处理多个任务，并在Claude Code实例之间完全隔离代码，您可以使用此功能：

  • Git工作树允许您从同一存储库中检出多个分支到单独的目录。每个工作树都有自己的工作目录，文件是隔离的，同时共享相同的Git历史。在git-worktree中了解更多。
  • 创建新工作树
# 创建带有新分支的工作树 
git worktree add ../project-feature-a -b feature-a

# 或使用现有分支创建工作树
git worktree add ../project-bugfix bugfix-123

这会创建一个包含存储库单独工作副本的新目录。

在每个工作树中运行Claude Code

# 导航到您的工作树 
cd ../project-feature-a

# 在这个隔离环境中运行Claude Code
claude

 在另一个终端中：

cd ../project-bugfix
claude

管理您的工作树 

# 列出所有工作树
git worktree list

# 完成后移除工作树
git worktree remove ../project-feature-a

每个工作树都有自己独立的文件状态，非常适合并行Claude Code会话

在一个工作树中所做的更改不会影响其他工作树，防止Claude实例相互干扰

所有工作树共享相同的Git历史和远程连接

对于长时间运行的任务，您可以让Claude在一个工作树中工作，同时您在另一个工作树中继续开发

使用描述性目录名称，以便轻松识别每个工作树的任务

记得根据项目的设置在每个新工作树中初始化开发环境。根据您的技术栈，这可能包括：

  • JavaScript项目：运行依赖安装（npm install、yarn）
  • Python项目：设置虚拟环境或使用包管理器安装
  • 其他语言：遵循项目的标准设置流程

Claude Code 支持 Github Actions：

此功能仍是Beta版本，您可访问此链接获取使用

  • GitHub - anthropics/claude-code-action
  • Claude Code GitHub Actions - Anthropic

这是一个适用于 GitHub PR 和 issues 的通用 Claude Code 动作，可以回答问题并实现代码更改。此动作会在评论中监听触发词并根据请求激活 Claude 动作。

  • Claude Code GitHub Actions 为您的 GitHub 工作流程带来 AI 驱动的自动化。只需在任何 PR 或 issue 中简单地提及 @claude，Claude 就可以分析您的代码、创建拉取请求、实现功能和修复错误 - 所有这些都遵循您项目的标准。--Anthropic

通过以下命令部署 Claude Code Github App，此命令将引导您完成设置 GitHub 应用和所需的密钥：

> /install-github-app

安装成功后，您可用@命令，如： 

> @claude 根据 issue 描述实现此功能
> @claude 我应该如何为此端点实现用户身份验证？

Claude Code 其他的自然语言功能：

识别未文档化的代码

> 在auth模块中查找没有适当JSDoc注释的函数

生成文档

> 为auth.js中未文档化的函数添加JSDoc注释

理解陌生代码

> 支付处理系统做什么？
> 查找用户权限在哪里被检查
> 解释缓存层是如何工作的

智能编辑代码

> 为注册表单添加输入验证
> 重构日志记录器以使用新的 API
> 修复工作队列中的竞态条件

测试或编辑您的代码 

> 运行 auth 模块的测试并修复失败
> 查找并修复安全漏洞
> 解释为什么这个测试失败了

 Claude Code 常见的斜杠命令：

 

命令

用途

/bug

报告错误（将对话发送给 Anthropic）

/clear

清除对话历史

/compact [instructions]

压缩对话，可选择焦点说明

/config

查看/修改配置

/cost

显示令牌使用统计

/doctor

检查 Claude Code 安装的健康状况

/help

获取使用帮助

/init

使用 CLAUDE.md 指南初始化项目

/login

切换 Anthropic 账户

/logout

从 Anthropic 账户登出

/memory

编辑 CLAUDE.md 记忆文件

/pr_comments

查看拉取请求评论

/review

请求代码审查

/status

查看账户和系统状态

/terminal-setup

安装 Shift+Enter 换行键绑定（仅限 iTerm2 和 VSCode）

/vim

进入 vim 模式以切换插入和命令模式

 
Claude Code 常见的 CLI 命令：

 

命令

描述

示例

claude

启动交互式 REPL

claude

claude "query"

使用初始提示启动 REPL

claude "explain this project"

claude -p "query"

通过 SDK 查询，然后退出

claude -p "explain this function"

cat file | claude -p "query"

处理管道内容

cat logs.txt | claude -p "explain"

claude -c

继续最近的对话

claude -c

claude -c -p "query"

通过 SDK 继续

claude -c -p "Check for type errors"

claude -r "<session-id>" "query"

通过 ID 恢复会话

claude -r "abc123" "Finish this PR"

claude mcp

配置模型上下文协议 (MCP) 服务器

请参阅 Claude Code MCP 文档。

 
Claude Code 常见的 CLI 参数：

 

标志

描述

示例

--print, -p

在非交互模式下运行

claude -p "query"

--output-format

指定输出格式（text、json、stream-json）

claude -p --output-format json

--resume, -r

通过会话 ID 恢复对话

claude --resume abc123

--continue, -c

继续最近的对话

claude --continue

--verbose

启用详细日志记录

claude --verbose

--max-turns

在非交互模式下限制代理轮次

claude --max-turns 3

--system-prompt

覆盖系统提示（仅适用于 --print）

claude --system-prompt "Custom instruction"

--append-system-prompt

附加到系统提示（仅适用于 --print）

claude --append-system-prompt "Custom instruction"

--allowedTools

允许的工具的空格分隔列表，或允许的工具的逗号分隔列表字符串

claude --allowedTools mcp__slack mcp__filesystem,claude --allowedTools "Bash(npm install),mcp__filesystem"

--disallowedTools

拒绝的工具的空格分隔列表，或拒绝的工具的逗号分隔列表字符串

claude --disallowedTools mcp__splunk mcp__github,claude --disallowedTools "Bash(git commit),mcp__github"

--mcp-config

从 JSON 文件加载 MCP 服务器

claude --mcp-config servers.json

--permission-prompt-tool

用于处理权限提示的 MCP 工具（仅适用于 --print）

claude --permission-prompt-tool mcp__auth__prompt

--logout

退出登录



--pick-relay

选择节点



 

Claude Code 常用的快捷键：

通用控制：

快捷键

描述

上下文

Ctrl+C

取消当前输入或生成

标准中断

Ctrl+D

退出 Claude Code 会话

EOF 信号

Ctrl+L

清除终端屏幕

保留对话历史

上/下箭头

导航命令历史

回调之前的输入

Esc + Esc

编辑上一条消息

双击 Escape 键修改

多行输入：

方法

快捷键

上下文

快速转义

\ + Enter

在所有终端中工作

macOS 默认

Option+Enter

macOS 上的默认设置

终端设置

Shift+Enter

在 /terminal-setup 之后

粘贴模式

直接粘贴

用于代码块、日志

快速命令：

快捷键

描述

注释

开头的 #

内存快捷键 - 添加到 CLAUDE.md

提示文件选择

开头的 /

斜杠命令

参见 斜杠命令

Vim 模式：

  • 参考：交互模式 - Anthropic 

 Claude Code 其他的高级功能：

  • Claude Code可以被用作Claude用作类Unix工具：教程 - Anthropic
  • Claude Code支持自定义斜杠指令：教程 - Anthropic
  • Claude Code支持使用$ARGUMENTS添加命令参数：教程 - Anthropic
  • Claude Code支持高级设置，您可以参考此文档：Claude Code 设置 - Anthropic
  • Claude Code的安全设置，请参考此官方文档：管理权限和安全 - Anthropic

Claude Code 如何存储记忆？

Claude Code 将记忆存储在~/.claude中，如果没有特殊要求，请不要删除此目录。

Claude Code 偶尔回复错误的模型名称，这是为什么？

IMAYI 向您承诺不会替换您请求的模型，绝不掺杂其他模型。

这由于Claude Code在使用简单任务时，不会使用Claude 4 系列模型。您可了解：Bedrock, Vertex 和代理 - Anthropic

Claude Code 执行的命令行参数错误？

此类问题在WSL上常见，是Agent自身的错误。我们推荐您使用MacOS/Ubuntu，这类环境往往问题较少。

Claude Code 如何彻底清理，或曾经的使用Claude Code官方版本的环境在连接到代理站时出错？

您可以执行以下命令清理Claude Code的登录信息

rm ~/.claude* -rf

     Claude Code 出现 API Error，Tools Error？

    这通常是网络问题，请您退出后使用claude -c重新执行。如果问题依然存在，请联系售后支持。

    Claude Code 在登录使用OAuth时验证错误？

    请您确保环境变量中没有配置任何代理再进行登录验证。

    如果问题仍然存在，请您无视弹出的浏览器并复制终端中的链接并打开，通过验证码方式验证。

    Claude Code 长时间没有响应？

    我们建议您按下ctrl+c并重启Claude Code，这往往是网络问题。

    如果命令行仍然无响应，我们建议您杀死进程并重新进行会话，这将不会影响您的工作进度。

    您可以通过以下命令恢复上次的会话

    claude -c

    若问题仍然出现，请寻求售后支持。

    更多AI大模型信息，请关注PoloAPI.com，无论是技术小白还是技术大咖，都能够在这里找到你所要的AI大模型

     

    网站公告

    今日签到

    点亮在社区的每一天
    去签到

    热门文章

    最新发布