# @doguyilmaz/aims 中文文档

规范地址：https://npmcn.com/package/%40doguyilmaz/aims/

版本：0\.4\.2
npm 元数据更新时间：2026-10-31T22:21:51.189Z
中文译文更新时间：2026-11-01T00:10:09.229Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40doguyilmaz/aims
原文对照：https://npmcn.com/package/%40doguyilmaz/aims/?lang=original
项目主页：https://aims.apps.doguyilmaz.com/
源码仓库：https://github.com/doguyilmaz/aims

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

- 包体积（解压后）：70 MB，9 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-10-07T06:33:56.567Z
- 最新版本发布：2026-10-31T22:21:50.889Z
- 已发布版本数：16（近 12 个月 16 个）

## 中文简介

一台机器上有几个Claude Code和Codex帐户：即时切换，共享历史记录，故障转移。

## 安装

```sh
npm install @doguyilmaz/aims
```

也可以使用：`pnpm add @doguyilmaz/aims`、`yarn add @doguyilmaz/aims`、`bun add @doguyilmaz/aims`

## README

![aims logo: a prompt whose cursor is coral and ivory](https://raw.githubusercontent.com/doguyilmaz/aims/v0.4.2/assets/logo.svg)

# 目标

几个克劳德代码和法典帐户在一台机器上。  
即时切换，共享历史记录，达到极限时进行故障转移。

[文档](https://aims.apps.doguyilmaz.com/) · [安装](https://aims.apps.doguyilmaz.com/installation) · [快速启动](https://aims.apps.doguyilmaz.com/quick-start)

* * *

**目标** 代表 **AI multi-session**． 它允许您在一台计算机上使用Claude Code和Codex的个人和工作帐户（或更多），而无需注销和登录切换。

-   **每个帐户登录一次。** 每个帐户都在自己的文件夹中保存自己的登录名。没有什么是复制的。
-   **会议自行进行。** 会话从您的第一个帐户开始。在使用限制下，它移动到下一个并继续对话，一旦第一个恢复正常，它就会移动回来。
-   **一个历史。** 对话、设置、技能和MCP服务器是共享的，因此在一个帐户上开始的对话可以在另一个帐户上继续进行。或者把一个账户的历史记录分开。
-   **你的AI可以使用它。** MCP服务器和技能可以让Claude Code和Codex检查帐户，故障转移，并将任务交给另一个帐户。

```text
$ aims status
Claude Code
  order of this project (~/code/client-app); elsewhere personal → work
  ● personal  pro       login expired  7d 37%
    work      team      ready          7d 84%  standing in for personal
  new sessions start on work

Codex
  ● personal  plus      ready          7d 31%
    work      business  ready

Open sessions
  Claude Code  work      ~/code/client-app · 12h59m ago
  Claude Code  work      ~/code/api · 2h4m ago
  Codex        personal  ~/code/blog · 6m ago

Next
  → claude/personal is not logged in  aims login claude personal
  → codex/personal keeps 51 MB of unused database copies  aims doctor --fix

Every limit and when it resets, also for Antigravity, Grok, Kiro and OpenCode: aims usage
```

`aims status` 发生了什么：每个帐户的状态，会话现在做什么，会话现在打开和，下 **下一个**，剩下要设置的内容，每个都包含执行该操作的命令。 `aims usage` 有每一个数字：

```text
$ aims usage
Claude Code
  personal       pro       5h     ━━━━━━    –                 7d     ━━━━━━  37%  resets 4d
  work           team      5h     ━━━━━━   2%  resets 4h10m   7d     ━━━━━━  84%  resets 4d

Codex
  personal       plus      5h     ━━━━━━   9%  resets 2h5m    7d     ━━━━━━  31%  resets 5d
  work           business  5h     ━━━━━━    –                 7d     ━━━━━━    –

Antigravity
  Gemini Models            5h     ━━━━━━   0%  resets 5h      7d     ━━━━━━   5%  resets 3d

Grok  x premium
  credits                  7d     ━━━━━━  26%  resets 47h

Kiro  pro
  credits                  month  ━━━━━━  42%  resets 12d     420 of 1000 credits

OpenCode
  my-team                  budget ━━━━━━  67%  resets 9d      $33.50 of $50
```

`aims` 独自打开一扇门 [指示板](https://aims.apps.doguyilmaz.com/dashboard) 两种观点(`tab` 开关)和其他一切的钥匙。

## 安装

```bash
brew install --cask doguyilmaz/tap/aims                                          # macOS, Linux
curl -fsSL https://raw.githubusercontent.com/doguyilmaz/aims/main/scripts/install.sh | sh
npm install -g @doguyilmaz/aims
go install github.com/doguyilmaz/aims/cmd/aims@latest
```

在Windows上: `irm https://raw.githubusercontent.com/doguyilmaz/aims/main/scripts/install.ps1 | iex`，或Scoop。看到 [安装](https://aims.apps.doguyilmaz.com/installation).

## 开始

```bash
aims init
```

安装程序会找到Claude Code和Codex，将你已经拥有的登录信息转换为你的第一个账户，创建第二个账户，询问从哪个账户开始，并将工具与目标联系起来。然后像往常一样开始：

```bash
claude                     # or codex: aims picks the account and watches the session
```

与shell集成(`aims setup` 提供它)，简单 `claude` 和 `codex` 了解目标。没有它，输入 `aims claude` 和 `aims codex`． 每个会话在开始时都说明了它的目标是什么，Claude Code的状态行在运行时显示了它：

```text
› claude: personal (auto → work)
personal ▰▱▱▱▱  12% · 7d 31% · auto → work
```

| 开始一个会话 | 它开始于 | 在一定限度内 |
| --- | --- | --- |
| `claude`， `aims claude` | 你的第一个账户 | 移动到下一个帐户，并在第一个帐户再次工作后返回 |
| `aims claude@work` | 工作 | 停留在工作上（固定） |

`aims` 单独显示您的帐户，会话现在打开，还有任何东西需要设置。 `aims order` 更改哪个帐户首先出现(在此项目中； `--global` 对于每个文件夹)，和 `aims doctor` 检查一切。

## 它是如何工作的

Claude Code和Codex从一个文件夹读取它们的状态(`CLAUDE_CONFIG_DIR`， `CODEX_HOME`）. Aims为每个帐户提供了自己的文件夹，仅保存其登录名，并将其他所有内容链接到您的正常 `~/.claude` 和 `~/.codex`. `aims claude` 设置变量并开始实际的 `claude`;Aims不是代理，永远不会看到你的提示。细节 [它是如何工作的](https://aims.apps.doguyilmaz.com/how-it-works).

## 开发

```bash
go test ./...                     # unit and end-to-end tests (stand-ins for claude and codex)
go run ./cmd/aims status
hugo server --source docs         # the documentation site
```

每个支持的CLI都是一个适配器 `internal/tool/<name>`;中描述了添加一个 [添加工具](https://aims.apps.doguyilmaz.com/how-it-works#adding-a-tool).

## 合理使用

目标的存在是为了将工作和个人分开。许多人有一个工作帐户和一个个人帐户，他们希望每个项目都使用正确的帐户，而不需要登录和退出。Aims只在您自己的机器上运行您自己的帐户。它与官方Claude Code和Codex CLI开始会话，并通过每个工具自己的CLI和登录（对于Kiro，相同的使用请求）读取Antigravity， Grok， Kiro和OpenCode的限制 `kiro-cli` 使)。它不是一种服务：没有其他人的账户通过它，它从不共享、共用或转售访问权限。它不会伪装自己，也不会向提供者发送它们自己的cli不会发送的任何东西。每个账户都要遵守其提供商的条款，其目的并不是为了绕过一个计划的限制而堆积账户。aims不隶属于Anthropic， OpenAI， b谷歌，xAI，亚马逊或OpenCode。

## 许可证

[麻省理工学院](https://npmcn.com/package/%40doguyilmaz/aims/LICENSE)

## 常见问题

### @doguyilmaz/aims 是什么？

一台机器上有几个Claude Code和Codex帐户：即时切换，共享历史记录，故障转移。

### 如何安装 @doguyilmaz/aims？

在项目目录运行 npm install @doguyilmaz/aims，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 aims，可以用 npx aims 直接运行。

### @doguyilmaz/aims 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/doguyilmaz\_\_aims 是否存在。

### @doguyilmaz/aims 需要什么版本的 Node\.js？

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

### @doguyilmaz/aims 可以商用吗？

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

### @doguyilmaz/aims 还在维护吗？

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