使用指南

产品简介

艾坞AI智能助手（以下简称“艾坞”）是 OpenAI Codex CLI 的桌面图形界面工具。它把命令行版本的 Codex 封装成可视化窗口，提供图形化对话、会话历史、工作目录管理、沙箱审批等界面能力。

艾坞本身不是 AI 模型，也不提供模型推理服务，所有 AI 能力均来自你本机安装的 Codex CLI 及其背后的 OpenAI 服务。

重要说明：仅支持 Codex CLI

• 艾坞是 Codex CLI 的图形界面，本身不内置模型、不代理推理；密钥与登录均由 Codex 管理，既支持官方 ChatGPT / OpenAI，也支持兼容 OpenAI Responses API 的第三方服务。
• 你需要自行安装 Codex CLI，并登录自己的 ChatGPT 账号（Plus / Pro / Business / Enterprise）或使用 OpenAI API Key，相关费用由你与 OpenAI 之间结算。
• 艾坞启动时会自动检测 Codex：优先使用你本机已安装的版本，找不到时才使用软件内置的 Codex。

安装 Codex CLI

根据你的操作系统选择对应标签页，复制命令执行即可。以下安装方式均来自 OpenAI 官方文档。

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

curl -fsSL https://chatgpt.com/codex/install.sh | sh

brew install --cask codex

curl -fsSL https://chatgpt.com/codex/install.sh | sh

npm install -g @openai/codex

验证安装

在终端执行以下命令，能显示版本号即安装成功：

codex --version

登录 Codex

登录由 Codex 完成，艾坞直接读取其登录状态。你可以使用 OpenAI 官方账号，也可以接入第三方 API 服务。

方式一：OpenAI 官方账号

在终端运行：

codex login

• Sign in with ChatGPT（推荐）：按提示在浏览器登录 ChatGPT，使用资格包含在 Plus / Pro / Business / Enterprise 套餐中。
• API Key：填入 OpenAI API Key，用量按 OpenAI API 计费。

方式二：第三方 API 服务

任何兼容 OpenAI Responses API 的服务商都可以使用。常用选择（注册后在控制台创建密钥并充值）：

• OpenRouter：聚合 OpenAI、Anthropic、Google 等多家模型，openrouter.ai · 创建密钥 · Codex 可用模型
• 火山方舟（编程套餐）：字节跳动旗下，Coding Plan 专为 Codex 优化、国内网络直连，产品介绍 · 控制台开通与密钥
• Azure OpenAI：微软官方企业服务，需企业资质申请，前往 Azure

setx OPENROUTER_API_KEY "sk-or-你的密钥"

model_provider = "openrouter"
model = "~openai/gpt-sol-latest"
model_reasoning_effort = "high"

[model_providers.openrouter]
name = "openrouter"
base_url = "https://openrouter.ai/api/v1"

[model_providers.openrouter.auth]
command = "powershell"
args = ["-NoProfile", "-Command", "Write-Output $env:OPENROUTER_API_KEY"]

setx ARK_API_KEY "你的方舟密钥"

model_provider = "volcengine-coding-plan"
model = "ark-code-latest"
model_supports_reasoning_summaries = true

[model_providers.volcengine-coding-plan]
name = "volcengine-coding-plan"
base_url = "https://ark.cn-beijing.volces.com/api/coding/v3"
env_key = "ARK_API_KEY"
wire_api = "responses"

export OPENROUTER_API_KEY="sk-or-你的密钥"

model_provider = "openrouter"
model = "~openai/gpt-sol-latest"
model_reasoning_effort = "high"

[model_providers.openrouter]
name = "openrouter"
base_url = "https://openrouter.ai/api/v1"

[model_providers.openrouter.auth]
command = "sh"
args = ["-c", "echo $OPENROUTER_API_KEY"]

export ARK_API_KEY="你的方舟密钥"

model_provider = "volcengine-coding-plan"
model = "ark-code-latest"
model_supports_reasoning_summaries = true

[model_providers.volcengine-coding-plan]
name = "volcengine-coding-plan"
base_url = "https://ark.cn-beijing.volces.com/api/coding/v3"
env_key = "ARK_API_KEY"
wire_api = "responses"

配置完成后重新打开艾坞即可，凭据由 Codex 管理，无需在艾坞内重复登录。配置中的 model 一行，可替换为该服务商支持的其他模型（OpenRouter 见 Codex 模型列表，火山方舟见控制台的模型说明）。

使用艾坞

1. 安装客户端从官网下载并安装艾坞（Windows 安装包）。
2. 登录艾坞账号打开艾坞，登录 / 注册账号，用于会员管理与订单服务。
3. 选择工作目录在左侧“工作目录”点击“浏览”选择项目文件夹，AI 只能读写该目录及你额外授权的输出目录。
4. 开始对话点击“新建对话”，在底部输入框用自然语言描述需求，回车发送即可。

会员与退款

• 新用户注册后自动开启免费试用（试用时长以客户端左下角提示为准），试用期内可使用完整功能，到期后可开通会员继续使用。
• 艾坞提供会员套餐（月卡 / 季卡 / 年卡 / 永久会员），点击左下角“续费/升级”，微信扫码支付后自动开通。
• 申请退款：点击左下角“账户” → “退款 / 售后”，选择对应订单并填写退款原因提交。
• 退款申请通常在 1-3 个工作日内审核；审核通过后款项按原支付路径退回（微信支付原路退回）。
• 如有疑问，可通过微信公众号或客服渠道联系我们。

常见问题