Claude Code 中文入门：安装、CLAUDE.md、skills、hooks 与权限，看不懂代码也能上手

Claude Code 是 Anthropic 的 AI 编程助手，在你的电脑或服务器上读文件、改文件、运行命令。Jason Finance 的代码、部署和数据更新都是它做的，我自己看不懂代码。这篇 Claude Code 教程用中文整理了看不懂代码的人真正用得上的部分：安装、第一个小时、主要功能各有什么用，以及我踩过或官方特别提醒的坑。

先说结论：Claude Code 需要付费套餐（Pro、Max、Team、Enterprise 或 Console），免费套餐不能用。装好后最值得先花时间的是 CLAUDE.md 和权限设置，命令用到再学。你负责说清楚要什么、看结果、做决定，命令交给它运行。

本文是我自己的使用整理，不是官方教程。功能、命令和支持的套餐都会变动，下文的官方文档于 2026 年 10 月 12 日核对，操作前请以 Claude Code 官方文档为准。

开始前：套餐、电脑和网络

项目	官方要求（2026 年 10 月 12 日核对）
账户	Pro、Max、Team、Enterprise 或 Console；免费 claude.ai 套餐不含 Claude Code；也可用 Amazon Bedrock、Google Cloud、Microsoft Foundry
操作系统	macOS 13.0 以上、Windows 10 1809 以上或 Windows Server 2019 以上、Ubuntu 20.04 以上、Debian 10 以上、Alpine Linux 3.19 以上
硬件	4 GB 以上内存，x64 或 ARM64 处理器
网络	需要联网
Shell	Bash、Zsh、PowerShell 或 CMD
地区	Anthropic 支持的国家和地区

资料来源：Advanced setup。

我的 Claude Code 运行在一台 Oracle Cloud 的 ARM 服务器上，ARM64 可以正常使用，搭建过程见〈Oracle Cloud 免费主机运行 Claude Code Remote Control〉。第一次用的话，装在自己的电脑上就可以。

安装 Claude Code：三种方式任选其一

如果完全没打开过终端，官方有一份 terminal guide，教你怎么打开、怎么粘贴命令。不想碰终端的话，也可以下载 Desktop 桌面版，用图形界面使用 Claude Code。

原生安装（官方推荐）

macOS、Linux、WSL：

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell（提示符是 PS C:\）：

irm https://claude.ai/install.ps1 | iex

Windows CMD（提示符是 C:\，前面没有 PS）：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Windows 不需要以管理员身份运行。原生安装会在后台自动更新。

其他方式

方式	命令	要注意的事
Homebrew（macOS）	`brew install --cask claude-code`	不会自动更新，要自己 `brew upgrade claude-code`
WinGet（Windows）	`winget install Anthropic.ClaudeCode`	不会自动更新，要自己 `winget upgrade Anthropic.ClaudeCode`
apt、dnf、apk（Linux）	按官方步骤添加签名过的软件源	跟随系统更新，不会自己更新
npm	`npm install -g @anthropic-ai/claude-code`	需要 Node.js 22 以上；官方提醒不要用 `sudo npm install -g`

确认装好、登录

打开一个新的终端窗口：

claude --version   # 打印出版本号就是装好了
claude doctor      # 检查安装与配置，不会开始对话

出现 command not found 多半是安装路径还没加进 PATH，按官方排错页处理。接着到你的项目文件夹运行 claude，第一次会打开浏览器登录。

如果环境里设置了 ANTHROPIC_API_KEY，并且你在询问时同意使用它，Claude Code 会跳过登录，改用这个密钥。如果要用 Remote Control 从手机连回来，要注意：它只支持 claude.ai 订阅登录，不支持 API key。

第一个小时：按顺序做这几件事

