PhanthyCode CLI 使用指南

CLI 适合什么工作

PhanthyCode CLI 面向开发者和终端优先用户，适合在代码仓库中理解、修改、测试和审查代码。它与 PhanthyCode 工作台共享 Phanthy 账号、积分、模型访问和本地 Core。

安装

curl -fsSL https://code.phanthy.com/install.sh | bash

irm https://code.phanthy.com/install.ps1 | iex

npm install -g @phanthy/phanthy-code

phanthy-code --version

登录

1. 运行登录命令并在浏览器中完成 Phanthy OAuth 授权
2. 授权成功后回到终端
3. 确认 CLI 已同步当前账号、积分和可用模型

phanthy-code auth login

第一次运行

1. 从目标仓库启动，不要从包含大量无关个人文件的上级目录启动
2. 说明具体目标、允许修改的范围和禁止事项
3. 要求运行相关测试或检查命令
4. 完成后检查文件差异、测试结果、剩余风险和回滚方式

cd path/to/your-project
phanthy-code

工作目录与权限

从最小必要权限开始：先允许读取，再根据任务需要允许修改和运行命令。删除、覆盖、发布、外部写入或付费操作应单独确认。不要把密码、密钥或令牌写入提示词和日志。

模型、Auto 模式与共享 Core

日常编辑可优先选择低倍率模型，复杂架构、疑难调试和长上下文任务再使用更高能力模型。Auto 模式只会在账户允许的公开模型范围内路由，实际模型和积分扣减以请求记录为准。

工作台与 CLI 可以共享 ~/.phanthy-code 中的本地配置与会话能力。修改配置前先备份，不要复制其他用户的令牌。

更新与卸载

通过官方脚本安装的版本可再次运行对应脚本；通过 npm 安装的版本使用 npm 更新。更新后运行版本命令确认。卸载前确认没有正在执行的任务，并保留必要的非敏感配置。

故障排查

1. 确认 CLI 版本、系统和稳定错误码
2. 区分登录授权、账户套餐、积分、模型不可用、上游失败或超时
3. 使用最小样例重试并记录复现步骤
4. 提交反馈前删除 Authorization、x-api-key、刷新令牌和其他凭据