CC 公开技术手册

Claude Code

安装与配置返回文档中心

Claude Code 综合学习与安装配置手册

从安装配置到编程开发、文章写作、方案设计、PPT、报告和日常办公的一站式实践手册

版本日期： 2026 年 7 月 15 日
作者： code.jimuxyz.com 开发者
适用对象： 第一次接触 Claude Code 的用户、开发者、内容创作者，以及希望用 Claude Code 整理文档、制作方案、规划演示文稿和处理日常办公任务的个人或团队

积木 AI 安装与配置总入口： https://code.jimuxyz.com/docs/cli#config
第三方订阅低毛利定价： 把 Codex / Claude Code / Gemini 做成更直观的套餐权益，不让用户反复换算 tokens 成本。相比常见按 tokens 折算的中转站计费，日常使用更便宜、更好预估；具体价格、套餐权益、计费规则与实际成本以网站实时页面为准。
标准 API 中转： 如需标准 API 中转，也可以使用积木 API 中转平台：https://api.jimuxyz.com/
Windows Claude Code 复制命令页： https://code.jimuxyz.com/dashboard/claudecode-installation/windows-copy
macOS/Linux Claude Code 复制命令页： https://code.jimuxyz.com/dashboard/claudecode-installation/macos-linux-copy
Key 管理与用量入口： https://code.jimuxyz.com/keys

配套资料与快速开始

本手册围绕 Claude Code 的安装、配置、使用和结果验收展开。它既适合代码项目，也适合文章、方案、PPT、报告、产品文案和办公文件工作流。

一、先认识两套服务

开始前必须区分以下两套体系：

体系	用途	认证与计费	网络和支持
Anthropic 官方体系	Claude Code 官方 CLI、VS Code 扩展、Desktop、Web、Claude Console	Claude Pro/Max/Team/Enterprise、Console API 或官方支持的云服务商	以 Anthropic 官方支持地区、账号、套餐和网络要求为准
`code.jimuxyz.com` 第三方体系	提供 Claude Code Key、模型网关、国内网络配置教程、用量和套餐管理	使用本站 Claude Code 产品线 Key，费用和规则以网站实时页面为准	由第三方站点提供，不等同于 Anthropic 官方账号或官方订阅

二者不能混写成同一种服务。使用 code.jimuxyz.com 的 Key，不代表获得 Claude.ai 官方订阅、Claude Desktop 登录、Claude Code Web 或 Anthropic Console 权益；使用官方 Claude 账号，也不会自动获得本站额度。

本手册是独立学习资料，不是 Anthropic 官方文档。Claude、Claude Code 和 Anthropic 是相应权利人的名称或商标。涉及功能、模型、价格和地区支持时，以官方文档与服务页面的实时说明为准。

二、一键配置脚本与命令

请访问以下页面下载脚本，或按页面教程复制命令安装：

https://code.jimuxyz.com/docs/cli#config

Claude Code 的系统专用入口：

系统	推荐入口	说明
Windows	https://code.jimuxyz.com/dashboard/claudecode-installation/windows-copy	在 PowerShell 或 Windows Terminal 中按 1、2、3 顺序执行
macOS	https://code.jimuxyz.com/dashboard/claudecode-installation/macos-linux-copy	在终端中按 1、2、3 顺序执行
Linux	https://code.jimuxyz.com/dashboard/claudecode-installation/macos-linux-copy	在 Bash 终端中按 1、2、3 顺序执行

使用本站配置页时注意：

登录后先在 Key 管理中创建 Claude Code 产品线 Key。
Codex、Claude Code 和 Gemini 的 Key 不通用，不能混填。
命令中的 你的Claude_API_KEY 必须替换为自己的真实 Key，不要把 Key 发给他人。
每个系统只选择一种安装路线，不要同时反复执行复制命令版和下载脚本版。
某一步报错时先解决该错误，不要继续执行后续步骤。
配置完成后完全退出旧终端、VS Code、Cursor、JetBrains 等程序，再重新打开。

本站当前配置脚本会把 Claude Code 请求指向：

text

https://code.jimuxyz.com/p

并设置本站 Key、默认模型、超时时间等环境变量。脚本当前还会写入用户目录下的 .claude/config.json 以保存本站兼容标识。这里的 config.json 不等同于 Claude Code 官方的 settings.json，不要把二者混为一谈。

安全提示：网页脚本和命令可能更新。执行前应打开对应页面阅读当前内容；不要从聊天记录、截图或来源不明的网盘执行已经过期的命令。

三、推荐使用顺序

打开 https://code.jimuxyz.com/docs/cli#config，选择 Claude Code。
创建 Claude Code 产品线 Key，并确认账户额度和使用规则。
根据操作系统进入 Windows 或 macOS/Linux 页面。
安装依赖，执行环境检测、CLI 安装和本站配置三步。
重新打开终端，运行 claude --version 和 claude doctor。
进入一个练习目录，运行 claude，再用 /status 检查当前模型、认证和配置。
先做只读任务，再尝试创建一个 Markdown 文件，最后再进入真实项目。

四、十分钟快速验收

bash

# 1. 查看版本
claude --version

# 2. 只读诊断安装和配置
claude doctor

# 3. 创建练习目录
mkdir claude-code-practice
cd claude-code-practice

# 4. 启动交互会话
claude

进入 Claude Code 后依次输入：

text

/status
/model
/permissions

然后发出一个低风险任务：

text

请先说明当前工作目录和可见文件，不要修改任何文件。

确认读取范围正确后，再测试创建文件：

text

请创建 hello.md，写入三级标题“首次练习”和三条学习计划。完成后重新读取文件并检查 Markdown 结构。

完成标准：

claude --version 能输出版本号。
claude doctor 没有阻断使用的安装错误。
/status 显示预期的认证方式、API 地址或模型信息。
Claude Code 只在练习目录内创建了 hello.md。
文件内容可正常打开，没有泄露任何 Key。

内容摘要

Claude Code 是 Anthropic 提供的智能代理工具，可在终端、VS Code、桌面应用和浏览器等入口中工作。它能够读取授权范围内的文件、调用工具、执行命令、修改内容并根据测试或文件检查验证结果。

Claude Code 以软件开发见长，但不只用于写代码。它也能辅助文章撰写、方案设计、PPT 大纲、报告整理、产品文案、会议纪要和其他日常办公创作。通过 Skills、Plugins、MCP、Subagents、Hooks 以及本机安装的文档处理工具，还可以建立 Word、PPT、Excel 和 PDF 的可重复工作流。

需要特别说明：让 Claude Code“写出 PPT 大纲”和让它“生成可打开的 .pptx 文件”不是同一件事。Skills 主要提供操作说明和流程，真正创建特定格式通常还需要 python-docx、PptxGenJS、python-pptx、openpyxl、LibreOffice、Pandoc、Poppler 等工具。生成后必须实际打开或渲染验收。

本手册覆盖安装与配置、CLI/IDE/Desktop/Web 入口、模型、权限、常用命令、CLAUDE.md、Skills、Plugins、MCP、Subagents、Hooks、编程开发、内容创作、办公文件、排错、安全和验收模板。

关键词： Claude Code；CLI；VS Code；CLAUDE.md；Skills；Plugins；MCP；Subagents；Hooks；文章写作；PPT；报告；办公文件；结果验收

阅读说明

第一次使用建议按以下顺序阅读：

先阅读第 1 至第 4 章，完成安装和首次运行。
需要长期使用时阅读第 5 至第 9 章，理解命令、项目规则和扩展机制。
编程用户重点阅读第 10 至第 13 章。
内容与办公用户重点阅读第 18 至第 23 章。
遇到错误时查看第 25 章。
最后从模板和附录中选择可以直接复用的内容。

命令、模型、界面和套餐会持续变化。使用时按以下优先级核对：

本机 claude --help 与会话内 /help。
Anthropic Claude Code 官方文档：https://code.claude.com/docs/en/overview。
code.jimuxyz.com 当前安装配置页和 Key 管理页。
本手册记录。

如果前三者与本手册不同，以实时页面和本机版本为准。

全书结构

部分	主要内容	完成标准
第一部分	认识 Claude Code、选择入口、安装配置和首次运行	能检查版本、状态、模型和权限
第二部分	提问、上下文、项目规则和会话管理	能写出目标、范围、限制和验收
第三部分	Skills、Plugins、MCP、Subagents 和 Hooks	能按需求选择扩展方式
第四部分	编程开发和项目协作	能阅读、修改、测试并检查差异
第五部分	文章、方案、PPT、报告和办公文件	能区分内容稿与正式文件并完成验收
第六部分	自动化、排错、安全和长期维护	能用证据定位问题并控制风险
第七部分	模板、案例和练习	能独立完成一轮真实任务
附录	命令、目录、配置和资源速查	能快速定位所需入口

第一部分：认识 Claude Code 与完成首次运行

1. Claude Code 是什么

Claude Code 是可在授权环境中执行任务的智能代理。它不仅返回一段文字，还能在获得相应权限后：

阅读项目、文档、日志、图片和结构化数据。
搜索文件和追踪代码调用关系。
创建、修改和整理文件。
运行测试、构建、格式化和诊断命令。
使用浏览器、数据库、设计工具或项目管理系统等外部能力。
把复杂任务拆给 Subagents 并汇总结果。
使用 Skills 复用固定流程。
通过 Hooks 在特定事件发生时运行自动检查。
通过 MCP 接入外部工具和数据源。

Claude Code 的工作效果主要由五个条件决定：

条件	需要回答的问题
工作目录	它当前在哪个目录，能看到哪些文件
上下文	是否提供了相关材料、规则、日志和目标读者
权限	是否允许读取、编辑、执行命令或访问网络
工具	是否安装了完成特定格式或外部操作所需的工具
验收	用什么测试、渲染、数据或差异证明完成

1.1 Claude Code 能做什么

