接入文档

你的工位带一条独立出口线路。Claude Code、Codex、Cursor 都能接上,配置方式不同,照着对应那一节做就行。 全文大约三分钟能读完。

1连接信息

在控制台的工位卡片里可以随时查看和复制。 下面示例里的 PORT 就是你那个端口 —— 直接把控制台里的完整地址复制过来,替换掉 username、 password 和 PORT 三处就行。

地址
proxy.workspaceai.cc:PORT (每个工位一个端口, 控制台里显示你的完整地址,复制那一行就对了)
协议
SOCKS5 或 HTTP —— 同一地址都支持,不用换端口
用户名
ws1001 (你的工位号,代理认证用它)
密码
控制台显示的代理密码

2先看这几条

API key 是你自己的。

我们只提供网络出口。你的请求从你的机器经代理直接到 AI 服务商, 中间不经过我们 —— 我们拿不到你的 key,也看不到你的请求内容。

换网络后需要重新授权。

每个代理端口只允许从你登录过的 IP 访问(防止密码泄漏后被他人使用)。 换了网络之后(家里 ↔ 公司、WiFi ↔ 手机流量), 需要在控制台重新添加一次当前 IP,或者联系我们。

流量用完线路会暂停。

工位会等到次月 1 日自动重置后恢复,重置期间配置不用改。

不要 export HTTPS_PROXY 全局设代理。

环境变量是整台机器生效的。下面的配置都 写在程序自己的配置里,或者只对单条命令生效。 全局变量只在一种情况下用得上: 你这台机器上的流量本来就全都该走这条线路。

3Claude Code

写进 Claude Code 自己的配置文件 ~/.claude/settings.json。 这样只有 Claude Code 走代理,浏览器、git、npm 都不受影响。

~/.claude/settings.json
{
  "env": {
    "HTTPS_PROXY": "http://username:password@proxy.workspaceai.cc:PORT",
    "HTTP_PROXY": "http://username:password@proxy.workspaceai.cc:PORT",
    "NO_PROXY": "localhost,127.0.0.1"
  }
}

已经改过这个文件的话,把三项合并进现有的 env, 别整个覆盖掉 —— 里面可能还有你自己配的东西。 文件不存在就直接新建。改完重启 Claude Code 生效 (它在启动时读一次)。

必须用 http:// 前缀。

Claude Code 的代理配置只认 HTTP 协议。

4Codex

