sssaicode - AI 代理工具

sssaicode 是一个强大的 AI 代理工具，为 Claude API 提供稳定可靠的代理服务。

核心特性

• 🛡️ 安全沙盒: macOS 沙盒模式，保护文件系统安全
• 📊 灵活配置: 支持环境变量和配置文件
• 🔄 自动更新: 版本检查和自动更新功能

快速开始

安装

# 使用 npm 安装
npm install -g @sssaicode/claude

# 或使用国内镜像
npm install -g @sssaicode/claude --registry=https://registry.npmmirror.com

基本使用

# 首次运行会提示输入 Token
sssaicode

# 或使用环境变量指定 Token
export CLAUDE_CLIENT_TOKEN=your-token
claude

Token 管理

sssaicode 采用智能的 Token 管理机制，按以下优先级获取 Token：

1. 环境变量 - CLAUDE_CLIENT_TOKEN
2. 配置文件 - ~/.claude/sssaicode.json
3. 交互输入 - 提示用户输入并验证

Token 验证流程

• 启动时自动验证 Token 有效性
• 无效 Token 会被拒绝并提示重新输入
• 有效 Token 自动保存到配置文件
• 支持服务端验证确保安全性

配置选项

命令行参数

claude [选项] [-- 目标命令 [参数...]]

选项:
  --help, -h         显示帮助信息
  --no-sandbox       禁用沙盒模式（macOS 默认启用）
  --raw              原始连接模式

环境变量

| 变量名 | 说明 | 默认值 | |--------|------|--------| | CLAUDE_CLIENT_TOKEN | 客户端认证 Token | 无 | | CLAUDE_NO_SANDBOX | 设置为 1 禁用沙盒模式 | 无 |

配置文件

配置文件位置：~/.claude/sssaicode.json

{
  "token": "your-client-token"
}

沙盒模式

在 macOS 系统上，sssaicode 默认启用沙盒模式以保护系统安全：

• 限制文件系统访问权限
• 仅允许访问当前工作目录
• 自动处理权限请求

# 禁用沙盒模式
claude --no-sandbox

# 或通过环境变量
CLAUDE_NO_SANDBOX=1 claude

使用示例

基础使用

# 使用已保存的 Token 启动
claude

# 首次使用，输入 Token
claude
# 提示: 请输入 CLAUDE_CLIENT_TOKEN: your-token

故障排查

Token 相关问题

1. Token 验证失败

   • 确认 Token 输入正确
   • 检查网络连接
   • 验证服务器地址是否正确

2. Token 不保存

   • 检查 ~/.claude 目录权限
   • 确认磁盘空间充足

启动问题

1. 沙盒模式问题
   • 仅 macOS 支持沙盒模式
   • 使用 --no-sandbox 禁用

License

MIT License - 详见 LICENSE 文件