一、先分清四个入口#

Claude Code 既是终端程序，也是一个会调用工具完成任务的 Agent。使用者面对的是四类入口，它们解决的问题不同：

最容易混淆的是前三类。claude --model sonnet 是启动参数，/model 是会话内命令，model 配置则可以写入设置文件。它们可能控制同一能力，但生效时机和适用场景不同。

还要分清“命令”和“工具”。/compact 是使用者操作会话的命令；Read、Edit、Bash 是 Claude 在任务循环中调用的工具。正常使用时不需要逐个指挥工具，应该描述目标、约束和验收条件，让 Claude 选择操作路径。

二、完成第一次任务#

1
cd /path/to/project
2
claude

1
先不要修改文件。请说明这个项目的技术栈、主要目录、测试入口，以及完成修改前必须遵守的仓库规则。

1
修复登录接口在请求超时时重复提交的问题。
2

3
范围：只修改认证模块及相关测试，不调整公共 HTTP 客户端。
4
验收：先说明根因和方案，再实现；运行认证模块测试和类型检查；最后列出改动文件与剩余风险。

三、最值得记住的 CLI 用法#

1
# 启动交互会话
2
claude
3

4
# 执行一次查询并退出，适合脚本和 CI
5
claude -p "解释这个项目的测试结构"
6

7
# 继续当前目录最近的会话
8
claude -c
9

10
# 按名称或 ID 恢复指定会话
11
claude -r "auth-refactor"

1
claude -p --output-format json \
2
  --json-schema '{"type":"object","properties":{"summary":{"type":"string"},"risk":{"type":"string"}},"required":["summary","risk"]}' \
3
  "审查当前变更，概括改动并判断风险"

四、权限模式不是同一档位的“放权”#

Claude Code 的权限同时受工作目录、规则和模式影响。当前常见模式可以这样理解：

dontAsk 不是“不问直接执行”，而是“不问直接拒绝未批准操作”。这是自动化场景中非常关键的区别。

bypassPermissions 也不等于沙箱。它跳过的是 Claude Code 的权限确认，并不会自动移除密钥、限制网络或创建一次性文件系统。若必须使用，应先在容器或虚拟机层面隔离数据、凭据和网络。

可以通过 /permissions 查看规则来源。权限规则遵循“拒绝、询问、允许”的匹配顺序，拒绝规则优先。团队共享规则放入 .claude/settings.json，个人机器上的例外放入 .claude/settings.local.json，不要把个人路径和凭据提交到仓库。

五、运行中只需要掌握这些命令#

命令是否可见会受版本、平台、套餐和扩展影响。与其背完整列表，不如按任务阶段记住入口。

六、哪些文件应该手动维护#

无需理解 Claude Code 的全部本地存储。对日常使用有价值的是公开配置入口：

会话记录、检查点、缓存和自动记忆由 Claude Code 管理，路径和格式可能变化。它们适合排障和迁移，不宜成为业务脚本依赖的稳定接口。

下面这个配置片段用于展示最小权限规则，重点看允许与拒绝的边界：

1
{
2
  "permissions": {
3
    "allow": [
4
      "Bash(git status)",
5
      "Bash(git diff *)"
6
    ],
7
    "deny": [
8
      "Read(./.env)",
9
      "Bash(curl *)"
10
    ]
11
  }
12
}

这组规则只预批准查看 Git 状态和差异，同时阻止读取 .env 与直接发起 curl 请求。真实项目应从任务所需的最小范围开始，而不是先写一个 Bash(*) 再补漏洞。

七、扩展能力的边界#

Claude Code 的扩展方式很多，但它们并不是同一类东西：

Skill 不会凭空获得系统权限，它只是给现有工具补充做事方法。MCP 才会增加外部工具能力，因此需要单独审查服务器来源、权限和输出。插件是包装与分发形式，安装插件等于同时信任它包含的多个组件，不能因为来自 marketplace 就跳过审查。

Channel 也不是普通 MCP 工具。它通过 MCP 服务器把外部事件推入活跃会话，适合长时间运行和事件驱动场景，目前仍属于研究预览能力。入门阶段通常不需要配置。

八、子 Agent、任务和并行能力怎么选#

Claude Code 有多种并行方式，选择依据不是“越多越快”，而是上下文是否需要隔离、工作是否需要协调：

Task 工具和 /tasks 主要用于跟踪进度、依赖和后台工作，不等于新的执行者。具体任务工具是否提供，可能受模型、提供商和会话配置影响，不应把内部工具名写进长期工作流；面向使用者时优先通过自然语言拆任务，并用 /tasks 查看状态。

九、一条可复用的上手路径#

第一次接入新仓库，可以按以下顺序执行：

1. 从仓库根目录启动，先要求只读探索。
2. 检查 CLAUDE.md 和仓库原有规则，缺失时用 /init 生成初稿并人工精简。
3. 在任务描述中写清目标、范围、验收命令和禁止事项。
4. 大改动先 /plan，小改动直接执行；只在任务可独立拆分时使用子 Agent。
5. 权限从最小范围开始，dontAsk 用于失败关闭，bypassPermissions 只用于外部隔离环境。
6. 阶段切换时查看 /context，必要时 /compact，不要让关键约束只存在于聊天历史。
7. 收尾时查看 /diff、运行验证、说明未验证项，再由人决定提交和发布。

Claude Code 的入门门槛不在命令数量，而在边界意识。能说清任务、限制权限、观察差异并验证结果，已经覆盖了日常使用中最重要的部分。

参考资料#

• Claude Code CLI 参考 - 启动方式、子命令与参数
• Claude Code 命令参考 - 会话内命令及可用性说明
• Claude Code 权限配置 - 权限规则、模式与目录边界
• Claude Code 扩展能力概览 - Skill、子 Agent、Hook、MCP 与插件的选择
• Claude Code 并行 Agent - 子 Agent、Agent View、Agent Teams 与 Workflow
• Claude Code MCP 文档 - 外部工具接入、作用域和安全注意事项