【2026持续更新】OpenClaw + OpenCode/Claude + CoWork + 源码讲解百万字教程

😊你好,我是小航,一个正在变秃、变强的文艺倾年。

🔔本文讲解【2026持续更新】OpenClaw + OpenCode/Claude + 高阶玩法 + 源码讲解百万字教程,期待与你一同探索、学习、进步,一起卷起来叭!

目录

一、Claude Code

初始化

安装

Claude Code 是 Anthropic 官方基于 Claude 大模型打造的原生 AI 编程工具,专为开发者设计,深度融入本地开发流程,实现从需求描述、代码编写、调试重构、版本控制到项目部署的全流程 AI 辅助。

从能力的角度来看,核心特征有三个:

  • 上下文感知:不仅理解单个文件,而是理解整个项目结构。
  • 工程化导向:关注可维护性、规范、测试,而不是一次性代码。
  • 可定制行为:通过 Skills(技能包)让 AI 遵守你的规则。

官网:https://claude.com/product/claude-code

现在 Claude Code 提供了更简单的一键安装方式,不需要安装 Node.js,直接终端打开输入即可安装:

Mac 用户:

shell 复制代码
curl -fsSL https://claude.ai/install.sh | bash

Win用户:「以管理员身份运行」,安装过程会自动下载,等个 1-2 分钟就好。

shell 复制代码
irm https://claude.ai/install.ps1 | iex

安装完成的标志:会提示「Claude Code installed successfully」。

使用方式:

使用方式 适合人群 核心优点 局限性
Web 端 完全新手 无需安装,浏览器打开 claude.ai 即可使用 功能相对有限,无法访问本地开发环境
CLI 命令行 全阶段开发者 功能完整、集成度高、适配所有开发场景 需要基础的命令行使用能力
桌面端/编辑器集成 日常开发从业者 无缝融入工作流,一键唤起不打断开发节奏 依赖客户端/插件环境配置

CC Switch

CC Switch 的核心价值在于:无需手动修改各 CLI 工具的配置文件,只需在图形界面中点击切换,即可将 Claude Code、Codex、OpenCode、Gemini CLI 的 API 请求路由到不同的 Provider(官方、第三方中转、自建服务等)。

主要的功能:

功能 说明
Provider 管理 添加、编辑、切换、删除 API Provider,支持预设模板
本地 API 代理 内置高性能本地 HTTP 代理,自动接管 CLI 配置
Auto Failover 自动检测 Provider 故障并切换到备用节点
MCP 服务管理 统一管理 Claude/Codex/Gemini 的 MCP 服务器
Skills 管理 安装/卸载/同步社区 Skills 扩展
多语言支持 中文 / English / 日本語
请求日志 记录代理请求与使用统计,方便调试和成本追踪

Github:https://github.com/farion1231/cc-switch

配置模型(国内推荐 GLM模型,购买 Coding Plan 计划):

点击左上角"设置"按钮,在通用页面下拉找到 跳过 Claude Code初次安装确认 ,务必勾选。

在终端运行 claude,看到对话界面并能正常回复即表示配置完成。

VScode配置

安装 vs code:https://code.visualstudio.com

安装插件:https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code

或者在 vs code 插件市场搜索「Claude code」,即可安装。

为什么推荐使用Vscode插件开发?

我们可以选中文件中的代码,让 Claude Code 帮我们解析说明或修改,选中后,会提示已经选中的代码行数。

当 Claude 需要修改文件时,它会自动打开并排对比视图,左边显示文件原始内容,右边显示建议修改后的内容,然后询问您是否同意修改。

如果需要的话,可以开启 Claude code 全自动模式

默认状态下,Claude code 只能在 plan、手动确认、自动编辑三种模式选择,可以在 cc 插件里开启「Allow Dangerously Skip Permissions」,这样能开启全自动模式,cc 能自动运行命令,无需二次确认。下面的选项里,也可以把全自动模式配置为默认模式。

