词元社 Docs

新手必看教程

把模型接入流程,整理成一条清楚的路。

按顺序完成令牌创建、环境配置和编辑器选择。页面已保留原教程内容,并重新设计为更易扫读的本地文档站。

配置流程预览
API 密钥页面截图
导入到 CC Switch 操作截图
模型选择截图
生成 API Key进入词元社控制台创建令牌 keys 联系客服人工在线时间 09:00-24:00 QQ
第一步

登录后台,创建令牌

在词元社后台创建 API Key,并确认账户有可用额度。后续配置工具和编辑器都会用到这个令牌。

1

进入 API 密钥页面

登录 词元社后台,点击左侧菜单「API 密钥」,再点击右上角「创建密钥」。

在 API 密钥页面创建新的访问令牌。
2

填写名称并选择分组

输入密钥名称,选择模型分组,例如 GPT-Plus 号池。其他选项不用填,直接创建即可。

密钥创建后请妥善保存,后面会写入配置。
3

充值额度

支持在线充值和兑换码充值。完成充值后,再继续第二步配置。

确保账户有额度,后续调用模型才不会中断。
第二步

配置本地环境

推荐先使用一键配置。需要自定义、排查问题或在 macOS/Linux 上手动操作时,再切换到手动配置。

Windows 便携版

下载后打开 CC Switch,再回到控制台点击「导入到 CCS」。

本地已镜像 v3.14.1
下载 Windows 工具

macOS 安装包

适用于 macOS 的 CC Switch 安装包,下载后按提示完成安装。

本地已镜像 v3.15.0
下载 macOS 工具
1

一键导入到 CC Switch

必须先下载并打开 CC Switch 软件。打开后回到网页,点击操作栏里的「导入到 CCS」。

导入按钮会把供应商配置写入 CC Switch。
2

确认导入配置

弹出确认窗口后,核对供应商信息,点击「导入」完成配置。

确认供应商信息后再导入。
3

编辑并选择模型

导入成功后,在 CC Switch 主界面点击「编辑」,进入编辑页面选择你需要使用的模型。

点击编辑进入模型设置。
选择模型后保存配置。
4

启用配置

回到主页面点击「启用」,启用后再打开 Codex 或 VS Code 就可以使用。

启用当前配置,完成本地环境接入。
1

安装 Node.js

先安装 Node.js v22 或更高版本,建议使用默认安装路径。

打开 Node.js 官网
2

安装 Codex

打开 CMD,复制下面命令回车。

3

下载并配置 CC Switch

下载后打开安装程序,按向导完成安装。打开 CC Switch 后添加词元社配置即可。

下载 CC Switch
按安装向导继续。
添加词元社供应商配置。
1

安装 Node.js 与 Codex

安装 Node.js v22 或更高版本,然后在终端执行安装命令。

2

配置 config.toml

终端输入 open -e ~/.codex/config.toml,粘贴以下内容。

config.toml
model_provider = "custom"
model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true

[model_providers.custom]
name = "custom"
wire_api = "responses"
requires_openai_auth = true
base_url = "https://api.ciyuanshe.cn/v1"

[features]
multi_agent = true
3

配置 auth.json

终端输入 open -e ~/.codex/auth.json,把密钥替换成自己的。

auth.json
{
  "OPENAI_API_KEY": "您的密钥"
}
1

安装 Node.js 与 Codex

安装 Node.js v22 或更高版本,然后执行安装和验证命令。

2

写入配置文件

配置文件路径为 ~/.codex/config.toml~/.codex/auth.json。内容与 macOS 示例相同。

!

请先完成第二步配置。配置完成后再进入编辑器教程,否则可能会遇到报错或无法连接。

第三步

选择编辑器开始使用

环境配置完成后,选择一个适合自己的入口。新手可以先用 Codex,日常开发更习惯 VS Code 的可以走插件方案。

新手友好

Codex 使用教程

下载安装到设置中文、选择模型、发送测试消息,一页完成。

开发者常用

VS Code 使用教程

安装中文语言包、Codex 或 Claude Code 插件,并从侧边栏入口开始使用。