Paseo 集成 Claude Code 实战指南：复用官方 CLI 与既有 Claude 订阅，从桌面到移动端编排编码 Agent

【免费下载链接】paseoOrchestrate multiple coding agents from desktop and mobile项目地址https://gitcode.com/gh_mirrors/pa/paseo点击查看免费下载Paseo 通过官方claudeCLI 与 Claude Agent SDK 驱动 Claude Code使其成为 Paseo 生态中的一等公民 Agent。本文以 public-docs/claude-code.md 为核心脉络结合 packages/server/src/server/agent/providers/claude/ 下的源码实现完整讲解在 Paseo 中使用 Claude Code 的计费模型、安装认证、会话生命周期以及它在终端、桌面、Web、移动端的实际用法并深入解析底层接入原理帮助你快速上手并理解其工作机制。在 Paseo 中运行 Claude Code 是否额外收费不收费。这是理解 Paseo 与 Claude Code 集成方式的关键前提在 Paseo 中产生的 Claude Code 用量会计入你正常的 Claude 订阅套餐限额与在官方 Claude Code CLI 中直接使用完全一致它不需要单独的 Agent SDK 积分池Agent SDK credits即不会因为通过 Paseo 调用而触发独立的计费体系你依然需要一份包含 Claude Code 的 Claude 套餐且套餐本身的常规用量限制同样适用。从源码看Paseo 之所以能做到这一点是因为它直接复用你本机 Claude Code CLI 的登录凭证而不是引入一套新的认证体系。服务器端的使用量读取器 packages/server/src/services/quota-fetcher/providers/claude.ts 会从~/.claude/.credentials.jsonmacOS 上还会回退到 Keychain服务名Claude Code-credentials读取claudeAiOauth的 accessToken 与 refreshToken再调用 Anthropic 的 OAuth 用量接口拉取套餐信息subscriptionType、rateLimitTier与用量窗口5 小时会话窗口、7 天周窗口以及按模型/表层区分的周限额最终在 Paseo 界面中展示为计划标签和用量条。也就是说用量统计直接来自你 Claude 账号的真实数据因此在 Paseo 里用 Claude Code 和直接用 CLI 消耗的是同一份配额。快速开始安装并登录 Claude Code CLIPaseo 并不内置或捆绑 Claude Code 二进制而是使用运行 Paseo 那台机器上已安装的 Claude Code CLI。因此第一步是在运行 Paseo 的机器上安装 Claude Code CLI官方标准安装方式使用你的 Claude 账号完成 CLI 登录在 Paseo 中启动一个 Claude Code 类型的 Agent。启动时Paseo 会去解析系统中的claude可执行文件。进程解析逻辑位于 packages/server/src/executable-resolution/executable-resolution.ts其配套测试 packages/server/src/executable-resolution/executable-resolution.test.ts 覆盖了 POSIX 上跳过不可执行候选、Windows 上按PATHEXT如.EXE/.CMD回退等场景——例如某个 PATH 目录里先出现一个损坏的.exe时解析器仍能正确找到可用的.cmd包装脚本保证claude在各平台都能被可靠定位。Paseo 使用这份已存在的安装与账号来启动 Claude Code Agent子进程通过 packages/server/src/server/agent/providers/claude/query.ts 中的spawnClaudeCodeProcess覆盖创建SDK 默认以node/bun拉起时会替换为守护进程自身的 Node 运行时避免托管运行时环境下 PATH 查找失败并且显式绕过 Windows 的cmd.exe——因为 SDK 传入的--mcp-config内联 JSON 含双引号会被cmd.exe破坏解析而这里的命令始终是解析后的二进制绝对路径无需 shell 路由。登录过期了怎么办Claude Code 的登录态可能因凭证过期而失效处理规则如下如果你的 Claude 登录过期请先在 Claude Code CLI 中重新认证然后在 Paseo 中新开一个 Claude Code 会话已经运行中的 Paseo 会话会保留其启动时的那份认证重新认证不会热更新正在运行的会话。如果你希望让新凭证生效需要结束旧会话并重新创建。这一点与 packages/server/src/server/agent/providers/claude/agent.ts 中的会话模型一致会话启动时即确定其认证与环境上下文会话配置中包含cwd、model、permissionMode、环境变量等之后不会中途切换身份。用量读取器在遇到 401/403 时也会返回不可用状态并保持只读凭证刷新由 Claude CLI 负责见 claude.ts 中对NEEDS_AUTH的处理注释这与重新认证后需新开会话的产品行为互为印证。在 Paseo 终端里直接使用 Claude Code除了在 Paseo 中创建受管 AgentClaude Code同样能在 Paseo 终端里完美工作如果你偏爱标准 CLI 体验直接在 workspace 中打开一个终端像平常一样运行claude即可你可以从 Paseo 的桌面端、Web 端或移动端使用这个终端并且同时保有对 workspace、git 变更以及其他 Paseo 工具的访问能力。这意味着 Paseo 终端不仅是远程 shell还是一个携带工作区上下文的运行环境git 变更、文件系统与 Paseo 工具链与 Claude Code 会话处于同一上下文无论你身处哪个客户端都能继续操作。源码视角Claude Agent 在 Paseo 中的能力边界Paseo 中的 Claude Code 不只是起一个进程而是深度集成的受管 Agent。核心实现位于 packages/server/src/server/agent/providers/claude/agent.ts约 6300 行基于anthropic-ai/claude-agent-sdk的query()驱动其能力标志CLAUDE_CAPABILITIES明确声明支持流式输出、会话持久化与会话列表动态模式切换、MCP 服务器注入推理流reasoning stream、工具调用追踪会话回退rewind conversation与文件回退rewind files。权限模式Permission ModesPaseo 将 Claude Code 的原生权限模式映射为可选的 Agent 模式DEFAULT_MODES模式 ID界面名称行为说明planPlan Mode只分析代码库不执行工具或编辑defaultAlways Ask工具首次使用时弹出权限询问acceptEditsAccept File Edits自动批准编辑类工具不弹询问autoAuto mode用模型分类器自动审查权限请求默认模式bypassPermissionsBypass跳过所有权限提示慎用需要注意的是auto模式依赖 Anthropic API 的分类器在 Claude Code 走 BedrockCLAUDE_CODE_USE_BEDROCK或 VertexCLAUDE_CODE_USE_VERTEX环境变量时不可用此时模式列表会自动剔除auto并将默认模式回退为default见claudeAutoModeUnavailableOn与claudeModeCatalog。思考力度与模型清单针对不同 Claude 模型Paseo 支持low/medium/high/xhigh/max思考力度档位以及关闭思考off与 Ultracode 等特殊选项。哪些档位对哪个模型开放由模型清单 packages/server/src/server/agent/providers/claude/model-manifest.ts 统一定义例如claude-opus-5、claude-fable-5-1、claude-sonnet-5等条目包含contextWindowMaxTokens200K/1M、minimumClaudeCodeVersion如2.1.219、effortLevels、supportsThinkingDisabled等字段——模型选择器的思考选项与功能开关均从该清单派生因此当你升级 Claude Code CLI 到新版本后清单中标记了最低版本要求的新模型才会开放。Provider 选项工具策略与沙箱在 Paseo 中配置 Claude Code Agent 时可用的 Provider 选项由 packages/server/src/server/agent/providers/claude/options.ts 中的ClaudeProviderOptionsSchema严格校验主要分四类allowedTools/disallowedTools允许/禁止的工具白名单与黑名单applyClaudeToolPolicy还会把 Paseo 侧预授权的 MCP 工具以mcp__server__tool形式合并进allowedToolsadditionalDirectories允许 Claude 访问的额外目录sandbox沙箱配置含启用/失败即报错行为、排除的命令、非沙箱命令许可、网络规则允许/拒绝域名、严格白名单、Unix socket、本地绑定、HTTP/SOCKS 代理端口、TLS 终结证书与文件系统规则允许/拒绝读写、托管只读路径以及 ripgrep 命令覆盖settings透传 Claude 原生设置支持permissions.{allow,ask,deny}规则与沙箱设置。这些字段与 docs/providers.md 中Claude:allowedTools、disallowedTools、additionalDirectories、sandbox、settings的文档描述一一对应作为 Paseo 的 provider 选项直接落到 SDK 调用上。继续阅读Supported providers支持的 Agent 列表了解可以与你现有 Claude Code 并排运行的其他 Agent如 Codex、OpenCode、Pi 等Custom providers自定义 Provider自定义二进制、第三方端点或多个 Claude 配置文件场景下的接入方式providers.mdProvider 开发文档Claude 作为 direct provider 的架构说明、模型清单维护方式与工具目录机制。赞分享【免费下载链接】paseoOrchestrate multiple coding agents from desktop and mobile项目地址https://gitcode.com/gh_mirrors/pa/paseo点击查看免费下载相关推荐Plandex Claude集成订阅账户连接与使用指南Plandex Claude集成订阅账户连接与使用指南 概述 Plandex作为一款强大的AI编程引擎提供了与Anthropic Claude Pro/Ma人工智能AI Agent代码智能体CLI开发工具AI SDK Harness 规范与 HarnessAgent 实战在 TypeScript 中编排 Claude Code 等编码 AgentAI SDK Harness 规范与 HarnessAgent 实战在 TypeScript 中编排 Claude Code 等编码 Agent 导读 ai人工智能AI 应用AI Agent工具调用MCP ClientsClaude Code 编排实战指南在 Munder Difflin 中用 GOD 编排器把多个 Agent 变成一支团队Claude Code 编排实战指南在 Munder Difflin 中用 GOD 编排器把多个 Agent 变成一支团队 导读 大多数多 Agent配人工智能AI Agent多智能体Agent 编排代码智能体桌面应用上一篇如何永久保存微信聊天记录WeChatMsg一键导出与年度报告生成完全指南下一篇Ebitengine 项目常见问题解决方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考