权限模式:

  • 正常模式(默认):Claude 每次要操作前都会先问你同不同意。
  • Plan Mode(计划模式):Claude 先告诉你它打算怎么做,得到你批准后才动手修改。
  • 自动接受模式:Claude 直接编辑,不再每次询问。

注意:Shift + Tab 也可以进行切换。


命令菜单:在提示框里输入 /(或点击输入框)就能打开命令菜单。

常用选项包括:附加文件、切换模型、开启扩展思考、查看使用量(输入 /usage)

多行输入:按 Shift + Enter 可以换行。
上下文用量指示器:提示框下方会实时显示你已经用了多少 Claude 的上下文窗口(context)。Claude 会自动帮你压缩内容;如果你想手动压缩,输入 /compact 即可。
引用文件和文件夹

直接用 @ 提到文件或文件夹就行。支持模糊匹配,不用打全名。

小技巧:

  • 选中代码时:直接在编辑器里选中一段代码,Claude 会自动看到你选中的部分。提示框下方会显示"已选中 XX 行"。
  • 快速插入:按 Option + K(Mac)或 Alt + K(Windows/Linux),就能插入带文件路径和行号的 @ 提及,例如 @app.ts#5-10。
  • 隐藏选中内容:点击提示框底部的"选择指示器"(眼睛图标),斜杠眼睛表示 Claude 看不到你选中的文本。
  • 拖拽附件:把文件拖到提示框时按住 Shift,可以作为附件添加。想删除附件?点击附件右上角的 × 即可。
  • PDF 大文件专属:你可以指定让 Claude 只读某几页,例如"第 1-10 页"或"从第 3 页开始"。

恢复过去的对话

点击 Claude Code 面板顶部的下拉菜单,就能看到你的所有聊天历史记录。支持关键字搜索,也能按时间筛选(今天、昨天、过去 7 天等)。鼠标悬停在某条记录上,会出现 重命名 和 删除 按钮:

  • 重命名:给对话起个好记的标题
  • 删除:把这条记录从列表里移除

工作流程

当你给 Claude 一个任务时,它会像人类一样循环思考三个步骤:

  1. 收集上下文(看你的代码、文件、错误信息)
  2. 采取行动(编辑文件、运行命令、搜索等)
  3. 验证结果(检查是否成功,哪里还需要调整)

这三个步骤会不断循环,直到任务完成,当然我们也可以随时可以打断它、给新指示,或者说"换个方法试试"。

配置

命令行命令

  • /clear:清除对话历史
  • /help:显示可用命令
  • /login:登录或切换账号
  • /resume:恢复之前的对话
  • /exit or Ctrl+C:退出 Claude Code
  • /model:切换模型

会话:

  • 直接恢复会话:claude --continue
  • 分叉会话:claude --continue --fork-session

上下文窗口:

Claude 有上下文容量限制。当快满时,它会自动压缩旧内容。

  • /compact:手动压缩
  • /context:查看当前占用情况

技巧:

  • 重要规则写进 CLAUDE.md
  • 用 skills 和 subagents 减少不必要的上下文占用

安全机制:

  • 检查点(随时后悔):Claude 修改文件前会自动备份。只要按两次 Esc,或说"撤销刚才的修改",就能回到之前状态。
  • 权限模式:按 Shift + Tab 快速切换。

项目初始化:/init,Claude 会自动扫描你的代码库,然后生成一份专属于你项目的 CLAUDE.md 文件。

CLAUDE.md 文件:CLAUDE.md 是一个放在项目根目录的 Markdown 文件,Claude Code 在每次会话开始时都会自动读取,不再需要重复解释基本信息。

一份好的 CLAUDE.md 应该覆盖三个维度:

  • WHAT(是什么):技术栈、项目结构,为 Claude 提供代码库的全局地图
  • WHY(为什么):项目的目的,各模块的功能与定位
  • HOW(怎么做):开发方式,例如使用 bun 而非 node,以及 Claude 如何验证改动是否正确 Humanlayer

