接入文档
你的工位带一条独立出口线路。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 都不受影响。
{
"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)。目前唯一支持的方式是环境变量,
所以我们把它只挂在这一条命令上 —— 前缀赋值只对这个进程生效,
关掉终端就没了,不影响机器上其他程序。
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
$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 不会自动读系统代理,只认这份配置。
{
"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 --proxy socks5h://username:password@proxy.workspaceai.cc:PORT \
https://api.ipify.org
返回的应该就是控制台里显示的那个出口 IP。 不一致说明流量没走代理,联系我们处理。
8排查
按症状找。每一条都给了原因和处理顺序,从最常见的开始排。
提示 407 或「认证失败」
用户名或密码不对。密码区分大小写。 在控制台重置过代理密码的话,旧密码立即失效。
提示连接超时
按可能性从高到低排查:
- 刚换了网络 —— 代理端口只放行你登录过的 IP,需要在控制台重新添加当前 IP。
- 本机或公司防火墙拦截 —— 换个网络(比如手机热点)试一下,能通就是本地网络的问题。
- 流量已用尽被暂停 —— 控制台的工位卡片会显示「已暂停」。
都不确定的话,先跑第 7 节的 curl。能返回 IP 就说明线路本身正常, 问题在你的工具配置;返回不了就是线路或授权的问题。
Codex 能连上但总是断
确认代理前缀是 http:// 而不是 socks5h://。
验证出来的 IP 和控制台不一样
说明流量没走代理,或走错了出口。这种情况不应该发生, 请把 curl 的输出发给我们。
会限速吗
有,但设得很宽松。目的是防止个别用户跑满带宽影响其他人, 正常使用几乎碰不到。具体数值可以问客服。
流量怎么算的
按经过代理的实际字节数统计,只算走线路的部分。 没有走代理的下载(比如直接拉 git 仓库)不计入额度。