在项目文件夹里启动：先 cd 到项目再运行 claude。官方提到，直接在主目录启动时，“信任这个文件夹”的选择不会被记住，每次都会再问。
看一下当前的权限模式：界面下方的状态栏会显示 auto mode on、manual mode on 等字样，按 Shift+Tab 可以切换，下面会说明区别。
运行 /init：Claude 会读整个项目，生成一份初版 CLAUDE.md。
把 CLAUDE.md 改成你的规则：加上它从代码里看不出来的事，例如“用繁体中文跟我沟通”“发布前先问我”。
运行 /context：确认 CLAUDE.md 有被读到（列在 Memory files 下面），也能看到对话已经用掉多少空间。
交代一件小事：例如“这个项目是做什么的？用大白话跟我说”。先只读不改，看它理解得对不对。
让它改一个小地方：看它怎么询问权限、改了什么，改完请它说明。
用 Git 留记录：确认项目在 Git 里，改坏了可以还原。/rewind 也能把对话和代码回退到之前的状态。
设好不能碰的东西：在 .claude/settings.json 禁止读取 .env 这类存放密码的文件（示例在下一节）。
输入 / 看命令列表：知道 /help、/usage 在哪里就够了，其他用到再查。

Claude Code 教程：主要功能，看不懂代码的人怎么用

功能	是什么	看不懂代码的人拿来做什么
CLAUDE.md	每次开工都会读到的项目说明	写下沟通语言、哪些事要先问你、网站的固定规则
Auto memory	Claude 自己记的笔记	你纠正过的事，下次不用再讲
Skills	一份 `SKILL.md` 写好的固定流程	每次都一样的工作：润色、发文前检查、生成报告
Hooks	在特定时间点一定会执行的命令	等你回复时发通知、拦下对重要文件的修改
权限模式	决定哪些操作要先问你	按工作的风险，选择要被问多少次
settings.json	配置文件，含允许、询问、禁止规则	把“不准读密码文件”这类规则写死
MCP	连接外部工具的标准	让 Claude 直接查 Notion、数据库或监控数据
斜杠命令	输入以 `/` 开头的命令	看用量、压缩对话、切换模型
Remote Control	从手机或网页接手电脑上的 session	人不在电脑前也能交代工作、看进度

CLAUDE.md：写给 Claude 的工作守则

官方记忆文档列出了几个位置：项目的 ./CLAUDE.md（或 ./.claude/CLAUDE.md）会随 Git 分享给团队；~/.claude/CLAUDE.md 适用于你所有的项目；./CLAUDE.local.md 只给自己看，要加进 .gitignore。

几个要点：

建议每份控制在 200 行以内，太长会占用对话空间，也更不容易被遵守。
可以用 @文件路径 导入其他文档，但导入的内容同样在开工时加载，不会节省空间。
CLAUDE.md 是背景信息，不是强制配置。官方写明，无论 Claude 怎么判断都必须拦下的操作，要用 PreToolUse hook。
用 /memory 可以打开、编辑这些文件，也能开关 auto memory。auto memory 存在 ~/.claude/projects/<项目>/memory/，每次开工加载 MEMORY.md 的前 200 行或前 25KB。

一个多语言网站的 CLAUDE.md 实际要写哪些规则、怎么分段，我另外写在〈CLAUDE.md 示例：多语言网站〉。

Skills：把固定流程做成一个命令

Skill 是一个文件夹，里面一定要有 SKILL.md：开头的 description 告诉 Claude 什么时候该用，正文写步骤。放在 ~/.claude/skills/<名称>/ 就是你所有项目都能用，放在项目的 .claude/skills/<名称>/ 则随 repo 分享。

用法有两种：Claude 判断 description 符合你的需求时自动加载，或者你输入 /名称 直接调用。会产生影响的流程（例如部署）可以在 frontmatter 设置 disable-model-invocation: true，只有你下命令才会执行。官方也说明，旧的自定义命令（.claude/commands/）已经并入 skills，原来的文件照样能用。

和 CLAUDE.md 不同，skill 的正文只在用到时才加载，长篇说明放在 skill 里比较不占空间。

Hooks：一定会发生的事

Hooks 是你自己定义的命令，Claude Code 在特定时间点执行，不靠 AI 判断要不要做。常用的时间点：