以下是一份典型的 CLAUDE.md 结构示例:

复制代码
# My Project

一句话描述项目用途。

## Tech Stack
- Backend: Python / FastAPI
- Frontend: React + TypeScript
- Database: PostgreSQL

## Common Commands
\`npm run dev\`    # 启动开发服务器
\`pytest tests/\`  # 运行测试
\`npm run build\`  # 构建生产版本

## Code Conventions
- 使用 snake_case 命名变量
- 所有 API 需要写单元测试
- PR 合并前必须通过 CI

## Architecture Overview
src/
├── api/        # FastAPI 路由层
├── services/   # 业务逻辑层
└── models/     # 数据模型层

技巧:

  • 提交到版本控制:将 CLAUDE.md 提交到 Git,这样整个团队都能从中受益,新成员可以通过让 Claude 解释代码库来快速上手。
  • 保持精简:内容要简洁且普遍适用。采用"渐进式披露"原则------不要把所有你想让 Claude 知道的内容都塞进去,而是告诉它如何查找重要信息,让它按需获取,避免撑爆上下文窗口。
  • 不要让 CLAUDE.md 替代 linter:在文件中写代码风格规范是最常见的误区之一。永远不要用 LLM 来做 linter 的工作------linter 更快、更便宜,而且是确定性的。代码风格约束只会让上下文窗口膨胀,降低 Claude 的指令遵从质量。(Codestyle就是去规范这个的)

一个完整的 Claude Code 项目通常包含以下文件和目录,按功能可分为「项目指令层」、「配置权限层」、「扩展能力层」三大模块:

复制代码
your-project/
├── CLAUDE.md                    ← 团队共享指令,提交到 git
├── CLAUDE.local.md              ← 个人覆盖,被 git 忽略,
└── .claude/
    ├── settings.json            ← 权限 + 配置,提交到 git
    ├── settings.local.json      ← 个人权限,被 git 忽略
    ├── commands/                ← 自定义斜杠命令
    │   ├── review.md            →  /project:review
    │   ├── fix-issue.md         →  /project:fix-issue
    │   └── deploy.md            →  /project:deploy
    ├── rules/                   ← 模块化指令文件(全局生效)
    │   ├── code-style.md
    │   ├── testing.md
    │   └── api-conventions.md
    ├── skills/                  ← 自动调用的工作流
    │   ├── security-review/
    │   │   └── SKILL.md
    │   └── deploy/
    │       └── SKILL.md
    └── agents/                  ← 子代理角色定义
        ├── code-reviewer.md
        └── security-auditor.md

CLAUDE.local.md:存放只与你本人相关的偏好或临时指令,不应提交到 Git(建议添加到 .gitignore)。

复制代码
# 我的本地覆盖

本地数据库地址:localhost:5433(非默认端口)

调试时请优先输出详细日志。

## 临时规则(本次任务用)
目前专注于重构 auth/ 模块,其他模块暂时不要改动。

.claude/settings.json:团队共享的安全基线配置文件,控制 Claude 允许或禁止执行哪些操作,需提交到 Git 统一管理。

复制代码
{
  "permissions": {
    "allow": [
      "Bash(npm run *)",
      "Bash(pytest:*)",
      "Bash(git diff:*)",
      "Bash(git log:*)"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Bash(curl * | bash)"
    ]
  }
}

settings.local.json:用于临时放开或收紧某些权限,不影响团队其他成员,不应提交到 Git。

复制代码
{
  "permissions": {
    "allow": [
      "Bash(rm ./tmp/*)"
    ]
  }
}

.claude/commands/:该目录下的每个 .md 文件会自动映射为一条 /project:文件名 命令,是团队将重复性任务标准化的核心机制。【当你发现自己重复输入相同的指令时】

命令映射规则:

文件名 对应命令
review.md /project:review
fix-issue.md /project:fix-issue
deploy.md /project:deploy

参数传递:命令文件中可使用 $ARGUMENTS 占位符 接收调用时传入的参数。

例如:commands/fix-issue.md(带参数)

复制代码
# Fix GitHub Issue

给定 Issue 编号 $ARGUMENTS,请:

1. 读取并理解 Issue 描述
2. 定位相关代码文件
3. 实现最小化修复方案
4. 编写对应的单元测试
5. 更新 CHANGELOG.md

调用方式:/project:fix-issue 123

.claude/rules/:将 CLAUDE.md 中的规则拆分模块化存放,Claude 在整个会话中始终遵守这些规则。适合存放长期稳定执行的行为约定,避免 CLAUDE.md 过于臃肿。【当 CLAUDE.md 超过 100 行时,拆分模块。】

rules/code-style.md

复制代码
# Code Style Rules

- TypeScript 严格模式,禁用 any 类型
- 函数长度不超过 40 行,超出则拆分
- 优先使用 const,避免使用 let
- 导入顺序:标准库 → 三方包 → 本地模块
- 所有 export 的函数/类型需要 JSDoc 注释
- 禁止使用 console.log,使用项目 logger

.claude/skills/:Skills 是更高级的复合工作流。当 Claude 判断某个任务适合某个 skill 时,会自动读取并执行对应的 SKILL.md,无需手动调用。每个 skill 是一个子目录,目录内必须包含 SKILL.md。【当有复杂的多步骤工作流需要标准化时。】

⚡ Skills vs Commands 的核心区别:

  • Commands:需要用户主动输入斜杠命令触发,是 "工具箱"。
  • Skills:由 Claude 根据上下文自动判断是否调用,是 "智能本能"。

.claude/agents/:定义可被主 Claude 实例派遣的专业子代理。在复杂任务中,主代理将子任务委派给对应专家角色,实现多代理协作。子代理在隔离上下文中运行,拥有独立的权限范围。【当任务复杂到需要多个专业视角并行时。】

示例:agents/code-reviewer.md

复制代码
---
name: code-reviewer
description: 资深代码审查员,专注代码质量与可维护性
---

# 代码审查员

## 角色定位
你是一名拥有 10 年经验的资深工程师,专注于代码可读性、性能优化和最佳实践。

## 审查重点
- 命名是否清晰表达意图
- 函数/类的单一职责原则
- 边界条件和错误处理
- 性能瓶颈(N+1 查询、不必要的循环等)

## 权限
只读访问,不直接修改文件。

## 输出格式
使用 Markdown 表格输出,包含:问题位置、严重程度、建议方案。

交互模式内命令

全栈MVP

进阶功能

二、OpenClaw个性化

一键初始化

创作自动化

办公自动化

科研自动化

编程自动化

复制代码
📌 [ 笔者 ]   文艺倾年
📃 [ 更新 ]   2026.3.28
❌ [ 勘误 ]   /* 暂无 */
📜 [ 声明 ]   由于作者水平有限,本文有错误和不准确之处在所难免,
              本人也很想知道这些错误,恳望读者批评指正!
相关推荐
axinawang2 小时前
正则表达式
爬虫·python
qq_148115372 小时前
将Python Web应用部署到服务器(Docker + Nginx)
jvm·数据库·python
JaydenAI2 小时前
[RAG在LangChain中的实现]根据数据格式选择文档加载器和文本分割器
python·langchain·ai编程
KIHU快狐2 小时前
KIHU快狐|49寸户外液晶显示器2500亮度智能调光加油站业务办理屏
python·计算机外设
2401_873544922 小时前
持续集成/持续部署(CI/CD) for Python
jvm·数据库·python
hguisu2 小时前
AI大模型-2:智能体(Agent)和demo演示实践
人工智能
Fang fan2 小时前
Netty入门
java·开发语言·redis·分布式·python·哈希算法
墨染天姬2 小时前
【AI】英伟达 AVO 自动生成GPU算子
人工智能
2301_814590252 小时前
使用Python进行图像识别:CNN卷积神经网络实战
jvm·数据库·python