任务类型	典型工作	推荐验收
编程开发	阅读代码、修复缺陷、实现功能、补测试、审查改动	测试、构建、Git 差异、真实页面或接口
文章写作	提纲、初稿、改写、摘要、教程和公众号文案	对照素材，检查事实、结构、引用和语气
方案设计	现状、目标、备选方案、实施步骤、预算和风险框架	核对假设、数字、责任人和时间
PPT	受众分析、故事线、逐页大纲、讲稿、素材清单	检查叙事；生成文件后逐页渲染
报告整理	汇总材料、提取数据、形成管理摘要或正式报告	回查来源、数字和结论证据
产品文案	标题、卖点、FAQ、邮件和多版本文案	核对真实功能、平台规则和禁用表达
日常办公	会议纪要、周报、Word 排版、表格清洗、PDF 整理	打开文件，检查格式、公式、分页和链接
自动化	批量处理文件、定时任务、CI 审查、结构化输出	小样本试运行、日志、退出码和失败清单

1.2 Claude Code 不应替你决定什么

以下事项需要用户保留最终决定权：

是否删除、覆盖或公开重要数据。
是否部署生产环境、修改域名或重启关键服务。
是否向外部平台发送消息、发布内容、付款或提交审核。
是否采用法律、医疗、财务或合规结论。
是否安装来源不明的 Skill、Plugin、Hook 或 MCP server。
是否把私密资料交给第三方模型网关或外部工具。

正确分工是：Claude Code 负责调查、整理、实施和验证，人负责目标、授权、敏感数据和不可逆决策。

2. 选择适合自己的使用入口

Claude Code 的多个入口共享部分能力，但认证、网络、运行位置和功能并不完全相同。

入口	主要特点	适合任务	注意事项
Claude Code CLI	在终端中操作本地目录，过程清晰，可脚本化	编程、批量文件、文档生成、服务器和自动化	需要理解目录、终端和权限
VS Code 扩展	在编辑器内提供文件引用、差异审查和会话界面	代码、Markdown、文档和项目内协作	需要核对官方发布者和环境变量继承
其他编辑器内置终端	直接在 Cursor、Windsurf、JetBrains 等终端运行 CLI	与编辑器并行使用 Claude Code	终端方式不等于安装了专用扩展
Claude Desktop	图形化会话、文件、终端、预览和并行任务	偏好图形界面和多任务管理的用户	官方登录和网络要求与第三方 CLI 配置不同
Claude Code Web	在 Anthropic 云端环境处理远程仓库和任务	GitHub、远程任务和跨设备继续	使用官方订阅认证，不能由本地环境变量替代

2.1 CLI：本手册的主线

bash

# 进入项目后启动
cd /path/to/project
claude

# 带第一个任务启动
claude "先阅读当前项目并说明结构，不修改文件"

# 单次非交互查询，输出后退出
claude -p "概括当前目录中的 Markdown 文档"

# 继续当前目录最近一次会话
claude -c

CLI 适合需要明确控制工作目录、命令、文件修改和验证结果的用户。

2.2 VS Code 扩展

官方 VS Code 扩展要求 VS Code 1.98 或更高版本。安装时：

在扩展市场搜索 Claude Code。
核对发布者为 Anthropic，或从官方文档进入安装入口。
安装后重载窗口或重启 VS Code。
打开一个练习目录，从 Claude Code 面板发起只读任务。
修改前查看权限模式，修改后检查差异视图。

如果已经通过 code.jimuxyz.com 配置环境变量，但扩展仍要求登录，常见原因是 VS Code 没继承新环境。完全退出后重开，或从已生效的终端运行：

bash

code .

第三方 provider 在 VS Code 扩展中的支持和界面行为可能随版本变化，应以官方扩展的“Use third-party providers”说明和本站实时页面为准。

2.3 Claude Desktop

Claude Desktop 是 Anthropic 官方桌面应用。它可提供图形化会话、代码工作区、文件编辑、终端、预览、并行会话和连接器等能力，但具体功能依赖平台、版本、套餐和组织策略。

重要边界：

CLI 读取 ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN 和 apiKeyHelper。
包装 CLI 的 VS Code 扩展等入口通常可以继承这些配置。
Claude Desktop 默认使用官方 OAuth，不会简单读取上述环境变量。
组织分发的第三方推理配置属于另一种专门部署方式，不能假设本站 CLI 脚本自动配置所有 Desktop 功能。

因此，使用 code.jimuxyz.com 时，新手优先采用本站明确支持的 CLI 安装路线。

2.4 Claude Code Web

Claude Code Web 在 Anthropic 托管环境中运行，适合连接 GitHub、处理云端任务、共享会话和跨设备继续。它始终使用官方订阅认证，云端沙箱中的 ANTHROPIC_API_KEY 或 ANTHROPIC_AUTH_TOKEN 不会替代该认证。

如果当前目标是使用本站 Key 和国内配置，请使用 CLI 或本站说明明确支持的入口，不要把 Web 登录问题误认为 CLI Key 问题。

2.5 为非编程任务准备工作目录

文章、方案、PPT 和办公任务也应在独立目录中进行：

text

content-project/
├── CLAUDE.md
├── sources/          # 原始资料，只读保存
├── notes/            # 摘录、访谈和事实记录
├── drafts/           # Markdown 初稿
├── assets/           # 图片、图表和品牌素材
├── output/           # Word、PPT、Excel、PDF 等正式输出
└── review/           # 校对和验收记录

把原始资料和输出分开，能减少覆盖原件和引用错误。

3. 按 `code.jimuxyz.com` 安装和配置

3.1 安装前准备

准备一：确认系统要求

Anthropic 当前官方文档列出的基本要求包括：

macOS 13.0 或更高版本。
Windows 10 1809、Windows Server 2019 或更高版本。
Ubuntu 20.04、Debian 10、Alpine Linux 3.19 或更高版本。
至少 4 GB 内存，x64 或 ARM64 处理器。
可用网络连接和终端环境。

官方支持范围会变化，请查看：

https://code.claude.com/docs/en/setup

准备二：安装 Node.js 22 或更高版本

本站当前采用 npm 安装 Claude Code。Anthropic 官方文档截至本手册日期说明，Claude Code npm 包从 v2.1.198 起要求 Node.js 22 或更高版本。本站页面中的旧版最低版本提示可能尚未同步，因此本手册统一建议安装 Node.js 22 LTS 或更高版本。

安装后检查：

bash

node --version
npm --version

不要使用 sudo npm install -g，它可能造成权限和安全问题。

准备三：Windows 安装 Git for Windows

Anthropic 官方当前把 Git for Windows 视为原生 Windows 的可选依赖：没有它时，新版本可以使用 PowerShell 工具；安装后可以使用 Git Bash/Bash 工具。本站 Windows 部署脚本会尽量自动发现并写入 Git Bash 路径，因此建议本站路线的 Windows 用户安装 Git for Windows。

下载时优先从本站页面提供的链接或 Git 官方入口进入，不要安装来源不明的打包版本。

准备四：创建正确的 Key

打开 https://code.jimuxyz.com/keys。
创建或复制 Claude Code 产品线 Key。
确认 Key 状态、余额、权限和套餐。
不要使用 Codex 或 Gemini Key。
不要把 Key 写入本手册、项目代码、截图、Git 或公开聊天。

3.2 Windows 安装

打开：

https://code.jimuxyz.com/dashboard/claudecode-installation/windows-copy

页面当前要求在 PowerShell 或 Windows Terminal 中按顺序执行：

powershell

# 第 1 步：环境检测
powershell -NoProfile -ExecutionPolicy Bypass -Command "iwr -useb https://code.jimuxyz.com/env_deploy/claude-install.ps1 | iex"

# 第 2 步：安装 Claude Code CLI
powershell -NoProfile -ExecutionPolicy Bypass -Command "[Environment]::SetEnvironmentVariable('JIMUXYZ_NPM_PACKAGE','@anthropic-ai/claude-code','Process'); [Environment]::SetEnvironmentVariable('JIMUXYZ_NPM_DISPLAY_NAME','Claude Code CLI','Process'); iwr -useb https://code.jimuxyz.com/env_deploy/npm-global-install.ps1 | iex"

# 第 3 步：写入本站配置
# 执行前必须把占位文字替换成自己的真实 Claude Code Key
powershell -NoProfile -ExecutionPolicy Bypass -Command "[Environment]::SetEnvironmentVariable('JIMUXYZ_CLAUDE_KEY','你的Claude_API_KEY','Process'); iwr -useb https://code.jimuxyz.com/env_deploy/claude-deploy.ps1 | iex"

执行要求：

第三步不能保留占位文字。
不要在录屏、截图或共享终端中显示真实 Key。
完成后完全退出 PowerShell、Windows Terminal、VS Code 和其他编辑器。
重新打开终端后再验证。

3.3 macOS/Linux 安装

打开：

https://code.jimuxyz.com/dashboard/claudecode-installation/macos-linux-copy

页面当前命令为：

bash

# 第 1 步：环境检测
curl -fsSL https://code.jimuxyz.com/env_deploy/claude-install.sh | bash

# 第 2 步：安装 Claude Code CLI
npm install -g @anthropic-ai/claude-code@latest --registry=https://registry.npmmirror.com

# 第 3 步：写入本站配置
# 执行前必须把占位文字替换成自己的真实 Claude Code Key
curl -fsSL https://code.jimuxyz.com/env_deploy/claude-deploy.sh | bash -s -- "你的Claude_API_KEY"

完成后可以重新打开终端，也可以按页面提示加载对应 shell 配置：

bash

# 使用 zsh 时
source ~/.zshrc

# 使用 bash 时
source ~/.bashrc

只执行与当前 shell 对应的一条。长期使用时，完全重开终端更容易避免旧环境残留。

3.4 本站脚本会写入什么

截至本手册日期，本站部署脚本主要设置：

