# @felan-ai/ext-claude-code 中文文档

规范地址：https://npmcn.com/package/%40felan-ai/ext-claude-code/

版本：0\.4\.1
npm 元数据更新时间：2026-11-12T04:26:33.824Z
中文译文更新时间：2026-11-14T14:00:00.560Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40felan-ai/ext-claude-code
原文对照：https://npmcn.com/package/%40felan-ai/ext-claude-code/?lang=original
项目主页：https://github.com/felan-ai/felan#readme
源码仓库：https://github.com/felan-ai/felan

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：547 kB，109 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.19\.0
- 运行依赖：2 个
- peer 依赖：@felan-ai/agent-core ^0\.15\.0
- 首次发布：2026-10-21T14:25:53.712Z
- 最新版本发布：2026-11-12T04:26:33.451Z
- 近 30 天下载量：2335（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：9（近 12 个月 9 个）

## 中文简介

Claude Code 计划支持的 Felan 模型提供者

## 安装

```sh
npm install @felan-ai/ext-claude-code
```

也可以使用：`pnpm add @felan-ai/ext-claude-code`、`yarn add @felan-ai/ext-claude-code`、`bun add @felan-ai/ext-claude-code`

## README

# @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`,在使用此提供者之前.

在费兰:

1.  运行 `/claude-code install` 并批准主机的安装请求。 这个 下载 Claude Agent SDK **0.3322 (中文(简体) )** 及其大约 **330 甲基溴 每个平台二进制**Linux 下载 glibc 和 musl 变体, 大致 **640 甲基溴** 总计. [Anthropic的代理SDK许可证和 术语](https://github.com/anthropics/claude-agent-sdk-typescript) 应用; SDK 和克洛德代码 与这个麻省理工学院的许可包.
2.  启动新会话或重新装入以装入提供者 .
3.  使用 `/model claude-code/<model-id>`,例如 `/model claude-code/claude-opus-5-5`,或选择一个 `claude-code` 模式在 `/model`。 。 。 .
4.  运行 `/claude-code status` 以检查 SDK 版本, 是否提供商 和已解决的计划和长文本设置.

`/claude-code` 也显示状态。 未知参数显示用法 . 安装代表 `{ id: 'claude-code' }` 改为可选 `RUNTIME_DEPENDENCIES_SERVICE`; 授权属于可信任的本地 Felan 主持人。 没有这种服务,仍然可以使用状态,但安装被禁用. 激活只检查并装入已有的安装: 它从未安装 任何东西,执行 `npm`,或下载文件。 缺失或可卸载的 SDK 已被登录 通过运行时间记录器 并离开提供者未注册。 检查也 报告在缺少所需版本时已经安装的 SDK 版本. 在本地交互启动时, Felan 为启用的提供者提供更新 需要一个更新的 SDK, 即使依赖 登入之前已经完成。 安装 需要确认。 所需选择的记录保持不变 版本; 无法取消记录 。 没有向残疾提供者提供最新情况. 激活后启动 Claude 代码, 无需及时读取其模型列表( 请参见 [模型](https://npmcn.com/package/%40felan-ai/ext-claude-code/#readme-models)) (中文(简体) ).

管理中的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 注册和代理配置仍然适用,但完整性是强制的. 见 [运行时间依赖关系](https://npmcn.com/package/docs/reference/runtime-dependencies.md#claude-code-managed-runtime)。 。 。 .

## 模型

提供商对克劳德代码的核心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`数字 :

```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}在主机上.

## 发展

```sh
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,或产出克洛德代码.

## 归属

改编自麻省理工学院许可证 [皮-克-克-桥](https://github.com/elidickinson/pi-claude-bridge) **0.9.3 (单位:千美元)** 以 Eli Dickinson, 承诺 `874fa7c2678456336f23b64e784e2057e608d83e`,原基于 打开 [幽灵sdk-pi](https://github.com/prateekmedia/claude-agent-sdk-pi) 以 普尔提克·苏纳勒. 见 [通知](https://npmcn.com/package/%40felan-ai/ext-claude-code/NOTICE) 财务报告和审定财务报表 [自由主义](https://npmcn.com/package/%40felan-ai/ext-claude-code/LICENSE)安东尼的特工SDK 和克洛德代码是单独许可的 只有根据明确要求安装.

## 常见问题

### @felan-ai/ext-claude-code 是什么？

Claude Code 计划支持的 Felan 模型提供者

### 如何安装 @felan-ai/ext-claude-code？

在项目目录运行 npm install @felan-ai/ext-claude-code，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@felan-ai/agent-core（^0\.15\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @felan-ai/ext-claude-code 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @felan-ai/ext-claude-code 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @felan-ai/ext-claude-code 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.19\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @felan-ai/ext-claude-code 可以商用吗？

@felan-ai/ext-claude-code 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @felan-ai/ext-claude-code 的下载量有多少？

根据 npm 官方下载统计，@felan-ai/ext-claude-code 在 2026/10/15 – 2026/11/13 这 30 天内被下载 2,335 次，日均约 78 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @felan-ai/ext-claude-code 还在维护吗？

最新版本 0\.4\.1 发布于 2026/11/12（2 天前）；至今共发布 9 个版本，其中过去 12 个月发布了 9 个；首次发布于 2026/10/21。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。