Claude Dev 设置

面向编码代理的完整包：Claude Code CLI 集成、会话管理和 APEX 认知框架。

此技能的功能

安装并配置：

1. 1. 会话追踪 — memory/claude-code-sessions.md 用于后台任务管理
2. AGENTS.md 章节 — 所有编码代理的工作流文档
3. APEX 栈参考 — 如何将认知框架添加到项目 CLAUDE.md 文件中
4. OAuth 令牌处理 — 自动提取和使用令牌

前置条件

• - Node.js 18+
• Claude Pro/Max 订阅（用于 OAuth 令牌）
• OpenClaw 代理工作区

OAuth 令牌（关键）

令牌存放位置

Claude Code 将其 OAuth 令牌存储在：

~/.claude/.credentials.json

令牌格式

sk-ant-oat01-xxxxx...

如何获取令牌

选项 1：从凭据文件中提取（推荐）
bash

从凭据中提取 accessToken

cat ~/.claude/.credentials.json | grep -o accessToken:[^]* | cut -d -f4

选项 2：通过浏览器进行身份验证（首次设置）
bash
claude setup-token

打开浏览器进行 OAuth 流程

在提示时粘贴授权码

调用 Claude Code 时始终使用令牌

每次 Claude Code CLI 调用必须包含令牌：

bash

✅ 正确 - 明确设置令牌

export CLAUDECODEOAUTH_TOKEN=sk-ant-oat01-xxxxx...
claude --print --dangerously-skip-permissions 你的任务

❌ 错误 - 未设置令牌，在非交互模式下会失败

claude --print 你的任务

自动提取令牌

添加到你的 shell 配置文件以实现自动加载令牌：
bash

添加到 ~/.bashrc 或 ~/.zshrc

export CLAUDECODEOAUTH_TOKEN=$(cat ~/.claude/.credentials.json 2>/dev/null | grep -o accessToken:[^]* | cut -d -f4)

对于代理执行器

使用 exec 工具时，始终提取并设置令牌：

json
exec({
command: export CLAUDECODEOAUTH_TOKEN=$(cat ~/.claude/.credentials.json | grep -o \accessToken\:\[^\]*\ | cut -d\ -f4) && claude --print --dangerously-skip-permissions 任务描述,
background: true,
yieldMs: 10000
})

或预先提取并使用：
json
// 首先，提取令牌
exec({
command: cat ~/.claude/.credentials.json | grep -o \accessToken\:\[^\]*\ | cut -d\ -f4
})

// 然后在所有后续调用中使用
exec({
command: CLAUDECODEOAUTH_TOKEN=sk-ant-oat01-xxx claude --print --dangerously-skip-permissions 任务
})

架构

代理工作区
├── AGENTS.md # + 会话管理章节
├── memory/
│ └── claude-code-sessions.md # 新增：会话注册表
└── skills/
├── claude-code-cli-openclaw/ # CLI 集成
├── apex-stack-claude-code/ # 认知框架
└── claude-dev-setup/ # 本技能

系统级别
└── ~/.claude/.credentials.json # OAuth 令牌（请勿提交）

会话管理

注册表格式

会话在 memory/claude-code-sessions.md 中追踪：

markdown

会话 ID	标签	任务	开始时间	状态
tender-nexus	build-auth	构建认证模块	2026-03-24 08:50 UTC	运行中

启动后台任务（正确方式）

json
// 步骤 1：从凭据中提取令牌
// 步骤 2：在 Claude Code 调用中使用
exec({
command: CLAUDECODEOAUTH_TOKEN=$(cat ~/.claude/.credentials.json | grep -o \accessToken\:\[^\]*\ | cut -d\ -f4) claude --print --dangerously-skip-permissions 任务描述,
background: true,
yieldMs: 10000
})

启动后，记录会话：

1. 1. 从响应中记录 sessionId
2. 追加到 memory/claude-code-sessions.md
3. 向用户报告：已启动 X（会话：标签）

检查状态

当用户询问状态如何？时：
json
process({ action: log, sessionId: session-id })

标签命名约定

• - build-feature-X — 构建新功能
• refactor-Y-module — 重构代码
• fix-bug-Z — 修复错误
• test-coverage-A — 添加测试
• cleanup-legacy-B — 移除旧代码

快速任务（< 30 秒）

对于简单任务，使用直接 exec 而不追踪：
json
exec({
command: CLAUDECODEOAUTH_TOKEN=$(cat ~/.claude/.credentials.json | grep -o \accessToken\:\[^\]*\ | cut -d\ -f4) claude --print --dangerously-skip-permissions 快速修复,
timeout: 60
})

AGENTS.md 集成

安装此技能后，你的 AGENTS.md 将获得一个新章节：

markdown

🤖 Claude Code CLI 会话

你可以使用 Claude Code CLI 执行编码任务。

OAuth 令牌（必需）

令牌位置： ~/.claude/.credentials.json

始终提取并使用令牌：
bash
CLAUDECODEOAUTH_TOKEN=$(cat ~/.claude/.credentials.json | grep -o accessToken:[^]* | cut -d -f4) claude --print --dangerously-skip-permissions 任务

会话追踪

所有后台会话在 memory/claude-code-sessions.md 中追踪。

开始前： 检查是否有正在运行的会话
开始后： 记录会话 ID + 标签
完成后： 更新状态列

当用户询问状态时

1. 1. 读取会话文件
2. 按标签查找会话
3. 轮询输出
4. 总结进度

项目的 APEX 栈

认知框架（apex-stack-claude-code）应添加到项目 CLAUDE.md 文件中，而不是代理内存中。

添加到项目

bash
cd /path/to/your/project

如果 CLAUDE.md 不存在：

cat ~/.openclaw/workspace-YOURS/skills/apex-stack-claude-code/SKILL.md > CLAUDE.md

如果 CLAUDE.md 存在，追加：

cat ~/.openclaw/workspace-YOURS/skills/apex-stack-claude-code/SKILL.md >> CLAUDE.md

APEX 栈的功能

层	用途
APEX	认知模式（精确、执行、架构、创意）
MEMORIA

项目上下文的持久记忆 | | ARCHITECT | 自主执行循环 |

项目 CLAUDE.md 结构

markdown

项目：[名称]

概述

[1-2 句话]

技术栈

• - 语言：...
• 框架：...

[APEX 栈内容在此追加]

完整工作流

用户给出任务
↓
代理读取 memory/claude-code-sessions.md（检查冲突）
↓
代理提取令牌：cat ~/.claude/.credentials.json | grep accessToken
↓
代理启动：exec({ command: CLAUDECODEOAUTH_TOKEN=xxx claude ..., background: true })
↓
代理将会话记录到 claude-code-sessions.md
↓
代理报告：已启动 X（会话：build-feature-X）
↓
用户：状态如何？
↓
代理读取会话文件 → 轮询进程 → 总结

安装检查清单

安装此技能后运行：

• - [ ] Claude Code CLI 已安装：which claude
• [ ] 已验证身份：检查 ~/.claude/.credentials.json 是否存在
• [ ] 令牌可提取：cat ~/.claude/.credentials.json | grep accessToken
• [ ] 会话文件已创建：memory/claude-code-sessions.md
• [ ] AGENTS.md 已更新会话章节
• [ ] APEX