@felan-ai/ext-claude-code (英语)
在费兰使用克洛德模型 通过克洛德代码和你的克洛德计划登录. Felan保留代理循环,对话,工具,批准,以及用户界面. Claude Code作为模型通过Anthropic的SDK代理进行传输 正在处理的MCP服务器将Felan的工具暴露给克洛德. 桥像费兰 claude代码会话的历史,所以恢复请求时可以看到同样的对话. 不需要Claude代码的同伴修改.
所需经费和设置
- 一个macOS或Linux Felan主机. 非主机运行时间和Windows不支持.
npm{\fn黑体\fs20\shad2\2ah82\3ah20\4ah33\fscx95\3ch592001\be1}在主机上 {\fn黑体\fs20\shad2\2ah82\3ah20\4ah33\fscx95\3ch592001\be1}在主机上PATH用于管理下的安装.- Claude代码安装并签入了一台兼容克洛德的机器
计划。 运行
claude,则/login,在使用此提供者之前.
在费兰:
- 运行
/claude-code install并批准主机的安装请求。 这个 下载 Claude Agent SDK 0.3322 (中文(简体) ) 及其大约 330 甲基溴 每个平台二进制Linux 下载 glibc 和 musl 变体, 大致 640 甲基溴 总计. Anthropic的代理SDK许可证和 术语 应用; SDK 和克洛德代码 与这个麻省理工学院的许可包. - 启动新会话或重新装入以装入提供者 .
- 使用
/model claude-code/<model-id>,例如/model claude-code/claude-opus-5-5,或选择一个claude-code模式在/model。 。 。 . - 运行
/claude-code status以检查 SDK 版本, 是否提供商 和已解决的计划和长文本设置.
/claude-code 也显示状态。 未知参数显示用法 .
安装代表 { id: 'claude-code' } 改为可选
RUNTIME_DEPENDENCIES_SERVICE; 授权属于可信任的本地 Felan
主持人。 没有这种服务,仍然可以使用状态,但安装被禁用.
激活只检查并装入已有的安装: 它从未安装
任何东西,执行 npm,或下载文件。 缺失或可卸载的 SDK 已被登录
通过运行时间记录器 并离开提供者未注册。 检查也
报告在缺少所需版本时已经安装的 SDK 版本.
在本地交互启动时, Felan 为启用的提供者提供更新
需要一个更新的 SDK, 即使依赖 登入之前已经完成。 安装
需要确认。 所需选择的记录保持不变
版本; 无法取消记录 。 没有向残疾提供者提供最新情况.
激活后启动 Claude 代码, 无需及时读取其模型列表( 请参见
模型) (中文(简体) ).
管理中的SDK及其被固定的依赖性生活在
<agent-storage>/claude-code/agent-sdk-0.3.322生成的无害环境管理条目负载
sDK特工和MCP的安装 主机供应商
能够导入 inspectClaudeCodeRuntime, (中文(简体) ), installManagedClaudeAgentSdk, (中文(简体) ),
managedClaudeAgentSdkDirectory,以及 MANAGED_CLAUDE_AGENT_SDK_VERSION 从此
软件包。 安装器助手不执行授权本身.
安装时使用经审查的装有完整性散列器的已安装锁文件
npm ci --ignore-scripts. 完成的安装在进行中得到核实,包括
主机的平台和 libc 匹配的二进制, 在移动到位置之前.
有效的安装永远不会被移除或被替换; 重排为不操作 .
npm 注册和代理配置仍然适用,但完整性是强制的.
见 运行时间依赖关系。 。 。 .
模型
提供商对克劳德代码的核心Anthropic目录模型进行注册
清单 /model 用于登录的拾取器 。 名单要看克劳德
代码版本,你的计划,并管理 availableModels 财务报告和审定财务报表 deniedModels
设置。 编目模型 Claude 代码没有列出,例如模型比
被钉住的克洛德密码没有登记 克劳德代码模型列表
缺少目录也没有登记;它出现在Agent Core更新后.
省略了日期快照别名 .
Felan程序中的首次激活要求 Claude Code提供该列表
在冷起步时需要0.25秒和2秒; 以后的会话重复使用
答案,直到进程重新启动或 inheritAnthropicEnvironment 或者说
pathToClaudeCodeExecutable 变化。 如果 Claude 代码返回出错或不返回
在20秒内回答,警告被记录, 提供者保持未登记
下届会议再次提出。 呼叫者
activateClaudeCodeBridge 从 claudeCodeSupportedModels。 。 。 .
Claude代码收到大部分 /model 线条,包括旧的和新的
通过其遥测服务推出模型。 因此,模型清单探测器
运行时启用 Claude 代码遥测; 错误报告、 自动更新器和
bug 命令继续禁用, 对话会转动
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1设置
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 或者说 DISABLE_TELEMETRY=1 在费兰
claude Code 然后列出
仅限其基础模型.
模型保存目录中的 Anthropic API 价格,所以会话成本在页脚中
和使用情况报告是按清单价格计算的API等同估计数,包括:
克劳德代码的1小时缓存写作. 这不是你的帐单,是用费
与你的克劳德计划的限制和额外使用, 不是这些费率。 计划使用
事件作为 anthropic-ratelimit-unified-* 响应信头
兼容页脚扩展名.
设置
使用 /settings,或编辑 extensionConfig["claude-code"] 内
$FELAN_AGENT_DIR/settings.json数字 :
{
"extensionConfig": {
"claude-code": {
"plan": "pro",
"longContextExtraUsage": false,
"forceTwoHundredK": [],
"strictMcpConfig": true,
"autoMemoryEnabled": false,
"inheritAnthropicEnvironment": false
}
}
}
| 设置 | 默认 | 目的 |
|---|---|---|
plan | "pro" | "pro" 或者说 "max"; 控制计划中的长文本可用性,而不是认证. |
longContextExtraUsage | false | 启用可能消耗付费额外用法的长文本模型 . |
forceTwoHundredK | [] | 将模式ID组合到200K上下文; 省略 claude-code/ 财务报告和审定财务报表 [1m]。 。 。 . |
strictMcpConfig | true | 不包括本地 Claude 代码 MCP 配置;使用 Felan 的工具. Claude.ai连接的MCP服务器总是被禁用. |
autoMemoryEnabled | false | 除了费兰的记忆外,还启用克洛德代码自己的自动记忆. |
pathToClaudeCodeExecutable | 未设定 | 可选的绝对路径 claude而不是SDK捆绑的二进制. |
inheritAnthropicEnvironment | false | 保存已导出 ANTHROPIC_API_KEY, (中文(简体) ), ANTHROPIC_AUTH_TOKEN,以及 ANTHROPIC_BASE_URL 在克劳德法典的孩子。 默认只删除这三种变量. |
其他克劳德代码变量仍然通过,包括
CLAUDE_CODE_OAUTH_TOKEN, (中文(简体) ), CLAUDE_CODE_USE_BEDROCK, (中文(简体) ), CLAUDE_CODE_USE_VERTEX, (中文(简体) ),
ANTHROPIC_MODEL,以及 ANTHROPIC_CUSTOM_HEADERS它们可以改变认证,
模式选择,或请求目的地,即使 inheritAnthropicEnvironment
实值 false。 。 。 .
无效类型、未知字段、无效的计划值、非字符串数组条目,以及 相对可执行路径被拒绝。 变化在激活时生效 新建会话或重新装入。 桥梁设置是全过程的:在一个共享守护进程中 用于后续呼叫的最新激活供应设置.
长文本支持是模式特异性的. 寓言 5.2 使用 :
Claude代码和请求 claude-fable-5-2[1m]。 Opus 4.6 在最大值上使用 1M 上下文
或附加用法; Sonnet 4.6 需要附加用法. 其他支持的1M型号
使用桥的相容表。 未知模型默认为 200K; 使用
forceTwoHundredK 如果您的账户无法打开请求的大窗口.
兼容性和限制
- Felan 工具、工具核准和
ask_user留在费兰 克劳德代码的土生土长 工具被禁用; Felan工具通过进程内MCP服务器被曝光. - 项目背景、技能、习惯和所附指示以及结构
systemPromptOptions.sections页:1 扩展名应该使用这些 而不是替换完整的系统即时. - Felan的绳索没有被传送 桥拒绝包含 而不是默默发送 麻醉决定 申请是否有资格获得计划配额或额外使用.
- 压缩,分支摘要和标题使用孤立的克洛德代码查询. 带有单一用户消息且没有抓取会话的即时无工具呼叫 快速还使用孤立的查询,包括通过 Felan's Models 的 Fusion 服务。 副特工接受他们自己的克洛德密码对话. 堕落者 上游 AskClaude 工具不包含;使用 Felan 子剂.
- 每个 Felan 会话 保持其 Claude 代码进程在提示和写之间 下一个提示。 对运行过程应用了新的思维级别 先说 模型、工具、工作目录、预测指令或 桥架设置, 切换思考或返回, 或历史重写, 启动一个恢复对话的新进程。 过程在 会话关闭( 包括守护进程闲置驱逐) 或切换到另一个 模型;一个闲置的过程大约使用200–260 MB的内存.
- 接合、树导航、中止和模型开关需要重写 镜像的历史。 重建会重新发送历史, 并可能错过快取 .
- 在重建之前,会中即时的修改可能不会到达克洛德代码. 开始 a 更新指示时的新会话必须立即生效.
- Claude代码设置和钩子可以影响其子进程. 审查机-当地 如果复制了Felan的指令,就用钩子. 启用继承的 Anthropic 环境变量可以重定向请求或更改认证/账单.
- 每场Felan会话使用
claude-code创建 Claude 代码会话 JSONL 抄录于~/.claude/projects/<cwd>/(或$CLAUDE_CONFIG_DIR/projects/<cwd>/) (中文(简体) ). 这些副本留在费兰会议之后 关闭或被删除并出现在 Claude 代码中/resume列表中选择一个选项。 SDK这个 生成一个本地进程; 此主机桥不是沙盒, 需要 访问这些文件以进行历史镜像.
调试
设定 CLAUDE_BRIDGE_DEBUG=1 在启动 Felan 之前启用桥调试输出
每克克克洛德代码 CLI 日志 :
claude-bridge.log在扩展的激活中agentDir记录通话, 历史同步,工具结果,和子进程 stderr.CLAUDE_BRIDGE_DEBUG_PATH覆盖桥日志路径。 CLI 日志输入cc-cli-logs/在路边.claude-bridge-diag.log下级agentDir记录了异常无常的失败.
对于会话重现错误,请检查 syncResult: 线条和匹配的 CLI 日志.
日志可以包含提示、工具输出和其他敏感数据; 编辑它们
在分享之前。 对于认证错误, 运行 claude 财务报告和审定财务报表 /login {\fn华文楷体\fs16\1che0e0e0}在主机上.
发展
pnpm --filter @felan-ai/ext-claude-code build
pnpm --filter @felan-ai/ext-claude-code type-check
pnpm --filter @felan-ai/ext-claude-code test
测试使用假 SDK 条目和孤立存储; 不需要 Claude 登录,下载SDK,或产出克洛德代码.
归属
改编自麻省理工学院许可证
皮-克-克-桥 0.9.3 (单位:千美元) 以
Eli Dickinson, 承诺 874fa7c2678456336f23b64e784e2057e608d83e,原基于
打开 幽灵sdk-pi 以
普尔提克·苏纳勒. 见 通知 财务报告和审定财务报表 自由主义安东尼的特工SDK
和克洛德代码是单独许可的 只有根据明确要求安装.