事件	什么时候	例子
`Notification`	Claude 等你回复或批准时	弹出桌面通知
`PreToolUse`	工具执行前，可以拦下	禁止修改 `.env`、`.git/`
`PostToolUse`	工具执行成功后	改完文件自动格式化
`SessionStart`	session 开始或恢复时	加载当天要知道的信息
`Stop`	Claude 回复结束时	提醒、记录

配置写在 settings.json 的 hooks 区块，输入 /hooks 可以查看。官方示例用一个脚本检查要修改的路径，如果匹配 .env、package-lock.json、.git/，就以退出码 2 拦下，Claude 会收到被拦的原因。看不懂脚本也没关系，可以请 Claude 按官方示例写，再请它演示一次被拦下的情况。

权限模式：决定 Claude 要问你多少次

根据官方说明：

模式	不用问就能做的事	适合
`default`（界面显示 Manual）	只有读取	敏感的工作、想逐一确认
`acceptEdits`	读取、改文件、常见的文件命令（`mkdir`、`mv`、`cp` 等）	你会查看修改内容的时候
`plan`	读取，先写计划给你批准再动手	改东西前先看它打算怎么做
`auto`	全部，由另一个模型在后台审查	长时间工作、不想一直被问
`dontAsk`	事先允许的工具，其他一律拒绝	自动化脚本
`bypassPermissions`	全部，不检查	只适合隔离的容器或虚拟机

要知道两件事：

新版默认是 auto 模式：Claude Code v2.1.283 以后，终端和 VS Code 的交互式 session 默认从 auto 开始。旧版只有 Pro、Max、Team 套餐默认 auto，其他是 Manual。官方也提醒，auto 模式减少询问，但不保证安全，敏感操作仍要自己看。
按 Shift+Tab 循环切换；想固定从 Manual 开始，在 ~/.claude/settings.json 设置 "permissions": {"defaultMode": "default"}。

settings.json：把规则写死

配置文件有几层，优先级从高到低：组织的 managed settings、命令行参数、.claude/settings.local.json（自己、这个项目）、.claude/settings.json（整个项目共用）、~/.claude/settings.json（自己、所有项目）。

最实用的是权限规则。官方示例：

{
  "permissions": {
    "allow": ["Bash(npm run lint)", "Bash(npm run test *)"],
    "deny": ["Read(./.env)", "Read(./.env.*)"]
  }
}

deny 规则在每一种模式下都有效，连 bypassPermissions 也拦得住。你在权限询问时选“Yes, and don’t ask again”，Claude Code 会自动把规则写进 .claude/settings.local.json。定期用 /permissions 看一下积累了哪些允许规则。

MCP：让 Claude 连接其他工具

MCP 是连接外部系统的开放标准。连上之后，Claude 可以直接查 issue、数据库或监控数据，不用你复制粘贴。用 claude mcp add 添加，用 /mcp 查看状态和登录。

官方提醒：连接前要确认信任这个 server，会抓取外部内容的 server 有 prompt injection（藏在内容里的恶意指令）的风险；Anthropic 不负责审核 MCP server 的安全性。我的建议是先只接官方或自己用的服务。

斜杠命令：先记这几个

命令	作用
`/help`	说明与命令列表
`/init`	生成 CLAUDE.md
`/memory`	编辑 CLAUDE.md、开关 auto memory
`/context`	看对话空间用了多少
`/compact`	把当前对话压缩成摘要
`/clear`	开新对话，清空内容
`/rewind`	把对话或代码回退到之前（别名 `/undo`）
`/permissions`	管理允许、询问、禁止规则
`/usage`	看费用与套餐用量（`/cost` 是别名）
`/remote-control`	让这个 session 可以从手机或网页接手（别名 `/rc`）

说明以官方命令列表为准。

Remote Control：人不在电脑前也能交代工作

Remote Control 让你用 claude.ai/code 或 Claude 手机 App 接手电脑上正在运行的 Claude Code。代码的执行和文件都留在原来那台机器上。支持 Pro、Max、Team、Enterprise，不支持 API key；Team 和 Enterprise 要先由 Owner 在管理设置中开启。

