快速开始 | 同思智算

Codex Desktop 快速使用

运行安装命令后重启应用即可开始。

Codex CLI 快速使用

一条命令完成配置，直接在终端继续工作。

Claude Code 快速使用

安装后在项目目录启动 Claude Code。

API/SDK 调用

使用 OpenAI 或 Anthropic SDK 接入你的应用。

使用 CC Switch 快速接入

准备 API Key

打开 https://ai.tos.run，在 API Key 管理页创建一个 Key。Key 以 gk_ 开头，只会完整展示一次，请立即保存。不要截图、分享或提交到仓库；如疑似泄露，请立即在控制台撤销并重新生成。

Codex Desktop 快速使用

Codex Desktop 仅支持 macOS 和 Windows；Linux 请使用下一节 Codex CLI。

按照 Codex Desktop 官方安装指南完成安装，或直接下载对应安装包：
打开 Codex Desktop 后，将 gk_YOUR_KEY 替换为刚创建的 Key，执行以下配置命令：

curl -fsSL https://tos.run/install/codex.sh | bash -s -- --key gk_YOUR_KEY

iwr https://tos.run/install/codex.ps1 -OutFile setup-codex.ps1
.\setup-codex.ps1 -Key gk_YOUR_KEY

完成后重启 Codex Desktop，打开或新建一个工作区后即可开始对话与编码。

Codex CLI 快速使用

未安装 Codex CLI 时，请先安装 Node.js（官方下载页），并确认以下命令可用：

node --version
npm --version

再执行：

npm install -g @openai/codex

然后将 gk_YOUR_KEY 替换为刚创建的 Key：

curl -fsSL https://tos.run/install/codex.sh | bash -s -- --key gk_YOUR_KEY

iwr https://tos.run/install/codex.ps1 -OutFile setup-codex.ps1
.\setup-codex.ps1 -Key gk_YOUR_KEY

重新打开终端，然后在项目目录运行：

codex

Claude Code 快速使用

未安装 Claude Code 时，请先安装 Node.js（官方下载页），并确认以下命令可用：

node --version
npm --version

再执行：

npm install -g @anthropic-ai/claude-code

然后将 gk_YOUR_KEY 替换为刚创建的 Key：

curl -fsSL https://tos.run/install/claude.sh | bash -s -- --key gk_YOUR_KEY

iwr https://tos.run/install/claude.ps1 -OutFile setup-claude.ps1
.\setup-claude.ps1 -Key gk_YOUR_KEY

重新打开终端，然后在项目目录运行：

claude

CC Switch 快速接入

从 CC Switch 中文官网或最新发行版安装并打开 CC Switch。
选择 Codex 或 Claude Code，点击 + 添加连接，然后选择 Custom。
填写 连接地址、API Key 和 模型：

连接地址：https://api.tos.run/v1
API Key：你的 gk_ Key
模型：gpt-5.6-sol

连接地址：https://api.tos.run
API Key：你的 gk_ Key
模型：claude-sonnet-4-6

保存并启用后，按所选工具验证：

Codex：重启终端后运行：

codex

Claude Code：直接运行：

claude

API/SDK 调用

服务端将 Key 放在环境变量中：

export TOS_API_KEY="gk_YOUR_KEY"

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.tos.run/v1",
  apiKey: process.env.TOS_API_KEY,
});

const response = await client.responses.create({
  model: "gpt-5.6-sol",
  input: "用一句话介绍你自己。",
});

console.log(response.output_text);

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  baseURL: "https://api.tos.run",
  authToken: process.env.TOS_API_KEY,
});

const message = await client.messages.create({
  model: "claude-sonnet-4-6",
  max_tokens: 1024,
  messages: [{ role: "user", content: "用一句话介绍你自己。" }],
});

console.log(message.content);

生产环境请只在服务端保存 API Key，不要将它写入浏览器代码或提交到仓库。