CodeT 使用文档丨 CodeT 使用文档

本文档介绍如何通过 CodeT 平台分配的 Token 安装、使用 CodeT（Claude Code / Codex CLI），以及日常合规检测、环境修复与故障排查方法。

注意

每个 Token 对应一份专属安装脚本，内嵌您的 API 密钥，请勿分享给他人。

1. 安装指南

1.1 获取安装命令

管理员在 CodeT 平台后台为您创建 Token 后，安装命令如下：

Mac / Linux：

curl -fsSL https://aiapi.corrin.cc/install/sk-您的Token | bash

Windows（以管理员身份打开 PowerShell）：

irm https://aiapi.corrin.cc/install/sk-您的Token | iex

说明

中间件会根据请求的 User-Agent 自动识别操作系统并分发对应脚本。若自动识别失败，可在 URL 后追加 ?ps1=1 强制获取 PowerShell 脚本，例如 irm https://aiapi.corrin.cc/install/sk-您的Token?ps1=1 | iex。

1.2 执行安装

操作步骤：

打开终端（Mac/Linux）或以管理员身份打开 PowerShell（Windows）。
粘贴并执行安装命令。
在弹出的交互式菜单中输入数字选择安装工具：

╔════════════════════════════════╗
║    CodeT — 安装向导            ║
╚════════════════════════════════╝

  用户: <您的用户ID>

  请选择要安装的工具:

    1)  Claude Code — Anthropic AI 编程助手
    2)  Codex CLI   — OpenAI AI 编程助手
    3)  两者都安装
    0)  退出

等待安装完成。

预期结果：

终端显示 ✅ 安装完成！ 字样，并提示可用命令。

1.3 重新加载终端

操作步骤：

重启终端，或执行以下命令使 PATH 配置生效：

source ~/.zshrc    # macOS
source ~/.bashrc   # Linux

Windows 上重新打开 PowerShell 窗口即可。

2. 日常使用

安装完成后，在终端输入以下命令即可使用：

claude    # 启动 Claude Code
codex     # 启动 Codex CLI

启动器会自动处理遥测清理与环境变量设置，无需手动干预。

3. 合规检测

3.1 执行检测

操作步骤：

在终端执行以下命令：

curl -fsSL https://aiapi.corrin.cc/check/check.sh | bash

检测项说明：

序号	检测项	通过条件
1	时区	非亚洲时区（CST/HKT/SGT/JST/KST 视为不通过）
2	遥测阻断	`statsig.anthropic.com`、`sentry.io`、`datadoghq.com` 解析到 `127.0.0.1`
3	cac	已安装 `claude-cac`
4	API 网关	`https://aiapi.corrin.cc/health` 返回 `ok`

预期结果：

所有检测项通过，终端显示 ✅ 全部通过！。

3.2 检测结果不通过时的处理

如果检测未通过，请参见第 4 章修复环境。

4. 修复环境

4.1 一键修复

如果合规检测未通过，或 Claude Code / Codex CLI 出现异常，可执行一键修复：

curl -fsSL https://aiapi.corrin.cc/check/fix.sh | sudo bash

4.2 使用修复接口

通过修复接口可获取个性化修复脚本（内嵌您的 Token）：

Mac / Linux：

curl -fsSL -H "x-api-key: sk-您的Token" https://aiapi.corrin.cc/install/repair | bash

Windows（PowerShell，以管理员身份运行）：

$h = @{ "x-api-key" = "sk-您的Token" }
(irm -Headers $h https://aiapi.corrin.cc/install/repair?ps1=1) | iex

5. 故障排查

5.1 错误码说明

HTTP 状态码	错误码	说明	解决方案
401	`INVALID_TOKEN`	Token 无效	检查 Token 是否正确，联系管理员重新发放
402	`QUOTA_EXHAUSTED`	Token 额度已用尽	联系管理员充值或更换 Token
403	`BANNED`	Token 或 IP 已被封禁	联系管理员解封；若因同一 Token 在超过 3 个 IP 上使用触发异常检测，封禁 24 小时后自动解除（见 6.1）
403	`INVALID_CLIENT`	User-Agent 不合规	确保使用启动器启动 Claude Code 或 Codex CLI
403	`CAC_REQUIRED`	Claude Code 未携带 cac 头	确保通过随安装脚本安装的启动器启动 Claude Code；若仍报错，执行一键修复
429	`RATE_LIMITED`	请求频率超过限制	降低请求频率，等待一分钟后重试

5.2 网络连接失败

现象： 启动器提示无法连接，或合规检测中 API 网关项不通过。

处理步骤：

测试与安全网关的连通性：

curl -sk https://aiapi.corrin.cc/health

如果超时，检查本机网络与 DNS：

nslookup aiapi.corrin.cc
ping -c 3 aiapi.corrin.cc

5.3 Windows 下 PowerShell 脚本执行被策略阻止

现象： 执行 irm | iex 时报错 无法加载文件，因为在此系统上禁止运行脚本。

处理步骤：

以管理员身份打开 PowerShell，临时放宽执行策略：

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

重新执行安装命令。

预期结果： 脚本正常执行。该策略仅在当前 PowerShell 会话有效，关闭窗口后自动恢复。

6. 常见问题

6.1 可以在多台电脑上使用同一个 Token 吗？

可以，但同一个 Token 最多只能在 3 个不同 IP 上使用。超过会触发异常检测，导致 Token 被封禁 24 小时。

6.2 如何卸载？

Mac / Linux：

# 1. 删除安装目录与 cac 环境
rm -rf ~/.claude-relay
rm -rf ~/.cac/envs/claude-relay

# 2. 清理 shell 配置中的 PATH 项
sed -i.bak '/# === claude-relay ===/,/# === end/d' ~/.zshrc

# 3. 清理 /etc/hosts 中的遥测屏蔽规则
sudo sed -i.bak '/claude-relay telemetry block/,/end/d' /etc/hosts

Windows（PowerShell，以管理员身份运行）：

# 1. 删除安装目录与 cac 环境
Remove-Item -Recurse -Force "$env:USERPROFILE\.claude-relay"
Remove-Item -Recurse -Force "$env:USERPROFILE\.cac\envs\claude-relay"

# 2. 从用户 PATH 中移除 bin 目录
$p = [Environment]::GetEnvironmentVariable("PATH", "User") -split ";" | Where-Object { $_ -notlike "*claude-relay*" }
[Environment]::SetEnvironmentVariable("PATH", ($p -join ";"), "User")

# 3. 清理 hosts 中的遥测屏蔽规则（手动编辑或运行以下命令）
$hostsFile = "$env:SystemRoot\System32\drivers\etc\hosts"
$content = Get-Content $hostsFile
$content | Where-Object { $_ -notmatch "claude-relay telemetry block|statsig\.anthropic\.com|sentry\.io|datadoghq\.com|statsigapi\.net|api\.statsig\.com|end ===" } | Set-Content $hostsFile

6.3 Windows 可以使用吗？

可以，原生支持 Windows 10 / 11。以管理员身份打开 PowerShell，执行：

irm https://aiapi.corrin.cc/install/sk-您的Token | iex

6.4 重装系统后如何恢复？

重新运行安装命令即可，脚本会自动覆盖旧配置：

# Mac / Linux
curl -fsSL https://aiapi.corrin.cc/install/sk-您的Token | bash

# Windows
irm https://aiapi.corrin.cc/install/sk-您的Token | iex