开启方式是在 session 里输入 /remote-control，或者运行 claude remote-control。想让它在一台服务器上长期待命，可以参考我用 systemd 做成常驻服务的方法：〈Oracle Cloud 免费主机运行 Claude Code Remote Control〉。

新手最常卡住的三件事

权限询问：看懂再按，不要一路按 Yes

Manual 模式下，Claude 改文件、运行命令、联网前都会问你。看不懂命令也可以问它：“这个命令会做什么？会删掉东西吗？”官方写明，批准前检查建议的代码和命令是用户的责任。

我的做法（个人推断，不是官方建议）：常见又不会造成损害的命令（跑测试、看状态）选“不再询问”；删除、推送、改生产配置的命令每次都看。如果觉得被问太多次很烦，就改用 auto 模式，再用 deny 规则和 hooks 守住真正不能碰的东西。

对话太长：会自动压缩，只在对话里讲的规则可能丢失

对话接近上限时，Claude Code 会自动压缩成摘要，完整的工具输出和中间过程会消失。压缩后，项目根目录的 CLAUDE.md 和 auto memory 会从文件重新加载，最近改过的文件最多重读 5 个。

实际上的意思是：

要一直遵守的规则写进 CLAUDE.md，不要只在对话里讲一次。
一件事做完、要换主题时，用 /clear 开新对话。
开始长任务前可以先 /compact 重点放在 XX，指定摘要要保留什么。
用 /context 看还剩多少空间。

密钥和密码：不贴在对话里，也不放进 Git

不要把 API 密钥、数据库密码、私钥贴进对话。 需要时让服务自己的登录流程处理，或者存在只有你能看到的配置文件里。
存放密码的文件（.env 等）加进 .gitignore，再用 deny 规则禁止 Claude 读取。
官方说明，登录凭证在 macOS 存在钥匙串，在 Linux 存在权限为 0600 的文件里。
截图发给 Claude 或贴到网上之前，遮掉 IP、账号、token。

我实际怎么用：Git、预览、按影响决定要不要问我

Jason Finance 从第一个 commit 开始就是 Claude Code 在写。几个做法供参考：

Claude Code 住在服务器上：一台 Oracle Cloud 的 ARM 服务器，Remote Control 做成 systemd 服务，SSH 断开后继续运行。我用手机上的 Claude App 连过去，用中文交代工作。
Git 就是内容管理系统：文章是 Markdown 文件，push 到 main 分支就自动部署。草稿先推到 preview 分支，生成包含草稿的预览网址，我看过之后才发布。
按影响决定要不要问我：写在 CLAUDE.md 里。读文件、测试、普通的 commit 直接做；发布我没看过的内容、改生产配置要我决定；删数据要在开工前说明一次范围和风险。细节在〈看不懂代码也能建网站〉。
规则写成测试，而不只是写在 CLAUDE.md 里：例如每篇文章一定要属于一个主题、描述不能超过 160 字，不符合就构建失败。CLAUDE.md 是背景信息，可能被忽略，测试和 hooks 才拦得住。

整个网站是怎么搭起来的，见〈Jason Finance 从零到一〉。更多文章在 AI 创业主题页。

常见问题

Claude Code 要付费吗？免费套餐可以用吗？

根据官方安装说明，Claude Code 需要 Pro、Max、Team、Enterprise 或 Console 账户，免费的 claude.ai 套餐不包含 Claude Code。也可以通过 Amazon Bedrock、Google Cloud 或 Microsoft Foundry 等第三方平台使用。

Claude Code 怎么安装？Windows 可以用吗？

官方推荐原生安装：macOS、Linux、WSL 在终端运行官方安装脚本，Windows 在 PowerShell 或 CMD 运行对应命令，不需要管理员权限。也可以用 Homebrew、WinGet 或 Linux 包管理器安装，或者改用 Desktop 桌面版。装好后运行 claude --version 确认。