>_ BEENETAI Developer guide
BEENETAI / AI coding clients / 2026

Codex 和 Claude Code，装好就能接入 BEENETAI。

给 BEENETAI 用户的 Windows 和 macOS 安装指南：覆盖桌面端、CLI、API Key 与 CC Switch，从安装到第一个只读任务一步完成。

开始选择入口 ↓ 获取 BEENETAI Key ↗
02产品
04安装入口
01Key 工作流
beenetai-setup / local
# choose a client
$ Codex Desktop
$ Codex CLI
$ Claude Desktop
$ Claude Code CLI

# BEENETAI endpoints
$ Codex  → https://beenetai.com/v1
$ Claude → https://beenetai.com
ready when your workspace is ready
i

这是一份给 BEENETAI 用户的实用安装指南：先选择 Codex 或 Claude，再选择 Desktop 或 CLI，最后按客户端需要配置 BEENETAI Key 或 CC Switch。应用界面和可用模型可能随版本变化，遇到差异时以官方文档和应用内提示为准。

01 / choose your surface

先选产品，再选入口

BEENETAI 负责 Key 和 API 网关；安装方式按产品分开。桌面端偏图形化使用，CLI 偏终端、远程开发和自动化。

CODEX · DESKTOP

Codex 桌面端

适合并行管理任务、审阅 diff 和查看多个工作区。按系统官方渠道安装。

CODEX · CLI

Codex 命令行

适合终端开发、脚本和远程机器。需要 Node.js，直接在项目目录启动。

CLAUDE · DESKTOP

Claude 桌面端

适合 Windows / macOS 图形化使用。先从 Claude 官方下载页获取客户端。

打开下载页 ↗
CLAUDE · CODE CLI

Claude Code 命令行

适合连接 BEENETAI API、远程开发和自动化。推荐配合环境变量或 CC Switch。

02 / install

安装 Codex

Desktop 和 CLI 是两种独立入口，通常选择其中一种即可。偏好图形界面选 Desktop；习惯终端、远程开发或自动化则选 CLI。

Option A · Desktop

Codex Desktop

从 Microsoft Store 安装桌面应用，打开后按提示登录并选择项目目录。不需要先安装 Node.js。

适合：希望使用图形界面、并行管理任务和直观看 diff 的用户。

打开 Microsoft Store ↗
Option B · CLI

Codex CLI

需要 Node.js LTS 环境。在 PowerShell 中安装，完成后重新打开终端并检查版本。

适合：习惯终端、远程开发、脚本和自动化工作流的用户。

npm i -g @openai/codex
codex --version
Option A · Desktop

Codex Desktop

从 OpenAI 官方 Codex 页面获取 macOS 桌面应用，安装后按提示登录并选择项目目录。

适合：希望使用图形界面、并行管理任务和直观看 diff 的用户。

打开官方 Codex 页面 ↗
Option B · CLI

Codex CLI

需要 Node.js LTS 环境。在 Terminal 中安装，完成后检查版本，再进入项目目录使用。

适合：习惯终端、远程开发、脚本和自动化工作流的用户。

npm i -g @openai/codex
codex --version
03 / authenticate

登录与认证

Codex 的认证方式取决于你使用的产品入口。优先使用官方登录流程；只有明确使用 API 直连时，才配置 API Key。

A

使用 ChatGPT / Codex 账号登录

启动桌面端或在终端执行 codex，根据屏幕提示完成浏览器登录。登录后返回应用，确认当前账号和工作区。

B

使用 API Key 时，放在环境变量里

API Key 不要写入项目文件、截图、聊天记录或提交到 Git。Windows 可以在 PowerShell 中设置当前用户变量：

$env:OPENAI_API_KEY = "你的_API_Key"

macOS / Linux：

export OPENAI_API_KEY="你的_API_Key"
C

确认认证状态

在项目目录启动 Codex，并发送一个只读问题，例如“请概述这个项目的目录结构”。不要一开始就让它批量删除或重写文件。

cd your-project
codex
安全提醒：BEENETAI 是 API 网关，不会替你生成或托管 OpenAI API Key。请在官方平台创建和管理密钥，并定期轮换；如果怀疑泄露，立即撤销旧 Key。
04 / claude desktop + code

安装 Claude Desktop / Claude Code

Claude Desktop 适合图形化使用，Claude Code 适合终端和自动化。若目标是接入 BEENETAI API，优先使用 Claude Code CLI 或 CC Switch。

CLAUDE DESKTOP

桌面端安装

Windows 和 macOS 从 Claude 官方下载页获取安装包，安装后按应用提示登录。

打开 Claude 下载页 ↗
WINDOWS

PowerShell 安装

优先使用 Claude 官方安装脚本；安装完成后重新打开 PowerShell。

irm https://claude.ai/install.ps1 | iex
MACOS / LINUX / WSL

终端安装

在 Terminal、Linux Shell 或 WSL 中执行官方安装脚本。

curl -fsSL https://claude.ai/install.sh | bash
NPM FALLBACK

Node.js 安装

如果系统策略不允许脚本安装，可以使用 npm 作为备用方式。

npm install -g @anthropic-ai/claude-code
Claude Desktop 的可用登录方式和自定义 Endpoint 能力取决于应用版本。不要把 BEENETAI Key 粘贴到未经确认的字段；需要通过 BEENETAI API 调用时，使用下面的 Claude Code CLI 配置。
1

检查 Claude Code

安装完成后确认命令可执行，再启动交互式终端。

claude --version
claude
2

Windows 连接 BEENETAI

把下面的模型名替换成 BEENETAI 账户中可用的 Claude 模型。

$env:ANTHROPIC_BASE_URL = "https://beenetai.com"
$env:ANTHROPIC_API_KEY = "sk-你的_BEENETAI_Key"
$env:ANTHROPIC_MODEL = "你的模型名"
claude
3

