Agent Skills
返回列表
Claude Code 完全指南

Claude Code 完全指南

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_2c46b95e/claude-code-guide。

技能介绍

你在解决什么问题

在国内用 Claude Code 时,常见卡点不只是「装不上」:claude 找不到、直连 Anthropic 不稳定、交互里一堆斜杠命令不知道干什么、改代码越界又不好回滚。项目里如果没有 CLAUDE.md,每次会话都像从零开始讲技术栈和规范。这份指南按「能跑起来 → 能日常用 → 能控风险」组织,把安装验证、CC Switch + DeepSeek 接入、基础命令与快捷键、项目配置和权限写在一起,方便对照排查。

技能如何帮你落地

国内链路:说明用 CC Switch 把请求转到 DeepSeek API(含 Provider 字段表与价格参考),以及首次 OAuth 登录时 CC Switch 如何拦截转发,避免误以为必须订阅 Anthropic 才能继续。

日常操作:覆盖启动模式(交互、单次任务、-p 打印、-c/-r 续聊)、交互斜杠命令(如 /compact、/model、/init、/review、/doctor)和常用快捷键。

项目质量:强调 CLAUDE.md 的项目级与用户级路径,以及用 /init 生成初始配置;并给出代码生成、Bug 修复、Git 操作三类核心工作流骨架。

进阶与治理:.mcp.json、Hooks(permission_prompt / idle_prompt)、.claude/commands/ 自定义命令、.claude/agents/ 子代理、Plan Mode、Git worktrees 并行会话,以及在 .claude/settings.json 里预配权限与审批选项(y/n/a/d)。

边界与注意点

指南是操作手册与配置说明,不包含替你执行环境变更;DeepSeek 定价与 API 以平台当前页面为准。CC Switch 或 MCP 改完后通常需要完全退出并重启 Claude Code;/model 看不到目标模型时,应核对 CC Switch 的模型槽位而非只改 Prompt。响应变慢可先 /compact 或 /clear;改动超预期用 git reset 并收窄任务描述——文档里的 Prompt 三规则(目标、边界、验收)正是为此设计的。

使用场景

  • 在国内开发环境首次启用 Claude Code,需用 CC Switch 配置 DeepSeek Provider 并通过「测试连接」写入 `~/.claude/settings.json`。
  • 接手新仓库第一周,用交互模式执行 `/init` 生成项目级 CLAUDE.md,把技术栈与可改文件边界写清楚再让 Claude 改代码。
  • 同一项目上要同时做功能分支开发与紧急 hotfix,用 Git worktree 开并行会话,避免两个 `claude` 会话抢同一目录。
  • 合并前在仓库里执行 `/review` 审查最近 diff,或开启 Plan Mode 先只读梳理改动范围再批准写文件。

适合人员

  • 在国内写业务代码的后端工程师,直连 Anthropic 不稳定,需要按文档配 CC Switch 并核对 `/model` 与 DeepSeek 槽位是否一致。
  • 维护单体或多包仓库的 Tech Lead,希望用 `.claude/commands/` 和 `/agents` 把 PR 审查、发布检查做成可重复斜杠流程。
  • 从 IDE 插件转到 Claude Code CLI 的全栈开发者,需要对照命令表掌握 `/compact`、`/clear` 和单次任务 `claude "任务"` 的用法。
  • 在项目里接入 MCP 与自定义 Hooks 的工程师,要配置 `.mcp.json`、用 `/hooks` 处理 `permission_prompt`,并在 MCP 启动失败时按 FAQ 逐项排查。