EasyCode使用手册
模型广场 ↗返回控制台 ↗
下载与安装

Windows 从零接入

适合 Windows 10 / 11:下载、安装、复制配置、发送第一句话。

开始前:先准备自己的密钥

还没复制密钥的话,先完成 创建 API 密钥,再回来。下面所有命令都在你自己的 Windows 电脑上运行。

1. 下载并安装 Node.js

Node.js 官方下载

选择 LTS、Windows、.msi 安装包。普通 Intel / AMD 电脑选 x64。

官方下载 ↗
  1. 打开下载页,选择 Windows 的 LTS 安装包(.msi)。
  2. 双击下载的文件,按 Next → 接受许可 → Next → Install 安装,保留默认选项。
  3. 安装结束点击 Finish。已经打开的终端全部关闭,然后重新打开。

2. 打开命令提示符,检查安装

点击屏幕下方“开始”,输入 cmd,打开“命令提示符”。会出现可以输入文字的窗口。复制下面两行,粘贴到这个窗口,按回车:

Windows 命令提示符(CMD)
node -v
npm -v
做到这里应该看到

分别显示版本号,例如以 v 开头的 Node.js 版本和一个 npm 版本数字。出现“无法识别”时,先重开命令提示符;仍不行则重新安装 Node.js。

3. 安装 Codex

继续在同一个命令提示符窗口执行。安装时会下载文件,等到重新出现可输入命令的一行后再继续。

Windows 命令提示符(CMD)
npm install -g @openai/codex
codex --version
做到这里应该看到

显示 Codex 的版本号,说明通过 npm 安装的 CLI 已可运行。

4. 打开配置文件

另开一个窗口:开始菜单搜索 PowerShell 并打开。复制这两行到 PowerShell,回车后会打开记事本:

Windows PowerShell
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.codex" | Out-Null
notepad "$env:USERPROFILE\.codex\config.toml"

如果记事本提示文件不存在,选择创建。新手第一次使用时,把下面整块内容复制到记事本中:

config.toml · 复制到记事本
model = "gpt-6.1-sol"
model_provider = "easycode"

[model_providers.easycode]
name = "EasyCode"
base_url = "https://easycodesi.com/v1"
wire_api = "responses"
env_key = "EASYCODE_API_KEY"
requires_openai_auth = false
supports_websockets = false
  1. 按 Ctrl + S 保存。
  2. 如出现“另存为”:文件名填 config.toml,保存类型选“所有文件”,编码选 UTF-8,保存在用户目录的 .codex 文件夹。
  3. 确认文件不是 config.toml.txt,然后关闭记事本。

5. 填入并保存你的密钥

把第一行引号里的 sk-替换为你的密钥 整段换成你自己的完整密钥,再在刚才的 PowerShell 窗口复制执行。第二行会保存到你当前 Windows 用户的环境变量,以后打开软件还可以读取。

Windows PowerShell
$env:EASYCODE_API_KEY="sk-替换为你的密钥"
[Environment]::SetEnvironmentVariable("EASYCODE_API_KEY", $env:EASYCODE_API_KEY, "User")

执行后没有文字输出通常是正常的。不要把包含真实密钥的窗口截图发给别人。

6. 创建练习文件夹并启动

关闭旧的命令提示符,重新从开始菜单打开 cmd / 命令提示符,以便读取刚保存的密钥。复制执行:

Windows 命令提示符(CMD)
if not exist "%USERPROFILE%\easycode-demo" mkdir "%USERPROFILE%\easycode-demo"
cd /d "%USERPROFILE%\easycode-demo"
codex

首次询问是否信任文件夹时,确认路径是刚创建的 easycode-demo,按提示确认。如果询问权限,保留默认设置。在输入区输入下面这句话并回车:

在 Codex 对话框里输入
请只回复:连接成功
做到这里应该看到

Codex 给出一条回复。然后在 本站使用记录 ↗ 里找到刚才的请求。测试会按本站规则计费。

7. 明天怎么再次使用

关闭旧窗口后,重新打开命令提示符(CMD),输入 codex 并回车即可。需要处理自己的项目时,先进入项目文件夹,再启动。

处理代码项目:安装 Git

Git for Windows

打开官方下载页,选择 x64 Setup;ARM 电脑选 ARM64。

官方下载 ↗

双击安装包,按 Next 使用默认选项安装。完成后重新打开 PowerShell,输入 git --version,看到版本号即安装成功。

卡在某一步?

  • 提示“禁止运行脚本”:从开始菜单打开命令提示符(CMD),再输入 npm 或 codex。
  • 提示缺少 EASYCODE_API_KEY:返回第 5 步保存用户环境变量,再重新打开命令提示符。
  • 一直要求登录:返回第 4 步检查文件名、保存位置和顶部两行是否正确。
  • 认证失败或额度不足:到本站检查密钥是否启用,以及账户余额。