macOS / Linux / WSL 连接 BEENETAI

这些变量只对当前终端窗口生效，适合先验证配置。

export ANTHROPIC_BASE_URL="https://beenetai.com"
export ANTHROPIC_API_KEY="sk-你的_BEENETAI_Key"
export ANTHROPIC_MODEL="你的模型名"
claude
Claude 的 Base URL 填 `https://beenetai.com`，不要手动再加 `/v1`。BEENETAI 的 Claude 路由是 `/v1/messages`，Claude 客户端会自动拼接版本路径；OpenAI/Codex 配置才使用 `https://beenetai.com/v1`。
05 / import your key

把 BEENETAI 的 Key 导入客户端

Key 在 BEENETAI 的 `/keys` 页面创建和复制。网页教程不会保存你的真实 Key，下面的命令也只使用占位符。

A

进入 API Keys 页面

登录 BEENETAI，打开 https://beenetai.com/keys，创建一条新的 API Key，并设置合适的额度和模型权限。

B

复制完整 Key

Key 列通常只显示脱敏值。点击 Key 旁边的复制按钮，或打开行操作菜单选择“Copy Key”；复制到的是完整的 `sk-...` 值。不要把脱敏文本当作真实 Key 使用。

C

导入 Codex / OpenAI 兼容客户端

OpenAI 兼容接口的地址需要包含 `/v1`。PowerShell：

$env:OPENAI_BASE_URL = "https://beenetai.com/v1"
$env:OPENAI_API_KEY = "sk-你的_BEENETAI_Key"

macOS / Linux：

export OPENAI_BASE_URL="https://beenetai.com/v1"
export OPENAI_API_KEY="sk-你的_BEENETAI_Key"
D

导入 Claude Code

Claude Code 使用上一节的 `ANTHROPIC_BASE_URL` 和 `ANTHROPIC_API_KEY`。不要把同一个 Key 写进项目源码、`.env` 提交记录或截图。

真实 Key 等同于访问凭据。网页不会替你上传 Key；只在本机环境变量、密码管理器或 CC Switch 的本地配置中保存，泄露后立即回到 `/keys` 禁用或删除。
06 / cc switch

用 CC Switch 管理 Claude 和 Codex

BEENETAI 已经支持 CC Switch 导入协议，可以从 API Key 行操作菜单直接生成配置；也可以在 CC Switch 里手动添加。

1

安装 CC Switch

从 CC Switch 官方页面获取对应系统版本：

打开 CC Switch 官网 ↗
2

从 BEENETAI 一键导入

打开 BEENETAI 的 `/keys`，在目标 Key 的行操作菜单选择“CC Switch”。选择应用、配置名称和主模型后点击“打开 CC Switch”。Claude 会使用 `https://beenetai.com`，Codex 会自动使用 `https://beenetai.com/v1`。

3

导入后检查三项

在 CC Switch 中确认应用类型、Endpoint 和模型名。先用一个只读任务测试，再开始修改项目。

CCSWITCH://IMPORT

手动生成 CC Switch 导入链接

只在本机填写真实 Key；链接包含 Key，生成后不要分享。

填写模型和 Key 后生成 ccswitch:// 导入链接

规则与 BEENETAI 后台一致：Claude / Gemini 使用站点根地址，Codex 使用根地址加 `/v1`。如果你部署的是自己的 New API，只需把地址换成自己的域名。

07 / first task

用一个小任务验证环境

先做能在几分钟内验收的只读任务，确认 Codex 或 Claude Code 能读项目、理解环境并正确调用模型。

01 · READ

理解项目

“请阅读 README 和入口文件，告诉我启动命令，不要修改文件。”

02 · CHANGE

小范围修改

“给健康检查接口增加一个测试，先说明计划，再修改。”

03 · VERIFY

运行验证

“运行相关测试，汇总通过项、失败项和未覆盖风险。”

推荐工作节奏：先让 Codex 解释计划，再允许写入；每次任务完成后查看 diff 和测试输出，最后由你决定是否保留改动。
08 / guardrails

权限与安全边界

AI 编程工具能执行真实命令，也可能接触项目机密。把权限控制当成安装的一部分。

  • 从非敏感的小项目开始
  • 不要把 `.env`、密钥、生产凭据交给任务
  • 先看计划，再允许写文件
  • 每次修改后审阅 Git diff
  • 删除、部署、支付等动作必须人工确认
  • 用 `.gitignore` 排除本地配置和日志
09 / troubleshooting

常见问题

安装后提示 “codex 不是内部或外部命令”

重新打开终端，让 PATH 重新加载；确认 Node.js 和 npm 已安装，再执行 npm prefix -g 检查全局命令目录是否在 PATH 中。

桌面端和 CLI 应该选哪个？

需要并行任务、工作区和图形化审阅时选桌面端；习惯终端、远程开发或需要脚本化、接入 BEENETAI API 时选 CLI。两者可以同时使用。

我应该把 API Key 填到哪里？

优先使用产品提供的官方登录流程。使用 API Key 时放到本机环境变量或受保护的密钥管理器中，不要放在 README、前端代码、截图或 Git 仓库里。

Codex 修改了文件，但我不确定是否正确

先查看 diff，再运行项目已有的格式化、类型检查和测试命令。要求 Codex 解释每处修改的原因，并只保留你能理解和验收的变化。

网络或登录流程打不开怎么办？

确认系统浏览器能访问官方登录页面，检查系统时间、代理和安全软件设置；不要从非官方来源下载所谓的“免登录版”或替换认证文件。

↗

继续阅读：BEENETAI API Keys · OpenAI Codex 官方文档 · Claude 下载页