Codex 的 ~/.codex/config.toml 里没有代理配置项 (官方还在加,见 issue #6060)。目前唯一支持的方式是环境变量, 所以我们把它只挂在这一条命令上 —— 前缀赋值只对这个进程生效, 关掉终端就没了,不影响机器上其他程序。

macOS / Linux
HTTPS_PROXY=http://username:password@proxy.workspaceai.cc:PORT \
HTTP_PROXY=http://username:password@proxy.workspaceai.cc:PORT \
NO_PROXY=localhost,127.0.0.1 \
codex
Windows PowerShell
$env:HTTPS_PROXY="http://username:password@proxy.workspaceai.cc:PORT"
$env:HTTP_PROXY=$env:HTTPS_PROXY
$env:NO_PROXY="localhost,127.0.0.1"

codex

PowerShell 没有 VAR=x cmd 这种前缀语法, 只能这样给当前窗口设变量,用完开个新窗口就自动失效。 嫌麻烦就写个 run-codex.ps1 脚本放桌上,双击运行。

必须用 http:// 前缀。

Codex 的环境变量代理配置只认 HTTP 协议。

API key 配在 ~/.codex/config.toml 或环境变量 OPENAI_API_KEY 里,和代理互不影响。

如果它提示沙箱不允许联网,在 ~/.codex/config.toml 里加:

[sandbox_workspace_write]
network_access = true

这个开关只管 Codex 启动的命令能不能联网,和代理本身是两回事。

5Cursor

Cursor 是图形客户端,代理写在它自己的 settings.json 里。不要走全局环境变量 —— Electron 不会自动读系统代理,只认这份配置。

Cursor → 设置 → 搜索 proxy → 右上角「打开设置 (JSON)」
{
  "http.proxy": "http://username:password@proxy.workspaceai.cc:PORT",
  "http.proxySupport": "override",
  "http.proxyStrictSSL": true
}

已经改过 settings.json 就把三行合并进去, 别整个覆盖。改完完全退出 Cursor 再打开(关窗口不算, 要退进程)才生效。

必须用 http:// 前缀。

Cursor 的 http.proxy 配置只认 HTTP 协议。

系统代理开着也没用,必须在这里配。

Cursor 默认 http.proxySupport 是 override, 意思是只看 settings.json,完全忽略系统代理。 而且它这个值默认是空的 —— 所以「浏览器走代理、Cursor 不走」 是每个新装的默认状态,不是你配错了。

症状是登录时静默失败,或者报 This model provider is not supported in your region —— 看着像地区问题,实际是流量没走代理。

如果配完还是连不上,报 Failed to establish a socket connection:

把 Settings → Network → HTTP Compatibility Mode 从 HTTP/2 改成 HTTP/1.1,然后重启。 Cursor 的 AI 请求走 HTTP/2,某些代理实现对 CONNECT 的处理有问题。

登录和订阅走 Cursor 自己的账号(不是 API key), 配好代理后用 Cursor 的账号登录即可。

6其他工具

原则不变:代理配到那个工具自己的配置里, 不要动全局环境变量。各工具的位置不一样,常见的几个:

curl
--proxy 参数,单次生效,见第 7 节
git
git config --global http.proxy ... 只影响 git,不影响别的程序
pip
~/.config/pip/pip.conf 的 [global] proxy = ...
npm
~/.npmrc 的 proxy=... / https-proxy=...
Python requests
代码里传 proxies={"https": "..."}, 最干净 —— 跟着代码走,不会漏到别处
Playwright
launch({ proxy: { server: "..." } })

实在只能靠环境变量时,也只挂在单条命令前面, 不要 export:
HTTPS_PROXY=... your-command(PowerShell 用 $env:HTTPS_PROXY="..."; your-command)。 这样作用域只有这一个进程。

7验证线路是否通

配完之后先跑这一条,确认代理真的生效:

curl
curl --proxy socks5h://username:password@proxy.workspaceai.cc:PORT \
  https://api.ipify.org

返回的应该就是控制台里显示的那个出口 IP。 不一致说明流量没走代理,联系我们处理。

8排查

按症状找。每一条都给了原因和处理顺序,从最常见的开始排。

提示 407 或「认证失败」

用户名或密码不对。密码区分大小写。 在控制台重置过代理密码的话,旧密码立即失效。

提示连接超时

按可能性从高到低排查:

  1. 刚换了网络 —— 代理端口只放行你登录过的 IP,需要在控制台重新添加当前 IP。
  2. 本机或公司防火墙拦截 —— 换个网络(比如手机热点)试一下,能通就是本地网络的问题。
  3. 流量已用尽被暂停 —— 控制台的工位卡片会显示「已暂停」。

都不确定的话,先跑第 7 节的 curl。能返回 IP 就说明线路本身正常, 问题在你的工具配置;返回不了就是线路或授权的问题。

Codex 能连上但总是断

确认代理前缀是 http:// 而不是 socks5h://。

验证出来的 IP 和控制台不一样

说明流量没走代理,或走错了出口。这种情况不应该发生, 请把 curl 的输出发给我们。

会限速吗

有,但设得很宽松。目的是防止个别用户跑满带宽影响其他人, 正常使用几乎碰不到。具体数值可以问客服。

流量怎么算的

按经过代理的实际字节数统计,只算走线路的部分。 没有走代理的下载(比如直接拉 git 仓库)不计入额度。