配置	当前用途
`ANTHROPIC_BASE_URL`	指向 `https://code.jimuxyz.com/p`
`ANTHROPIC_API_KEY`	保存本站 Claude Code Key，作为 API Key 兼容方式
`ANTHROPIC_AUTH_TOKEN`	保存同一个本站 Key，作为 Bearer Token 兼容方式
`ANTHROPIC_MODEL`	当前默认写入 `claude-sonnet-4-6`
`API_TIMEOUT_MS`	当前写入较长的请求超时
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`	减少非必要外部流量
`CLAUDE_CODE_GIT_BASH_PATH`	Windows 找到 Git Bash 时写入其路径
`~/.claude/config.json`	写入本站兼容标识 `primaryApiKey`

这些值可能由站点更新。不要根据本文手工覆盖脚本的新版本配置，应优先查看站点页面和脚本当前内容。

Claude Code 官方用户设置主要位于：

text

macOS/Linux: ~/.claude/settings.json
Windows:     %USERPROFILE%\.claude\settings.json

本站脚本写入的 config.json 与官方 settings.json 用途不同。项目级配置还可能位于 .claude/settings.json 和 .claude/settings.local.json。

3.5 验证安装与本站配置

bash

claude --version
claude doctor
claude --help

进入 Claude Code 后运行：

text

/status
/model
/permissions

检查以下内容：

CLI 版本正常。
/status 显示的认证方式符合预期。
API 地址指向本站网关时，没有混入其他 provider。
当前模型是本站支持的模型。
第一次发送简单请求没有 401、403 或 model not found。

不要通过输出完整环境变量来验证 Key。必须检查环境变量时，只判断是否存在，不打印值：

bash

# macOS/Linux，仅显示 SET 或 NOT_SET
if [ -n "${ANTHROPIC_API_KEY:-}" ]; then echo SET; else echo NOT_SET; fi

Windows PowerShell：

powershell

if ($env:ANTHROPIC_API_KEY) { "SET" } else { "NOT_SET" }

3.6 官方安装路线与本站路线的关系

Anthropic 当前推荐原生安装，例如官方 macOS/Linux 安装脚本、Windows PowerShell 安装脚本、Homebrew 或 WinGet。本站当前教程则采用 npm 安装并额外写入第三方网关配置。

两条路线解决的问题不同：

官方安装说明负责获得 Claude Code 程序本体。
本站教程同时处理程序安装、本站 Key 和网关配置。

如果目标是使用 code.jimuxyz.com，按本站完整步骤执行最容易保持配置一致。不要只运行官方安装后就假设本站 Key 已配置，也不要只写入 Key 而忽略 CLI 是否正确安装。

3.7 更新、重装和卸载

本站 npm 路线更新：

bash

npm install -g @anthropic-ai/claude-code@latest

检查：

bash

claude --version
claude doctor

卸载 npm 版本：

bash

npm uninstall -g @anthropic-ai/claude-code

卸载程序不等于删除配置。环境变量、shell 配置、~/.claude/、会话历史和项目配置仍可能存在。删除前应备份并确认范围，不要直接删除整个用户目录。

4. 首次使用、模型与权限

4.1 在正确目录启动

bash

pwd
ls
claude

Windows PowerShell：

powershell

Get-Location
Get-ChildItem
claude

启动后先问：

text

请说明当前工作目录、主要文件和你准备读取的范围，暂时不要修改文件或执行写操作。

4.2 `/model` 是什么

/model 用于查看或切换当前模型：

text

/model

也可以在启动时指定：

bash

claude --model sonnet

官方 Claude Code 支持模型别名和完整模型名，但别名实际映射会随 provider、账号和版本变化。使用 code.jimuxyz.com 时，第三方网关决定哪些模型名可用；不要仅根据 Anthropic 官方列表假设本站已经支持。

本站脚本当前默认写入 claude-sonnet-4-6。如需切换：

先查看 /model 当前可选项。
查看本站实时模型和套餐说明。
切换后用一个最小请求验证。
出现 model not found 时恢复本站支持的模型，不要反复重装 CLI。

4.3 权限模式

Claude Code 的权限模式控制编辑文件、执行命令和访问网络时是否询问。常见模式包括：

界面名称	配置值	行为	适合场景
Manual	`default`	默认只读，编辑和多数命令需确认	新手、敏感项目
Edit automatically	`acceptEdits`	自动编辑文件，其他高风险动作仍受控制	已明确范围的迭代
Plan	`plan`	只分析和计划，不直接修改	陌生项目、需求不清
Auto	`auto`	在后台安全检查下减少确认	符合账号条件的长任务
Don't ask	`dontAsk`	只运行预先允许的工具	CI 和受控脚本
Bypass permissions	`bypassPermissions`	跳过多数检查	仅隔离容器或一次性虚拟机

会话中可用 Shift+Tab 在常用模式间切换，也可以运行：

text

/permissions

启动时指定 Plan 模式：

bash

claude --permission-mode plan

不要在真实服务器、个人主目录或含有重要资料的环境中使用 bypassPermissions。

4.4 第一个真实任务

推荐按三轮完成：

text

第一轮：只阅读当前目录，列出文件类型、结构和可能的风险，不修改。

第二轮：创建一个实施计划，写清要修改哪些文件、为什么、如何验收，等待我确认。

第三轮：只按确认后的范围实施；完成后重新读取输出并报告实际检查结果。

这种方式同样适用于写文章、做 PPT 和整理报告。

第二部分：把任务、上下文和规则说清楚

5. 一个可靠任务的六个组成部分

完整任务通常包含：

目标： 最终要得到什么结果。
背景： 为什么要做，给谁使用。
输入： 需要读取哪些文件、页面、日志或数据。
范围： 可以修改哪里，禁止操作哪里。
输出： 文件名、格式、位置、语言和风格。
验收： 如何证明结果正确。

模糊表达：

text

帮我做一个 PPT。

可执行表达：

text

根据 sources 目录中的三份访谈记录，制作一份面向公司管理层的项目复盘 PPT。
先只输出 12 页逐页大纲，包含封面、结论、数据、问题、原因、行动和附录。
不得编造数字；缺少数据的位置标记“待补充”。
我确认大纲后，再使用项目已有的 PPT 工具生成 output/review.pptx。
生成后逐页渲染为图片，检查文字溢出、图表标签和素材来源。

6. 上下文整理方法

6.1 最小充分上下文

不要把整个磁盘、全部聊天记录和所有历史项目一次交给 Claude Code。优先提供：

与任务直接相关的 1 至 5 个文件。
目标读者和用途。
当前错误的完整输出。
必须遵守的规则。
一个理想结果样例。
明确的禁止范围。

6.2 使用 `@` 引用文件

在支持的交互界面中，可用 @ 引用文件或目录：

text

请比较 @sources/requirements.md 和 @sources/current-design.md，列出冲突和缺口，暂时不要修改。

大文件应指定章节、页码或范围，避免无关内容占满上下文。

6.3 长任务交接模板

text

目标：
当前目录：
允许修改：
禁止修改：
已经完成：
正在进行：
尚未完成：
关键决定：
已验证证据：
已知风险：
下一步：

7. 使用 `CLAUDE.md` 固化规则

Claude Code 原生读取的是 CLAUDE.md。它适合保存项目长期有效的规则，例如：

markdown

# Project Rules

- Only modify files in this repository.
- Read before editing and preserve existing user changes.
- Never print or commit API keys, passwords, cookies, or private data.
- Run the focused tests before the full test suite.
- For documents, keep source files in sources/ and generated files in output/.
- Before delivery, reopen or render every generated office file.

7.1 常见位置

范围	位置	用途
用户	`~/.claude/CLAUDE.md`	个人跨项目偏好
项目	`CLAUDE.md` 或 `.claude/CLAUDE.md`	团队共享规则
本地个人	`CLAUDE.local.md`	当前项目的个人设置，通常不提交
子目录	子目录中的 `CLAUDE.md`	进入对应模块时加载的规则
细分规则	`.claude/rules/*.md`	按主题或路径组织规则

7.2 已有 `AGENTS.md` 时怎么做

Claude Code 当前不会把 AGENTS.md 当作原生项目记忆自动读取。项目已经有 AGENTS.md 时，可以创建：

markdown

@AGENTS.md

## Claude Code

- Use plan mode before changing production configuration.

这样 CLAUDE.md 会导入已有规则，避免维护两份冲突内容。

7.3 `/init`、`/memory` 和自动记忆

常用命令：

text

/init
/memory

/init 可帮助为当前项目生成初始 CLAUDE.md。
/memory 用于查看和编辑项目记忆与自动记忆。
CLAUDE.md 适合明确、可审查、可共享的规则。
自动记忆适合 Claude Code 在本地积累的使用经验，但仍应定期检查。

不要把密钥、临时密码、客户隐私或大段教程塞进 CLAUDE.md。过程性说明更适合 Skill，敏感值应由安全的凭据机制提供。

8. 会话与上下文管理

8.1 常用命令

命令	用途
`/status`	查看当前状态、模型、认证和环境摘要
`/context`	查看上下文使用情况
`/compact`	压缩较长会话，可附带保留重点的说明
`/clear`	开始新任务，清空当前对话上下文
`/resume`	恢复历史会话
`/rename`	给会话命名，便于恢复
`/rewind`	回到检查点或回退部分代码与对话
`/recap`	查看会话回顾，是否可用取决于版本
`/cost`	查看 API 使用成本信息，显示方式取决于 provider
`/usage`	查看套餐或使用情况，是否可用取决于账号和入口

8.2 什么时候新开会话

以下情况建议 /clear 或新开会话：

已从安装排错切换到真实项目开发。
已从文章写作切换到完全无关的代码任务。
上下文中存在多套相互冲突的要求。
Claude 持续引用已经废弃的方案。
当前会话包含不应继续使用的敏感上下文。

8.3 恢复会话

bash

# 继续当前目录最近一次会话
claude -c

# 恢复指定会话
claude -r "会话名称或 ID"

恢复后先要求 Claude 概括目标、已完成内容和待验证项，不要直接说“继续”。

9. 常用交互命令

9.1 命令与普通提示词的区别

/model、/permissions、/status 等是 Claude Code 交互命令。
npm test、git diff、python script.py 是终端命令。
“请检查测试失败原因”是给 Claude 的普通提示词。

不要在系统终端直接输入 /model，也不要把 npm test 当作斜杠命令。

9.2 推荐掌握的命令

命令	作用	使用时机
`/help`	查看本机当前可用命令	不确定命令名时
`/status`	查看会话和配置状态	首次运行、切换 provider 后
`/model`	查看或切换模型	速度、质量或兼容性需要变化时
`/permissions`	查看和设置工具权限	修改文件或运行命令前
`/config`	打开设置界面	修改用户偏好和部分配置
`/init`	初始化项目 `CLAUDE.md`	首次进入项目时
`/memory`	查看项目规则和自动记忆	规则未生效或需要整理时
`/context`	查看上下文占用	长会话、工具过多时
`/compact`	压缩当前会话	上下文接近上限时
`/clear`	清理当前会话	切换到新任务时
`/plan`	进入或发起计划流程	复杂任务修改前
`/diff`	查看当前变更	提交或交付前
`/rewind`	回退到检查点	修改方向错误时
`/doctor`	诊断安装与配置	安装、配置或扩展异常时
`/mcp`	查看和管理 MCP 连接	外部工具不可用时
`/plugin`	浏览和管理 Plugins	安装扩展前后
`/skills`	查看 Skills	查找或诊断 Skill 时
`/hooks`	查看 Hooks	自动化规则未触发时
`/resume`	恢复历史会话	继续之前的任务
`/exit`	退出 Claude Code	当前工作完成时

命令可用性取决于 Claude Code 版本、平台、账号、套餐和 provider。附录 A 提供更完整的分类速查，但最终以 /help 为准。

第三部分：扩展 Claude Code 的能力

10. 六种扩展机制如何选择

机制	主要作用	典型位置	适合内容
`CLAUDE.md`	每次会话加载的长期规则	项目根目录或 `.claude/`	编码规范、目录边界、常用命令
Skills	按需加载的流程和专业说明	`.claude/skills/<name>/SKILL.md`	PPT、报告、发布、审查等重复工作流
Subagents	使用独立上下文完成专门任务	`.claude/agents/*.md`	调研、审查、测试、数据分析
Hooks	在事件发生时执行确定性动作	`settings.json`	格式化、保护文件、通知和审计
MCP	连接外部工具、服务和数据源	`.mcp.json` 或用户配置	GitHub、Notion、数据库、设计工具
Plugins	打包和分发 Skills、Agents、Hooks、MCP、LSP	插件目录和 marketplace	团队或社区复用的完整扩展

选择原则：

一条长期规则写进 CLAUDE.md。
一套重复流程写成 Skill。
需要隔离上下文或并行调查时用 Subagent。
需要每次确定触发的自动动作时用 Hook。
需要访问外部系统时用 MCP。
需要把多个能力作为一套产品安装时用 Plugin。

11. Skills：把重复方法变成可复用能力

Skill 是一个包含 SKILL.md 的目录。Claude Code会根据描述自动选择，也可以由用户输入 /skill-name 直接调用。

11.1 Skill 的位置

范围	位置
个人跨项目	`~/.claude/skills/<skill-name>/SKILL.md`
项目共享	`.claude/skills/<skill-name>/SKILL.md`
Plugin 内	Plugin 的 `skills/` 目录

旧版 .claude/commands/name.md 仍兼容，并会创建 /name 命令；官方当前建议使用 Skills，因为它支持配套文件、调用控制和自动发现。

11.2 最小 Skill 示例

markdown

---
name: management-report
description: Turn source notes into a management report with traceable facts and action items.
---

# Management Report Workflow

1. Inventory all source files before writing.
2. Separate facts, assumptions, risks, and recommendations.
3. Preserve every date and number from the source.
4. Mark missing evidence as TODO instead of inventing it.
5. Draft in Markdown first.
6. If a DOCX or PDF is requested, verify the required conversion tools exist.
7. Reopen or render the final file and produce a review checklist.

保存到：

text

.claude/skills/management-report/SKILL.md

使用：

text

/management-report 根据 sources 目录生成本月项目报告

11.3 Skill 不是软件安装包

Skill 可以告诉 Claude Code 如何做一件事，但不会凭空提供外部程序。例如：

PPT Skill 可以定义叙事、版式和验收流程。
真正写入 .pptx 仍需 PptxGenJS、python-pptx 或其他工具。
PDF Skill 可以定义提取、合并和渲染流程。
真正操作 PDF 仍需相应库或系统工具。

因此每个办公 Skill 都应包含：

所需工具和版本。
输入、输出目录规则。
小样本试运行。
正式生成步骤。
打开或渲染验收。
工具不存在时的停止条件。

11.4 内置 Skills

Claude Code 当前包含若干内置 Skills，例如 /doctor、/code-review、/batch、/debug、/loop 和 /claude-api，具体列表和可用性随版本变化。/run、/verify 和 /run-skill-generator 可帮助启动并验证应用，但仍需项目具有可识别或已记录的运行方式。

使用前运行：

text

/skills
/help

不要把 Codex 的系统 Skill 名称直接当作 Claude Code 已安装能力。名称相同也不代表内容相同。

12. Plugins：安装成套扩展

Plugin 可以同时包含 Skills、Subagents、Hooks、MCP、LSP 和默认设置。Claude Code 官方 marketplace 通常可以通过：

text

/plugin

打开浏览和管理界面。

安装示例：

text

/plugin install github@claude-plugins-official

官方 marketplace 名为 claude-plugins-official，但“官方 marketplace 收录”不等于每个外部服务都由 Anthropic 负责。安装前仍需查看：

插件发布者和来源。
将安装哪些 Skills、Agents、Hooks、MCP 或 LSP。
是否运行本机命令。
是否读取项目、环境变量或凭据。
是否连接外部域名。
上次更新时间和权限范围。

常见官方 marketplace 类别包括代码智能、GitHub/GitLab、项目管理、设计、基础设施、通信、监控和开发工作流。实际列表以 /plugin 为准。

13. MCP、Subagents 与 Hooks

13.1 MCP：连接外部系统

MCP 让 Claude Code 使用外部工具和数据。典型场景包括：

GitHub 或 GitLab 仓库、Issue 和 Pull Request。
Notion、Linear、Jira、Confluence 等协作系统。
Figma 设计数据。
Sentry 监控和错误信息。
数据库或内部业务 API。

常用命令：

bash

# 查看 MCP CLI 帮助
claude mcp --help

# 列出已配置服务器
claude mcp list

会话内：

text

/mcp

MCP server 可能看到你发送给它的数据。安装前要核对服务器代码、域名、传输方式、认证范围和数据策略。

13.2 Subagents：隔离和并行任务

Subagent 有独立上下文、提示词、工具和可选模型，适合：

让一个代理调查代码结构。
让一个代理检查安全问题。
让多个代理并行阅读不同资料。
把高噪声日志分析从主会话隔离出去。

典型位置：

text

项目：.claude/agents/
用户：~/.claude/agents/

Subagent 不是越多越好。任务有强依赖、共享文件或决策频繁变化时，盲目并行会造成冲突和重复成本。

13.3 Hooks：确定性自动化

Hooks 在特定事件发生时运行，可以：

编辑后自动格式化。
阻止修改受保护文件。
会话需要输入时发送通知。
压缩上下文后重新注入必要信息。
记录配置变化。
在允许范围内自动批准特定低风险命令。

Hook 会实际运行命令或调用 URL，风险高于普通文字说明。安装外部 Hook 前必须阅读脚本，限制执行目录和网络范围，并先在练习项目测试。

13.4 一个办公扩展组合示例

text

CLAUDE.md
  保存品牌语气、素材边界、输出目录和验收原则

Skill: content-report
  负责从资料到报告的六步流程

Subagent: fact-checker
  独立核对日期、数字和引用

Hook: protect-sources
  阻止修改 sources/ 原始资料

MCP: Notion
  在授权后读取指定知识库页面

Plugin
  将上述能力打包给团队安装

第四部分：与代码项目协作

14. 进入陌生项目的阅读顺序

确认当前目录和 Git 状态。
阅读 CLAUDE.md、AGENTS.md、README 和部署说明。
识别语言、框架、依赖管理和启动入口。
找到配置、路由、业务和数据存储层。
搜索与当前任务直接相关的关键词。
阅读测试，理解现有行为承诺。
先形成项目地图，再提出修改计划。

项目地图模板：

text

项目目标：
主要语言和框架：
程序入口：
配置来源：
核心模块：
数据存储：
外部服务：
测试入口：
构建与部署：
允许修改：
禁止修改：
当前任务相关文件：

15. 先探索、再计划、再修改

推荐提示词：

text

请先探索当前项目：
1. 阅读项目规则和 README；
2. 找到与登录失败相关的路由、服务、数据库和测试；
3. 说明实际调用链和已有测试；
4. 列出最可能的根因与证据；
5. 暂时不要修改任何文件。

确认后：

text

请给出最小修改计划，写清文件、行为变化、兼容性和测试。等待我确认后再实施。

16. 修改和验证闭环

16.1 修改前

保存当前状态和错误复现证据。
检查工作区是否有他人未提交改动。
找到最接近的现有实现和测试。
明确数据库、外部 API 和生产服务风险。

16.2 修改中

只改解决当前目标所需的文件。
延续项目已有模式。
不通过吞掉异常或伪造成功来“修复”问题。
外部请求设置超时、错误处理和可追踪日志。
批量和重复请求考虑幂等性。
不覆盖用户已有改动。

16.3 修改后

bash

# 根据项目替换为真实命令
npm test
npm run build
git diff --check
git diff
git status --short

然后要求 Claude Code：

text

请逐项报告你实际运行的检查、退出码和结果。不要把“建议运行”写成“已经通过”。最后列出仍未验证的部分。

17. 代码审查和安全检查

常用命令可能包括：

text

/diff
/code-review
/security-review

也可以使用普通提示词：

text

请审查当前改动，优先找行为回归、权限绕过、数据丢失、并发、幂等、外部 API 错误处理和缺失测试。先按严重程度列出问题并引用文件位置，不要先给总结。

审查输出仍需验证。不要因为模型没有发现问题，就认为改动一定安全。

第五部分：文章、方案、PPT、报告与日常办公

18. 内容创作的完整工作流

Claude Code 能处理内容创作，是因为文章、方案、PPT 和报告本质上都可以拆成“收集材料、组织信息、生成内容、制作文件、检查结果”五类任务。是否涉及代码不是关键，输入、规则、工具和验收是否明确才是关键。

推荐采用六步流程：

盘点素材： 列出所有文件、网页、图片、表格和访谈记录。
建立事实表： 区分原文事实、用户观点、模型推断和待确认信息。
确定受众： 明确读者是谁、阅读场景、希望采取什么行动。
先做结构： 先确认提纲、故事线或页面大纲，再写全文。
生成载体： 从 Markdown 内容稿转换为 Word、PPT、Excel 或 PDF。
实际验收： 回查来源，打开或渲染文件，检查内容和版式。

18.1 建议目录

text

creative-work/
├── CLAUDE.md
├── sources/
│   ├── interviews/
│   ├── reports/
│   └── data/
├── assets/
│   ├── images/
│   ├── charts/
│   └── brand/
├── drafts/
├── output/
└── review/

在 CLAUDE.md 中写明：

markdown

# Content Project Rules

- Treat sources/ as read-only.
- Never invent dates, numbers, quotes, links, product capabilities, or customer claims.
- Clearly label assumptions and missing evidence.
- Draft content in Markdown before creating office files.
- Put generated files in output/ and review artifacts in review/.
- Reopen or render every DOCX, PPTX, XLSX, and PDF before delivery.

18.2 建立事实表

在开始写作前，可要求 Claude Code 创建：

编号	事实或主张	来源	原文位置	可信状态	可否公开
F-001	待填写	文件名/URL	页码/段落	已核实/待核实	是/否

提示词：

text

请读取 sources 目录，先不要写文章。创建 drafts/fact-map.md：
1. 列出每个可验证的日期、数字、人物、产品能力和引用；
2. 标明来源文件和页码或段落；
3. 将推测、建议和事实分开；
4. 冲突信息并列保留；
5. 不得补写来源中不存在的事实。

19. 文章、教程和产品文案

19.1 文章写作

文章任务至少要说明：

读者是谁。
发布渠道。
希望解决的问题。
期望篇幅和结构。
必须使用的素材。
禁止编造或禁止使用的表达。
是否需要引用、链接、SEO 标题或摘要。

可直接复用的提示词：

text

请根据 sources 目录撰写一篇面向第一次接触 AI 命令行工具用户的入门文章。

要求：
- 目标：帮助读者理解工具用途并完成一次低风险练习；
- 篇幅：2500 至 3500 字；
- 结构：标题、导语、适用人群、准备、步骤、示例、常见问题、总结；
- 语气：清楚、克制，不使用夸张承诺；
- 事实：所有版本、命令和链接必须回查来源；
- 缺失：无法确认的信息标为“以实时页面为准”；
- 输出：drafts/article.md；
- 验收：检查标题层级、代码围栏、链接和重复段落。

先提交提纲和事实缺口，等我确认后再写全文。

19.2 教程写作

教程不能只列命令，还应包含：

适用系统和版本。
执行位置。
前置条件。
每一步的预期输出。
出错时何时停止。
成功验收方式。
卸载或恢复方法。

教程命令中的 Key、密码、域名和路径应使用明显占位符，并说明替换规则。

19.3 产品文案

text

请根据 @sources/product-spec.md 和 @sources/faq.md 创建产品文案。

输出：
1. 一句话定位；
2. 三组不同角度的标题；
3. 五条有证据的核心卖点；
4. 功能说明；
5. 适用与不适用人群；
6. 十个 FAQ；
7. 100 字、300 字和 800 字三个版本。

限制：
- 不添加源文件没有的功能；
- 不使用“绝对、安全、永久、零风险”等无法证明的词；
- 每条卖点后附内部事实编号，正式发布稿再移除编号；
- 把仍待确认的信息列在 review/copy-gaps.md。

19.4 宣传与事实边界

推广 code.jimuxyz.com 时可以明确说明：

网站提供 Codex、Claude Code、Gemini 等产品线的安装配置入口。
Claude Code 的 Windows 和 macOS/Linux 教程页面地址。
Key 管理、用量和套餐以网站实时页面为准。
站点属于第三方服务，不是 Anthropic 官方站点。

不能写成：

使用本站 Key 等于购买 Anthropic 官方订阅。
所有 Claude 官方 App 和 Web 功能都可由本站 CLI Key 解锁。
任何网络、模型、价格或可用性永久不变。
未经核实的“官方授权”“永久稳定”或“无限使用”。

20. 方案、报告、会议纪要和周报

20.1 方案设计

高质量方案不只是“建议做什么”，还应说明为什么、由谁做、何时完成、成本和失败处理。

推荐结构：

text

1. 摘要
2. 背景与现状
3. 问题定义
4. 目标与非目标
5. 约束和假设
6. 备选方案
7. 推荐方案及理由
8. 实施步骤与里程碑
9. 角色和责任
10. 预算与资源
11. 风险、监控和回滚
12. 验收指标
13. 待确认事项

提示词：

text

根据 sources 目录设计一份实施方案。先建立事实和假设清单，再比较至少两个可行方案。

每个方案按以下维度比较：
- 目标覆盖
- 实施复杂度
- 成本和人员
- 时间
- 数据与安全风险
- 兼容性
- 故障恢复
- 长期维护

推荐方案必须说明取舍，不得把未知预算和日期写成确定值。输出 drafts/implementation-plan.md，并把需要业务方确认的问题放在最后。

20.2 调研和分析报告

报告中的每个结论都应能回到证据。建议区分：

类型	含义	写作要求
事实	来源直接提供的信息	标记来源，保持原意
计算	根据数据得出的结果	保存公式或计算过程
推断	基于事实的解释	明确写成分析，不伪装成事实
建议	对未来行动的选择	说明前提、成本和风险
待确认	当前证据不足	保留空缺，不编造

报告提示词：

text

请把 sources 中的研究资料整理为正式报告。
目标读者：管理层。
核心问题：项目是否应进入第二阶段。

先输出：
1. 来源清单；
2. 关键事实表；
3. 数据冲突；
4. 拟定目录；
5. 仍需补充的信息。

确认后撰写 Markdown 报告。结论必须能追溯到事实编号；没有数据支持的部分不得写成确定结论。

20.3 会议纪要

会议纪要应区分“讨论”和“决定”。推荐结构：

text

会议主题：
日期与时间：
参会人：
材料来源：

一、结论摘要
二、已确认决定
三、行动项（负责人、截止日期、验收）
四、讨论要点
五、风险与阻塞
六、未决问题
七、下次会议

如果录音转写没有可靠说话人标记，不要自行确定某句话由谁说。日期、责任人和截止时间缺失时标记待确认。

20.4 周报和月报

text

请根据 notes 目录中的日报、工单和会议纪要生成本周项目周报。
只保留本周发生的事项，重复内容合并。

结构：
- 本周结论
- 已完成工作及证据
- 进行中工作和完成度口径
- 指标变化
- 问题与影响
- 风险和应对
- 下周计划
- 需要决策的事项

所有百分比和日期必须有来源。不要把计划写成已完成。

21. 使用 Claude Code 制作 PPT

21.1 三个不同层次

层次	产物	是否需要额外工具
内容策划	受众、目标、故事线和素材清单	通常不需要
逐页大纲	每页标题、要点、图表建议和讲稿	通常不需要
可编辑演示文件	`.pptx`、主题、图片、图表、备注	需要 PPT Skill 和文件生成工具

Claude Code 能直接写出高质量大纲，但不会因为提示词中出现“生成 PPT”就自动拥有 PPTX 写入、渲染和视觉检查能力。

21.2 PPT 的推荐流程

明确受众、场合、时长和目标。
从素材中建立事实表。
先设计一句核心结论和三至五个支撑观点。
输出逐页大纲，控制一页一个主要信息。
确认页面数量、结构和视觉风格。
检查项目是否有 PPT Skill 和生成工具。
生成 .pptx 到 output/。
将每页渲染成图片或 PDF。
检查文字溢出、重叠、留白、图表和素材来源。
根据渲染结果修订，并再次验收。

21.3 PPT 大纲提示词

text

请根据 sources 中的材料，为一场 15 分钟内部汇报设计 12 页 PPT。

受众：不了解技术细节的管理层。
目标：让管理层决定是否批准第二阶段预算。
结构：封面、执行摘要、现状、三项关键发现、方案比较、推荐方案、计划、预算框架、风险、决策请求、附录。

每页输出：
- 页码和标题
- 本页唯一核心结论
- 最多三条正文
- 推荐图表或图片
- 数据来源
- 讲者备注

先只写 drafts/deck-outline.md，不生成 PPTX，不编造数字。

21.4 生成 PPTX 的提示词

在已经安装并验证 PPT Skill 和工具后使用：

text

根据已确认的 @drafts/deck-outline.md 生成 output/project-review.pptx。

要求：
- 16:9；
- 使用 assets/brand 中的标志、字体和色板；
- 不使用无来源的装饰图片；
- 每页只保留一个主要结论；
- 图表数据必须来自 sources/data；
- 保留可编辑文本和图表；
- 将讲稿写入备注；
- 不覆盖已有文件，已有时创建带时间戳的新文件。

生成后：
1. 校验 PPTX 结构；
2. 渲染全部页面到 review/slides/；
3. 创建 review/ppt-checklist.md；
4. 检查溢出、遮挡、字号、对齐、图片清晰度和来源；
5. 修复后重新渲染。

21.5 PPT Skill 应包含什么

一个可用的 PPT Skill 至少要规定：

支持的生成工具和依赖检查。
页面尺寸、字体、主题和颜色规则。
图片的来源、许可和裁切原则。
表格和图表的数据来源。
文本长度和最小字号。
文件命名、覆盖策略和输出目录。
PPTX 结构检查方式。
LibreOffice、PowerPoint 或其他渲染方式。
逐页截图或 PDF 验收。

如果 Skill 只说“请做得漂亮”，但没有生成和渲染工具，它只是提示词模板，不是完整 PPT 生产能力。

22. Word、Excel 和 PDF 工作流

22.1 Markdown 与正式文件

建议把 Markdown 作为内容源：

text

sources -> fact-map.md -> draft.md -> DOCX/PPTX/XLSX/PDF -> render -> review

这样更容易维护内容、比较差异和重新生成文件。

22.2 Word 文档

常见工具包括 python-docx、Pandoc 和 LibreOffice。它们各有边界：

工具	适合工作	注意事项
`python-docx`	精确创建和编辑 DOCX 结构	复杂目录、域和版式需额外处理
Pandoc	Markdown 与 DOCX 等格式转换	需要参考模板才能获得稳定样式
LibreOffice	转换和无界面渲染	不同 Office 版本仍可能有版式差异

Word 任务提示词：

text

把 @drafts/report.md 转为 output/report.docx。
使用项目现有 Word Skill 和参考模板；A4，保留一级至三级标题、目录、页码、表格和可点击链接。
不得改变正文事实。
生成后校验 DOCX 结构，再转换为 PDF 或页面图片检查分页、字体、表格宽度和代码块。

Word 验收：

文件能由 Word 或兼容软件打开。
标题层级进入目录。
中文字体正常，没有方框。
表格不超出页宽。
图片比例正确。
页码、页眉和分页合理。
链接完整可点击。
没有将 Markdown 标记原样泄露到正文。

22.3 Excel 和表格

常见工具包括 openpyxl、Pandas、LibreOffice 和 JavaScript 表格库。Claude Code 可以设计公式、清洗数据和创建图表，但必须验证公式和单元格类型。

提示词：

text

读取 sources/data.xlsx，先只分析工作表、表头、行数、空值、重复值和数据类型。
不要覆盖原文件。

确认后创建 output/cleaned-data.xlsx：
- 保留原始数据工作表；
- 清洗结果放在新工作表；
- 公式而不是静态值用于可计算指标；
- 冻结表头，设置筛选；
- 日期和金额使用正确格式；
- 创建 summary 工作表说明清洗规则和异常行数。

最后重新读取生成文件，检查公式、工作表、行列数和关键汇总值。

Excel 验收：

公式引用范围正确。
数字没有被保存成文本。
日期没有因时区或格式变化错位。
隐藏行列、合并单元格和筛选符合预期。
图表系列指向正确数据。
总计与独立计算一致。
原文件未被覆盖。

22.4 PDF

PDF 任务分为：

提取文本和表格。
OCR 扫描件。
合并、拆分、旋转和加水印。
从 Word/PPT/Markdown 生成 PDF。
渲染页面进行视觉检查。

常见工具包括 Poppler、pypdf、pdfplumber、OCR 工具、LibreOffice 和浏览器打印。不同工具对扫描件、表格和字体的支持不同。

提示词：

text

请先判断 sources/document.pdf 是文本型还是扫描型 PDF。
只提取第 5 至 20 页的标题、表格和结论，保留页码引用。
如果文本层不可用，再说明需要 OCR，不要把乱码当作原文。
输出 drafts/pdf-notes.md，并抽查三个页码与渲染页面一致。

PDF 验收：

页数符合预期。
页面方向正确。
中文字体、图片和链接正常。
没有空白页、裁切、重叠或不可见文字。
OCR 结果抽样回看原页。
合并后书签和页码关系清楚。

22.5 图片和视觉素材

Claude Code 可以通过已安装的图片生成 Skill、设计工具或外部服务制作视觉素材，也可以读取和整理已有图片。使用时应说明：

图片用途和尺寸。
是否需要透明背景。
目标读者和品牌规则。
必须展示的真实对象或数据。
禁止使用的元素。
素材权利和来源记录。
生成后的像素尺寸与清晰度验收。

内容准确性优先于装饰。产品、人物、地点和数据展示需要真实可核对的素材时，不应使用无法代表真实对象的通用生成图替代。

23. 推荐的办公 Skills 组合

Claude Code 没有一个固定、永久且适用于所有用户的“办公 Skill 全家桶”。可根据任务安装可信 Plugin、创建项目 Skill，或使用组织内部分发的 Skill。推荐按能力组合，而不是只看名称：

能力类型	主要任务	必须检查
Word/Document Skill	DOCX 创建、编辑、模板和渲染	DOCX 工具、模板、字体、打开验收
Presentation Skill	PPT 大纲、PPTX 生成、主题和逐页检查	PPTX 工具、渲染器、图片和溢出检测
Spreadsheet Skill	XLSX 公式、清洗、格式和图表	表格库、公式重算、关键值复核
PDF Skill	提取、OCR、合并、生成和渲染	PDF 工具、字体、页数和抽样回查
Image/Design Skill	配图、封面、海报和视觉素材	图片生成/编辑工具、尺寸和素材权利
Research Skill	网页调研、来源记录和事实核对	网络工具、来源质量和引用
Transcription Skill	音视频转文字、说话人整理	转写引擎、隐私和人工抽查
Theme/Brand Skill	统一 Word/PPT/网页视觉语言	品牌素材、字体授权和设计规则

23.1 安装前检查

text

请只检查这个 Skill 或 Plugin，不要安装：
1. 来源和维护者是谁；
2. 包含哪些文件；
3. 会运行哪些脚本和命令；
4. 需要哪些网络域名和凭据；
5. 可以读写哪些目录；
6. 是否会上传文档内容；
7. 是否固定了依赖版本；
8. 如何卸载和清理；
9. 给出风险结论和最小权限建议。

23.2 安装后验收

运行 /skills 或 /plugin 确认已加载。
在无敏感资料的练习目录测试。
使用一个最小样本生成文件。
检查命令、网络和文件访问范围。
打开或渲染生成结果。
记录依赖版本和卸载方式。
通过后再用于真实材料。

第六部分：自动化、排错、安全与验收

24. 批量任务与非交互模式

24.1 批量任务先小样本

任何批量操作都应按以下顺序：

统计输入数量和格式。
排除输出目录、隐藏目录和临时文件。
确定覆盖策略。
抽取一个普通、一个最大和一个异常样本。
先处理 1 至 3 个文件。
检查内容和格式。
再运行全量任务。
输出成功、跳过和失败清单。

24.2 `claude -p`

非交互模式可用于脚本：

bash

claude -p "概括当前项目的入口和测试命令"

管道输入：

bash

cat build-error.txt | claude -p "简要说明最可能的根因" > analysis.txt

结构化输出：

bash

claude -p "列出 auth.py 中的主要函数" \
  --output-format json \
  --json-schema '{"type":"object","properties":{"functions":{"type":"array","items":{"type":"string"}}},"required":["functions"]}'

自动化时应明确允许的工具：

bash

claude -p "读取 Markdown 并生成摘要，不修改源文件" \
  --allowedTools "Read"

--bare 可减少自动加载本机 Hooks、Skills、Plugins、MCP、记忆和 CLAUDE.md，适合需要可重复环境的脚本。使用第三方本站 Key 时，仍需确保认证环境变量在该进程中可用。

24.3 自动化的安全要求

不在命令行参数中明文记录长期 Key。
不把完整敏感文件通过管道发送给不明确的 provider。
使用最小 --allowedTools。
设置超时和失败退出。
保存输入清单和输出清单。
幂等任务重复运行不应制造重复记录。
生产操作前增加人工审批。

25. 安装和请求故障排查

25.1 五层排查法

层次	检查内容
程序	`claude` 是否安装，版本和路径是否正确
环境	Node/npm、shell、Git Bash、配置文件和环境变量是否生效
认证	Key 产品线、状态、额度和认证优先级是否正确
网络	DNS、证书、代理、API 地址和超时是否正常
模型	当前模型名是否由本站网关支持

25.2 `claude: command not found`

检查：

bash

command -v claude
npm prefix -g
npm bin -g 2>/dev/null || true
claude --version

Windows PowerShell：

powershell

Get-Command claude -ErrorAction SilentlyContinue
npm prefix -g

常见原因：

安装失败。
npm 全局 bin 目录不在 PATH。
安装后没有重开终端。
多个 Node/npm 环境相互覆盖。
在 WSL 安装，却在 Windows PowerShell 中运行，或反过来。

25.3 401 或 403

优先检查：

Key 是否属于 Claude Code 产品线。
是否复制了多余空格或占位文字。
Key 是否被禁用、过期或余额不足。
ANTHROPIC_AUTH_TOKEN、ANTHROPIC_API_KEY 和官方 OAuth 是否存在冲突。
/status 当前使用哪种认证。
请求是否到达 https://code.jimuxyz.com/p。

不要通过反复重装 CLI 解决认证问题，也不要把真实 Key 粘贴到公开工单。

25.4 模型不可用

现象可能包括 model not found、unsupported model 或选择模型后请求失败。检查：

/model 当前选择。
ANTHROPIC_MODEL 是否被旧 shell 配置覆盖。
本站当前支持哪些模型。
模型是否属于当前套餐。
网关是否使用与官方不同的模型名称。

恢复到本站教程当前默认模型，再做最小请求，可以区分模型问题与安装问题。

25.5 VS Code 没有读取配置

完全退出所有 VS Code 窗口和后台进程。
从已经生效的终端运行 code .。
在 VS Code 内置终端只检查 Key 是否存在，不打印值。
运行 /status。
确认扩展版本和发布者。
仍异常时运行 claude doctor 和会话内 /doctor。

25.6 请求超时或连接失败

bash

curl -I https://code.jimuxyz.com/
curl -I https://code.jimuxyz.com/docs/cli

这些检查只证明网站 HTTP 入口可达，不证明 Key、模型和 API 请求一定正常。继续检查 DNS、证书、系统时间、代理、网关状态和最小 Claude 请求。

25.7 配置未生效

常见原因：

修改的是 .bashrc，实际 shell 是 zsh。
已打开的编辑器仍使用旧环境。
用户配置、项目配置和命令行参数存在优先级覆盖。
同时设置了官方 OAuth 和环境变量，实际使用的认证与预期不同。
在 Windows 用户环境变量写入后没有重启应用。

使用 /status、/config、/context、/doctor 和 claude doctor 查看实际生效状态，不要只检查文件内容。

26. 密钥、隐私与权限安全

26.1 不应写入项目的内容

API Key、Auth Token 和 OAuth Token。
账号密码、Cookie 和浏览器会话。
身份证、手机号、地址和客户隐私。
未脱敏的订单、医疗、财务和人事数据。
生产数据库备份。
私钥、证书私钥和云服务凭据。

26.2 第三方网关的数据边界

使用第三方模型网关意味着请求会经过该服务。发送代码、文档或客户数据前，应了解：

服务条款和隐私政策。
日志保存和脱敏方式。
数据是否用于训练或分析。
存储位置和保留时间。
账号、Key 和用量审计能力。
组织是否允许使用该服务。

不明确时，先使用脱敏样本，不发送敏感原件。

26.3 最小权限

新项目先用 Manual 或 Plan。
只添加任务需要的目录。
为自动化显式允许有限工具。
对 .env、私钥和生产配置设置 deny 规则。
只在隔离环境考虑跳过权限检查。
外部 MCP 使用最小 OAuth scope。
安装 Plugin 和 Hook 前阅读其代码。

设置示例：

json

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "permissions": {
    "allow": [
      "Bash(npm test *)",
      "Bash(npm run lint *)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)"
    ]
  }
}

具体权限语法以当前官方文档为准，设置后运行 claude doctor 并在练习目录测试。

27. 结果验收

27.1 四种证据

证据	适用任务	示例
内容证据	文章、报告、文案	与来源逐项核对，检查事实编号
结构证据	Markdown、DOCX、PPTX、XLSX、PDF	文件结构、页数、工作表和标题层级
视觉证据	PPT、Word、PDF、网页、图片	打开或渲染截图，检查溢出和重叠
行为证据	代码、脚本、自动化	测试、退出码、日志和真实操作

27.2 文档验收表

输出文件位于约定目录。
原始资料未被覆盖。
标题层级和目录正确。
日期、数字、引用和链接已回查。
事实、推断和建议已区分。
没有 Key、密码或隐私信息。
Word/PPT/Excel/PDF 已实际打开或渲染。
中文字体正常，没有乱码或方框。
表格、图片和代码块没有裁切。
失败、跳过和未验证项已记录。

27.3 代码验收表

已复现原问题。
修改范围符合任务边界。
聚焦测试通过。
受影响范围测试通过。
构建或类型检查通过。
Git 差异已阅读。
异常和权限路径已检查。
没有敏感信息或无关文件。
生产相关操作仍需人工批准时已说明。

27.4 交付记录模板

text

目标：
输出文件：
实际修改：
使用工具：
实际检查：
检查结果：
未验证项：
已知限制：
后续操作：

28. 成本、上下文与长期维护

28.1 减少无效上下文

只加载与任务有关的文件。
长流程放入 Skill，长期规则放入 CLAUDE.md。
不需要时禁用高上下文成本的 Plugin 或 MCP。
使用 Subagent 隔离高噪声调查。
长会话用 /context 检查，用 /compact 整理。
新任务用 /clear，不要让旧讨论持续干扰。

28.2 模型与成本

不同模型、provider 和套餐的价格、速度与质量不同。/cost、/usage 或本站用量页面提供的含义可能不同：

官方 API 可显示官方模型成本信息。
第三方网关最终计费由第三方服务规则决定。
模型选择器中的价格标签不一定等于第三方套餐实际扣费。
长上下文、并行 Subagents、反复生成大文件会增加消耗。

每次大任务先做小样本和提纲，通常比一次性生成全部内容更省成本。

28.3 定期维护

每月或版本升级后检查：

claude --version 和 claude doctor。
本站安装配置页是否更新。
旧 Key 是否需要轮换或删除。
CLAUDE.md 是否有过期规则。
Skills 和 Plugins 是否仍在维护。
Hooks 是否有高风险命令。
MCP OAuth 权限是否仍需要。
自动记忆是否保存了错误或敏感内容。
文档生成工具、字体和模板版本是否变化。
练习样本能否继续通过完整验收。

第七部分：可直接复用的模板与练习

29. 通用实施任务模板

text

任务目标：

背景与读者：

输入材料：
- 

允许读取：
- 

允许修改：
- 

禁止操作：
- 

输出文件：
- 

执行顺序：
1. 先盘点输入和现状；
2. 提交事实、风险和计划；
3. 等待确认；
4. 小范围实施；
5. 验证后完成全部范围；
6. 输出交付记录。

验收标准：
- 

遇到以下情况必须停止确认：
- 需要删除或覆盖原件；
- 需要访问未授权系统；
- 目标与现有规则冲突；
- 缺少完成任务的关键工具或凭据；
- 无法验证关键事实。

30. 只分析不修改模板

text

请只做调查和说明，不修改文件，不安装依赖，不启动或重启服务，不向外部系统写入数据。

请输出：
1. 当前结构；
2. 与问题相关的真实流程；
3. 证据和文件位置；
4. 根因候选及置信度；
5. 可行方案和取舍；
6. 推荐的下一步；
7. 仍需确认的信息。

31. 文章与教程模板

text

主题：
目标读者：
发布渠道：
读者现状：
希望读者完成的行动：
必须使用的材料：
必须包含的链接：
篇幅：
语气：
禁止表达：
输出：

请先输出事实表、标题备选和提纲。确认后写正文；写完后检查事实、重复、链接、标题层级和代码块。

32. 方案与报告模板

text

报告目的：
决策者：
核心问题：
时间范围：
数据来源：

必须区分：
- 已确认事实
- 计算结果
- 分析推断
- 建议
- 待确认

输出结构：摘要、背景、发现、方案比较、建议、计划、风险、指标和附录。
任何数字都标明来源；没有证据时保留待确认，不得补写。

33. PPT 任务模板

text

主题：
受众：
场合：
演讲时长：
页数：
希望促成的决定：
核心结论：
素材目录：
品牌素材：
输出文件：

阶段一：只提交故事线和逐页大纲。
阶段二：确认后生成 PPTX。
阶段三：渲染所有页面，检查溢出、重叠、字号、图表、图片和来源。
阶段四：修订并输出验收记录。

34. 办公文件模板

text

目标格式：DOCX / PPTX / XLSX / PDF
输入文件：
参考模板：
输出目录：
命名规则：
覆盖策略：禁止覆盖 / 备份后覆盖 / 跳过
字体与页面：
目录和页码：
表格或图表：
链接和引用：

先检查对应 Skill、生成工具、渲染工具和字体是否可用。缺少关键工具时停止并说明，不要只把文本改名为目标扩展名。
生成后必须做结构检查和视觉验收。

35. 故障排查模板

text

现象：
首次发生时间：
操作系统：
Claude Code 版本：
安装方式：
认证路线：官方账号 / 官方 API / code.jimuxyz.com / 云服务商
当前模型：
最少复现步骤：
完整错误信息（已脱敏）：
预期结果：
实际结果：
已经尝试：

请按程序、环境、认证、网络、模型五层排查。先给证据收集命令，不要直接重装或删除配置。任何命令不得输出完整 Key。

36. 七天练习计划

第 1 天：安装与状态

完成本站安装路线。
运行 claude --version 和 claude doctor。
学会 /help、/status、/model 和 /permissions。

第 2 天：任务表达

把三个模糊需求改写为包含目标、范围和验收的任务。
使用 Plan 模式阅读一个练习目录。
创建第一个 CLAUDE.md。

第 3 天：文章和资料整理

整理三份短资料。
生成事实表和提纲。
写一篇 Markdown 教程并检查链接和代码块。

第 4 天：方案和报告

比较两个方案。
区分事实、推断和建议。
生成管理摘要和风险表。

第 5 天：PPT 与办公文件

先做 8 页 PPT 大纲。
检查是否有可用 PPT Skill 和生成工具。
生成一个小样本并逐页渲染。

第 6 天：代码或自动化

阅读一个小项目或编写一个只读批处理脚本。
使用 claude -p 生成结构化输出。
检查权限和失败处理。

第 7 天：排错和复盘

模拟一个无效模型或错误配置，但不暴露 Key。
使用五层排查法定位。
整理自己的 CLAUDE.md、Skill 清单和验收清单。

附录 A：Claude Code 命令速查

A.1 终端命令

命令	用途
`claude`	启动交互会话
`claude "任务"`	带首条任务启动交互会话
`claude -p "任务"`	非交互执行并退出
`claude -c`	继续当前目录最近一次会话
`claude -r "会话"`	恢复指定会话
`claude --version`	查看版本
`claude --help`	查看本机 CLI 帮助
`claude doctor`	只读诊断安装和配置
`claude update`	更新原生安装版本；npm 路线按 npm 方式更新
`claude auth status`	查看官方认证状态
`claude auth login`	使用官方账号登录
`claude auth logout`	退出官方账号
`claude mcp --help`	查看 MCP 管理命令
`claude plugin --help`	查看 Plugin 管理命令

A.1.1 认证路线提醒

使用 code.jimuxyz.com 环境变量路线时，不要为了排错随意执行官方 /login 或 claude auth login，否则可能增加认证来源并造成混淆。先运行 /status 判断当前认证，再决定是否切换路线。

A.2 常用 CLI 参数

参数	用途
`-p`, `--print`	非交互输出
`-c`, `--continue`	继续最近会话
`-r`, `--resume`	恢复指定会话
`--model`	指定本次会话模型
`--permission-mode`	指定权限模式
`--allowedTools`	预先允许有限工具
`--add-dir`	增加可访问目录
`--output-format`	选择 text、json 或 stream-json
`--json-schema`	要求结构化输出符合 JSON Schema
`--append-system-prompt`	在默认系统提示后追加规则
`--settings`	加载指定设置文件或 JSON
`--mcp-config`	加载 MCP 配置
`--plugin-dir`	加载本地 Plugin
`--bare`	减少自动配置发现，适合可重复脚本

参数会随版本变化，使用前运行 claude --help。

附录 B：交互命令分类

B.1 状态、模型与权限

text

/help
/status
/model
/effort
/permissions
/config
/doctor
/sandbox

B.2 会话和上下文

text

/context
/compact
/clear
/resume
/rename
/branch
/rewind
/recap
/copy
/export
/exit

B.3 项目和修改

text

/init
/memory
/plan
/diff
/review
/code-review
/security-review
/run
/verify

B.4 扩展能力

text

/skills
/plugin
/reload-skills
/reload-plugins
/mcp
/hooks
/agents

B.5 诊断和使用情况

text

/debug
/doctor
/cost
/usage
/stats
/release-notes
/feedback

Claude Code 的命令数量很多，且部分命令是特定版本、平台、套餐、官方账号或环境专属。不要为了“命令完整”逐个尝试不理解的命令。日常掌握 /help、/status、/model、/permissions、/context、/compact、/clear、/diff、/doctor、/skills、/plugin 和 /mcp 已能覆盖大多数需求。

附录 C：`.claude` 目录速查

text

project/
├── CLAUDE.md
├── CLAUDE.local.md
├── .mcp.json
└── .claude/
    ├── CLAUDE.md
    ├── settings.json
    ├── settings.local.json
    ├── rules/
    ├── skills/
    │   └── example/
    │       ├── SKILL.md
    │       ├── scripts/
    │       ├── references/
    │       └── assets/
    └── agents/

用户级常见位置：

text

~/.claude/
├── CLAUDE.md
├── settings.json
├── skills/
├── agents/
└── ...

其他状态可能保存在 ~/.claude.json。不要手工修改不理解的状态字段，也不要把整个 .claude 用户目录上传到公开仓库。

附录 D：安装配置检查卡

D.1 安装前

已确认系统版本和架构。
已安装 Node.js 22+ 和 npm。
Windows 已根据需要安装 Git for Windows。
已在本站创建 Claude Code 产品线 Key。
已确认不会混用 Codex/Gemini Key。
已备份重要 shell 和 Claude 配置。

D.2 安装中

只使用一个系统对应的安装入口。
按环境检测、CLI 安装、本站配置顺序执行。
Key 占位符已替换，且未出现在截图或日志中。
任一步报错后已停止处理。

D.3 安装后

已完全重启终端和编辑器。
claude --version 正常。
claude doctor 无阻断错误。
/status 显示预期认证和 API 地址。
/model 使用本站支持的模型。
低风险读取和写入练习通过。
未泄露 Key。

附录 E：推荐资源

E.1 积木 AI 配置入口

安装与配置总入口：https://code.jimuxyz.com/docs/cli#config
Windows Claude Code：https://code.jimuxyz.com/dashboard/claudecode-installation/windows-copy
macOS/Linux Claude Code：https://code.jimuxyz.com/dashboard/claudecode-installation/macos-linux-copy
Key 管理：https://code.jimuxyz.com/keys

以上属于第三方服务页面。Key、套餐、模型、费用和网络说明以页面实时内容为准。

E.2 Anthropic 官方文档

Claude Code 概览：https://code.claude.com/docs/en/overview
安装：https://code.claude.com/docs/en/setup
CLI 参考：https://code.claude.com/docs/en/cli-reference
命令参考：https://code.claude.com/docs/en/commands
权限模式：https://code.claude.com/docs/en/permission-modes
模型配置：https://code.claude.com/docs/en/model-config
项目记忆与 CLAUDE.md：https://code.claude.com/docs/en/memory
Skills：https://code.claude.com/docs/en/skills
Plugins：https://code.claude.com/docs/en/discover-plugins
MCP：https://code.claude.com/docs/en/mcp
Subagents：https://code.claude.com/docs/en/sub-agents
Hooks：https://code.claude.com/docs/en/hooks-guide
VS Code：https://code.claude.com/docs/en/ide-integrations
Desktop：https://code.claude.com/docs/en/desktop
Web：https://code.claude.com/docs/en/claude-code-on-the-web
认证：https://code.claude.com/docs/en/authentication
最佳实践：https://code.claude.com/docs/en/best-practices

附录 F：服务与资料边界

本手册不包含 Claude 官方账号、订阅、API Key、第三方 Key 或充值凭据。
code.jimuxyz.com 是第三方安装配置与模型服务入口，不是 Anthropic 官方网站。
本站 Claude Code Key 不能与 Codex 或 Gemini Key 混用。
本站 CLI 配置不自动等于 Claude Desktop、Claude.ai 和 Claude Code Web 的官方登录权益。
第三方网关的价格、模型、网络和数据规则以其实时页面为准。
Anthropic 官方功能、套餐、支持地区和网络要求以官方文档为准。
Skills、Plugins、MCP 和 Hooks 可能来自第三方，安装者需要独立审查来源、权限、脚本和数据流向。
Word、PPT、Excel 和 PDF 文件生成需要对应工具；文字回答或文件扩展名不等于有效办公文件。
所有生成内容都需要人工核对，重要发布、生产变更和外部操作保留人工审批。

结束语

Claude Code 的价值不只在于生成代码，而在于把读取材料、制定计划、调用工具、创建内容和验证结果组织成一条可审查的工作流。对于编程任务，完成标准是测试、构建和真实行为；对于文章、方案和报告，完成标准是事实、结构和可追溯性；对于 PPT、Word、Excel 和 PDF，完成标准还包括文件结构与视觉渲染。

第一次使用时，从 code.jimuxyz.com 的 Claude Code 配置入口开始，创建正确产品线的 Key，按操作系统完成安装，再在练习目录掌握 /status、/model、/permissions 和 /help。随后根据任务逐步增加 CLAUDE.md、Skills、Plugins、MCP、Subagents 和 Hooks，不需要一次安装所有扩展。

长期稳定使用的原则只有几条：先读后改，先小样本后全量，事实与推断分开，权限保持最小，第三方服务边界写清，生成文件必须打开或渲染，最终结论必须有证据。

Claude Code 综合学习与安装配置手册

配套资料与快速开始

一、先认识两套服务

二、一键配置脚本与命令

三、推荐使用顺序

四、十分钟快速验收

内容摘要

阅读说明

全书结构

第一部分：认识 Claude Code 与完成首次运行

1. Claude Code 是什么

1.1 Claude Code 能做什么

1.2 Claude Code 不应替你决定什么

2. 选择适合自己的使用入口

2.1 CLI：本手册的主线

2.2 VS Code 扩展

2.3 Claude Desktop

2.4 Claude Code Web

2.5 为非编程任务准备工作目录

3. 按 code.jimuxyz.com 安装和配置

3.1 安装前准备

准备一：确认系统要求

准备二：安装 Node.js 22 或更高版本

准备三：Windows 安装 Git for Windows

准备四：创建正确的 Key

3.2 Windows 安装

3.3 macOS/Linux 安装

3.4 本站脚本会写入什么

3.5 验证安装与本站配置

3.6 官方安装路线与本站路线的关系

3.7 更新、重装和卸载

4. 首次使用、模型与权限

4.1 在正确目录启动

4.2 /model 是什么

4.3 权限模式

4.4 第一个真实任务

第二部分：把任务、上下文和规则说清楚

5. 一个可靠任务的六个组成部分

6. 上下文整理方法

6.1 最小充分上下文

6.2 使用 @ 引用文件

6.3 长任务交接模板

7. 使用 CLAUDE.md 固化规则

7.1 常见位置

7.2 已有 AGENTS.md 时怎么做

7.3 /init、/memory 和自动记忆

8. 会话与上下文管理

8.1 常用命令

8.2 什么时候新开会话

8.3 恢复会话

9. 常用交互命令

9.1 命令与普通提示词的区别

9.2 推荐掌握的命令

第三部分：扩展 Claude Code 的能力

10. 六种扩展机制如何选择

11. Skills：把重复方法变成可复用能力

11.1 Skill 的位置

11.2 最小 Skill 示例

11.3 Skill 不是软件安装包

11.4 内置 Skills

12. Plugins：安装成套扩展

13. MCP、Subagents 与 Hooks

13.1 MCP：连接外部系统

13.2 Subagents：隔离和并行任务

13.3 Hooks：确定性自动化

13.4 一个办公扩展组合示例

第四部分：与代码项目协作

14. 进入陌生项目的阅读顺序

15. 先探索、再计划、再修改

16. 修改和验证闭环

16.1 修改前

16.2 修改中

16.3 修改后

17. 代码审查和安全检查

第五部分：文章、方案、PPT、报告与日常办公

18. 内容创作的完整工作流

18.1 建议目录

18.2 建立事实表

19. 文章、教程和产品文案

19.1 文章写作

3. 按 `code.jimuxyz.com` 安装和配置

4.2 `/model` 是什么

6.2 使用 `@` 引用文件

7. 使用 `CLAUDE.md` 固化规则

7.2 已有 `AGENTS.md` 时怎么做

7.3 `/init`、`/memory` 和自动记忆

24.2 `claude -p`

25.2 `claude: command not found`