Claude Code 深度操作指南从零到专家把这个 AI 编程助手真正用起来写在前面你可能已经知道 Claude Code 怎么用但它比你想象的更强大。这篇会把 Claude Code 的两种交互方式、IDE 集成、模型切换、上下文压缩、撤销恢复、图像理解、深度思考、命令历史管理、CLAUDE.md 记忆、SDK 与 MCP、Git Worktree 并行、GitHub Actions 自动化、以及常见故障排查全部串一遍——读完你应该能把它至少多用出 5 倍。两种主要的交互方式Claude Code 提供两种主要的交互方式交互模式运行claude启动 REPL 会话单次模式使用claude -p 查询进行快速命令可以参考# 启动交互模式claude# 以初始查询启动claude解释这个项目# 运行单个命令并退出claude-p这个函数做什么# 处理管道内容catlogs.txt|claude-p分析这些错误对于 Claude Code Client 的常用参数和功能可以访问官方文档CLI 使用和控制 - Anthropic。IDE 集成直接在编辑器里看到改动Claude Code 现在支持VSCode与JetBrains可以直接在 IDE 中看到 Claude Code 的改动并在 IDE 中与其交互。Linux / macOS 用户VSCode在 VSCode 的内置终端唤起 Claude Code插件将被自动安装JetBrains需要通过 JetBrains 应用市场下载Claude Code [Beta]插件可能需要手动指定 IDE 或检查 IDE 连接通过以下命令测试/ideVSCode WSL 用户请提前在 VSCode 插件商店安装WSL 插件。更多的用法可以参考 Claude Code 的官方文档IDE integrations - Anthropic。模型切换Sonnet vs OpusClaude Code 支持Claude Opus 4.8与Claude Sonnet 4.6灵活切换模型体验计费倍率推荐场景Claude Sonnet 4.6与 Opus 没有明显差别1x默认日常开发、绝大多数任务Claude Opus 4.8最强推理5x复杂调试、深度规划、长线任务强烈推荐使用 Claude Sonnet 4.6——使用体验与 Claude Opus 4.8 没有明显差别但计费倍率仅为 Opus 的 1/5。在 Claude Code 中使用此命令切换模型/model上下文压缩节省 tokenClaude Code 通常会有长上下文建议使用以下斜杠命令来压缩以节省点数。较长的上下文往往需要更多点数。/compact[您的描述]恢复上一步修改Claude Code 支持使用CtrlZ或在Vim 模式下使用u撤销 Claude Code 的上一步修改。恢复以前的对话使用以下命令可以恢复上次的对话claude--continue这会立即恢复最近的对话无需任何提示。如果需要在多个历史对话中选择可以输入此命令claude--resume这会显示一个交互式对话选择器显示对话开始时间初始提示或对话摘要消息数量使用箭头键导航并按 Enter 选择对话可以用这个方法选择上下文。图像信息处理Claude Code 可以处理图像信息可以使用以下任何方法将图像拖放到 Claude Code 窗口中在 macOS 上复制图像并使用Ctrlv粘贴到 CLI 中在 macOS 上提供图像路径分析这个图像/path/to/your/image.png可以完全使用自然语言要求它进行工作如“这是错误的截图。是什么导致了它”“这个图像显示了什么”“描述这个截图中的 UI 元素。”“生成 CSS 以匹配这个设计模型。”“什么 HTML 结构可以重新创建这个组件”深入思考Deep Thinking需要通过自然语言要求它进行深入思考“我需要使用 OAuth2 为我们的 API 实现一个新的身份验证系统。深入思考在我们的代码库中实现这一点的最佳方法。”“思考这种方法中潜在的安全漏洞。”“更深入地思考我们应该处理的边缘情况。”⚠️ 推荐在使用复杂问题的时候使用这一功能这也会消耗大量的额度点数。命令历史管理历史按工作目录存储使用/clear命令清除使用上 / 下箭头导航CtrlR反向搜索历史如果终端支持注意历史扩展!默认禁用CLAUDE.md存储项目记忆可以使用以下命令设置一个 CLAUDE.md 文件来存储重要的项目信息、约定和常用命令/initCLAUDE.md 里建议放这些内容常用命令构建、测试、lint以避免重复搜索代码风格偏好和命名约定特定于项目的重要架构模式CLAUDE.md 记忆可用于与团队共享的指令和个人偏好。更多关于记忆的设置可以访问此官方文档了解Claude Code 概述 - Anthropic。常用用法参考管理 Claude 的记忆 - Anthropic。SDK 与 MCPClaude Code Python SDKClaude Code 支持 Python SDK请参考官方文档Claude Code SDK - Anthropic。直接访问 Python SDK GitHub 仓库GitHub - anthropics/claude-code-sdk-python。MCP 模型上下文协议模型上下文协议MCP是一个开放协议使 LLM 能够访问外部工具和数据源。这是高级功能可以访问此文档获取更多配置信息Introduction - Model Context Protocol。Claude Code不仅支持接入 MCP同样支持作为 MCP 服务器等各类高级功能可以访问此文档获得更多信息教程 - Anthropic。Git 中的高级用法自然语言操作 GitClaude Code 支持使用自然语言操作 Git如“提交我的更改”“创建一个 PR”“哪个提交在去年十二月添加了 markdown 测试”“在 main 分支上变基并解决任何合并冲突”Git Worktree并行隔离的编码环境如果需要同时处理多个任务并在 Claude Code 实例之间完全隔离代码可以使用Git Worktree功能。Git 工作树允许从同一存储库中检出多个分支到单独的目录。每个工作树都有自己的工作目录文件是隔离的同时共享相同的 Git 历史。创建新工作树# 创建带有新分支的工作树gitworktreeadd../project-feature-a-bfeature-a# 或使用现有分支创建工作树gitworktreeadd../project-bugfix bugfix-123这会创建一个包含存储库单独工作副本的新目录。在每个工作树中运行 Claude Code# 导航到您的工作树cd../project-feature-a# 在这个隔离环境中运行 Claude Codeclaude在另一个终端中cd../project-bugfix claude管理工作树# 列出所有工作树gitworktree list# 完成后移除工作树gitworktree remove../project-feature-aWorktree Claude Code 的优势每个工作树都有自己独立的文件状态非常适合并行 Claude Code 会话在一个工作树中所做的更改不会影响其他工作树防止 Claude 实例相互干扰所有工作树共享相同的 Git 历史和远程连接对于长时间运行的任务可以让 Claude 在一个工作树中工作同时你在另一个工作树中继续开发使用描述性目录名称以便轻松识别每个工作树的任务Worktree 环境初始化记得根据项目的设置在每个新工作树中初始化开发环境。根据技术栈这可能包括JavaScript 项目运行依赖安装npm install、yarnPython 项目设置虚拟环境或使用包管理器安装其他语言遵循项目的标准设置流程GitHub Actionsclaude 触发自动化此功能仍是Beta 版本可访问此链接获取使用GitHub - anthropics/claude-code-actionClaude Code GitHub Actions - Anthropic这是一个适用于GitHub PR 和 issues 的通用 Claude Code 动作可以回答问题并实现代码更改。此动作会在评论中监听触发词并根据请求激活 Claude 动作。Claude Code GitHub Actions 为 GitHub 工作流程带来 AI 驱动的自动化。只需在任何 PR 或 issue 中简单地提及 claudeClaude 就可以分析代码、创建拉取请求、实现功能和修复错误——所有这些都遵循项目的标准。——Anthropic通过以下命令部署 Claude Code GitHub App此命令将引导你完成设置 GitHub 应用和所需的密钥/install-github-app安装成功后可用命令如claude 根据 issue 描述实现此功能claude 我应该如何为此端点实现用户身份验证其他自然语言功能识别未文档化的代码“在 auth 模块中查找没有适当 JSDoc 注释的函数”生成文档“为 auth.js 中未文档化的函数添加 JSDoc 注释”理解陌生代码“支付处理系统做什么”“查找用户权限在哪里被检查”“解释缓存层是如何工作的”智能编辑代码“为注册表单添加输入验证”“重构日志记录器以使用新的 API”“修复工作队列中的竞态条件”测试或编辑代码“运行 auth 模块的测试并修复失败”“查找并修复安全漏洞”“解释为什么这个测试失败了”常用斜杠命令、CLI 命令、参数与快捷键参考交互模式 - Anthropic。其他高级功能类 Unix 工具Claude Code 可以被用作类 Unix 工具——教程 - Anthropic自定义斜杠指令教程 - Anthropic$ARGUMENTS添加命令参数教程 - Anthropic高级设置可以参考此文档——Claude Code 设置 - Anthropic安全设置请参考此官方文档——管理权限和安全 - Anthropic常见问题排查QClaude Code 如何存储记忆AClaude Code 将记忆存储在~/.claude中如果没有特殊要求请不要删除此目录。QClaude Code 偶尔回复错误的模型名称这是为什么A这是因为 Claude Code 在使用简单任务时不会使用 Claude 4 系列模型。可以了解Bedrock、Vertex 和代理 - Anthropic。QClaude Code 执行的命令行参数错误A此类问题在WSL上常见是 Agent 自身的错误。推荐使用macOS / Ubuntu这类环境往往问题较少。QClaude Code 如何彻底清理A可以执行以下命令清理 Claude Code 的登录信息rm~/.claude*-rfQClaude Code 出现 API Error / Tools ErrorA这通常是网络问题请退出后使用claude -c重新执行。如果问题依然存在请联系售后支持。QClaude Code 在登录使用 OAuth 时验证错误A请确保环境变量中没有配置任何代理再进行登录验证。如果问题仍然存在请无视弹出的浏览器并复制终端中的链接并打开通过验证码方式验证。QClaude Code 长时间没有响应A建议按下CtrlC并重启 Claude Code这往往是网络问题。如果命令行仍然无响应建议杀死进程并重新进行会话这将不会影响工作进度。可以通过以下命令恢复上次的会话claude-c若问题仍然出现请寻求售后支持。写在最后把上面这些功能串起来看Claude Code 真正的能力远不止在终端里写代码——Worktree 并行 多 IDE 集成 claude GitHub Actions 自定义 Skills MCP组合起来基本就是把一个 AI 工程师塞进了你的开发流程里。对国内开发者来说最大的卡点反而不是怎么用而是怎么稳定连上 Claude Opus 4.8 这种旗舰模型——官方订阅需要海外信用卡、海外网络、还有时不时被封号的风险。如果想直接跳过这些麻烦可以看看 Code80真实订阅账号转 API换个 endpoint 就能在 Claude Code 里直接跑 Opus 4.8、Sonnet 4.6体验跟官方完全一致。详情可以到官网了解code.ai80.vip。常见问题FAQQ1交互模式和单次模式怎么选A长任务、要反复迭代用交互模式claude启动 REPL一次性问答、脚本调用、管道处理用单次模式claude -p ...。比如cat logs.txt | claude -p 分析这些错误这种就是单次模式的典型用法。Q2模型默认是 Sonnet要不要切到 OpusA绝大多数情况下不用切——Sonnet 4.6 体验和 Opus 4.8 没有明显差别但点数只用 1/5。只在复杂调试、深度规划、安全审查、长线研究这类真正吃推理的任务上切到 Opus。/model命令随时可以换。Q3上下文太长导致点数烧得快怎么办A用/compact [描述]压缩上下文。这个命令会让 Claude 把当前会话的关键信息总结成精简版然后基于压缩后的上下文继续能显著降低 token 消耗。长会话建议每跑一段就 compact 一次。Q4Git Worktree Claude Code 到底有什么用A可以同时跑多个 Claude Code 实例处理不同任务彼此互不干扰。比如一个工作树里让 Claude 跑长时间重构另一个工作树里你自己继续开发新功能。每个工作树文件状态独立共享同一份 Git 历史。适合一边让 AI 干活、一边自己也在写的并行场景。Q5CLAUDE.md 和/init是什么关系A/init是一键生成 CLAUDE.md的命令——它会扫描你的项目自动生成一份初始的 CLAUDE.md。生成之后你可以再手动补充常用命令build/test/lint、代码风格、架构模式。CLAUDE.md 每次会话开始时 Claude 都会自动读相当于给它的项目入门文档。Q6怎么用 claude 在 GitHub PR 里触发 Claude CodeA先在仓库里跑/install-github-app配置 GitHub App 和密钥。装好之后在任何 PR 或 Issue 评论里claude 帮我实现这个功能就能触发。它会分析代码、创建 PR、实现功能或修复 bug按项目规范走。这是个 Beta 功能。Q7Claude Code 总是 API Error 或长时间无响应A大概率是网络问题。先CtrlC中断用claude -c恢复上次会话。如果还不行就杀进程重启——不会丢工作进度下次还能claude -c续上。OAuth 登录失败的话确保环境变量里没配代理或者直接复制终端里的链接手动打开做验证。Q8国内开发者怎么稳定用上 Claude Opus 4.8A官方 Claude 订阅需要海外信用卡 海外稳定网络环境且有封号风险。可以走 Code80 这种真实订阅账号转 API 的渠道——按拿到的 Base URL 和 Key 配进 Claude Code 或 CC Switch 就能直接跑 Opus 4.8体验跟官方一致。