核心用法
Claude Code CLI for OpenClaw 是一套将 Anthropic 官方 Claude Code 命令行工具深度集成到 OpenClaw Agent 系统的技能方案。该 skill 指导用户完成 CLI 安装、OAuth 认证、OpenClaw 后端配置及项目级 CLAUDE.md 大脑文件的创建，使 Agent 能够以原生方式调用 Claude Code 执行编码任务。
安装流程：通过 npm 全局安装 @anthropic-ai/claude-code，执行 claude setup-token 完成浏览器 OAuth 授权（需 Claude Max 订阅），获取 sk-ant-oat01-* 格式的长期有效令牌。
OpenClaw 集成：在 config.patch 中配置 cliBackends.claude-cli，将 CLI 注册为模型后端，支持 claude-cli/opus-4.6 和 claude-cli/sonnet-4.6 两种模型别名，可作为主模型或 fallback 使用。
项目配置：必须在项目根目录创建 CLAUDE.md 文件作为"项目大脑"，包含技术栈、目录结构、编码规范、部署流程等关键信息，Claude Code 会在会话启动时自动读取。
执行模式：
- 交互模式：
claude（需人工确认变更） - 非交互模式：
claude --print "任务描述"（适合 Agent 自动化调用）
显著优点
1. 极致 Token 效率：相比原始 API 调用（需将完整文件内容注入 context，单次任务 10k-50k tokens），Claude Code 通过工具化文件操作（file tool、edit tool）仅需约 500 tokens，实现 80-90% 的成本节约。
2. 扁平计费模型：基于 Claude Max 订阅的 OAuth 认证，非按量计费，适合高频编码场景。
3. 原生代码能力：内置代码库探索、精准文件编辑、多文件协调变更、自动依赖分析，代码质量显著优于基于文本替换的 Agent 方案。
4. 持久项目上下文：CLAUDE.md 机制让项目知识跨会话继承，无需重复描述技术栈和架构。
5. 与 OpenClaw 深度整合：可作为 CLI 后端、模型别名、fallback 选项，支持 exec 工具直接调用及未来 ACP 子代理 spawn 模式。
潜在缺点与局限性
1. 订阅门槛：必须使用 Claude Max 订阅（$100+/月），无法使用普通 API key（sk-ant-api03-*），对轻量用户成本较高。
2. 认证复杂度：OAuth 流程需要 TTY 终端和浏览器交互，自动化部署场景下令牌管理存在挑战。
3. 环境依赖：依赖 Node.js/npm 生态，在纯 Python/Rust 环境中增加维护负担。
4. 网络与区域限制：Anthropic 服务在某些地区可用性受限，OAuth 回调可能受防火墙影响。
5. 版本锁定：OpenClaw 兼容性要求 >=2026.2，旧版本无法使用。
6. 安全管控：OAuth 令牌有效期长达 1 年，泄露风险较高，需严格的环境变量隔离和 .gitignore 配置。
适合人群
- 高频编码 Agent 开发者：日均 10+ 次代码生成/重构任务，Token 成本敏感
- OpenClaw 生态用户：已部署 OpenClaw Gateway，希望扩展模型后端选项
- 中大型项目维护者：代码库规模较大，需要跨文件分析和精准编辑能力
- Claude Max 订阅持有者：已支付订阅费用，希望最大化利用配额
- 自动化工作流构建者：需要可靠、可复现的 CLI 编码工具集成方案
常规风险
令牌泄露风险：CLAUDE_CODE_OAUTH_TOKEN 为长期凭证，若硬编码或误提交至版本控制，攻击者可滥用订阅额度。必须配置 .gitignore 排除 .env* 和 openclaw.json，优先使用 OpenClaw config.patch 机制（不进入 git）。
供应链风险：npm 包的依赖树庞大，需锁定 @anthropic-ai/claude-code 版本，防范恶意依赖注入。
服务可用性风险：Anthropic OAuth 服务或 npm registry 故障将导致工具失效，关键项目应保留纯 API fallback 方案。
误操作风险：--print 模式虽无需确认，但复杂任务仍可能产生意外变更，建议配合 plan-first 提示模式并启用 Git 分支隔离。
成本失控风险：Claude Max 订阅虽为固定费用，但团队共享账号时缺乏用量细粒度管控，需建立内部使用规范。