CCODING AGENTCONFIG LAB
国产算力 · 模型服务

让国产算力，
直接进入你的代码。

Coding Agent 配置中心。把你的访问令牌接进来，在熟悉的开发工具里直接调用编程模型。本页按「七步」组织，完全没用过命令行的同学从上往下照着做即可。

从第一步开始 ↓ 我卡住了 / 报错了
7 步拿 Token → 装工具 → 装 CC Switch → 生成配置 → 验证 → 交给课程项目 → 接入 WorkBuddy
3 种工具Codex / Claude Code / WorkBuddy，一次配置可复用
100% 本地密钥只在浏览器里参与生成，不会上传到任何服务器

新手路线图

1 拿 Token 2 装 CLI 3 装 CC Switch 4 生成并导入配置 5 验证能对话 6 用课程项目 7 装多个模型
当前环境：检测中… 加载中
STEP 01 / GET TOKEN

先拿到属于你的 Token

没有 Token，后面全白搭。这一步只需要登录并生成一个访问令牌。

只有两件事要做：① 登录模型服务控制台 → ② 生成一个访问令牌。令牌生成后复制好，下一步就要用到。
1 — 登录

打开模型服务控制台并登录

用你的账号登录控制台。登录后即可在设置里管理访问令牌。

打开控制台 ↗

2 — 生成令牌

工作台 → 设置 → 访问令牌

点击「新建令牌」，复制生成的字符串。它只会完整显示一次，请立刻粘贴到下一步的输入框里，或先存到本地备忘。

直达访问令牌页面 ↗

Token 形如一长串字母数字。不要把它贴进任何聊天窗口、公开仓库或论坛——它等同于你的钱包密码。

STEP 02 / INSTALL

装一个编码 Agent

三种任选其一即可，不确定选哪个就选 Codex。已按你的系统高亮对应命令，点一下命令即可复制。WorkBuddy 是桌面客户端，不用 Node、也不用命令行，下载装完就能用。

npm 方式需要先装 Node.js 18+。完全没用过命令行的话，去 nodejs.org 下载 LTS 安装包，一路「下一步」装完，重启终端再执行下面的命令。原生脚本方式则不需要 Node。
◎npm · Node 18+

Codex CLI

OpenAI 官方命令行编码助手，支持自定义模型提供商。本页默认推荐。

Windows · macOS · Linuxnpm install -g @openai/codex复制
验证安装codex --version复制

macOS 也可用 brew install --cask codex。装完若提示 command not found，请关掉终端重新开一个。想省掉命令行，就选右边的 WorkBuddy。

✦原生 / npm

Claude Code

Anthropic 官方终端编码 Agent，原生安装或 npm 均可。

npm（需 Node 18+）npm install -g @anthropic-ai/claude-code复制
macOS · Linux · WSL 原生curl -fsSL https://claude.ai/install.sh | bash复制
Windows PowerShell 原生irm https://claude.ai/install.ps1 | iex复制
验证安装claude --version复制

Windows CMD 可用 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd。

◇桌面客户端 · 免命令行

WorkBuddy

桌面版 AI 编码助手，设置里能加自定义模型。不用命令行，也不用装 CC Switch。

官网下载（Win / macOS / Linux）https://www.workbuddy.cn/复制

装完打开客户端就行，模型配置在第 4 步生成——选 WorkBuddy 会自动变成下载一键脚本。写完要完全退出（托盘图标也退）再启动，模型才会出现在下拉里。

STEP 03 / DESKTOP BRIDGE

装 CC Switch（关键一步）

CC Switch 是本地桌面配置桥。必须先装它，第 4 步的「一键导入」才有接收方。没装就点导入，浏览器会没有反应。
只用 WorkBuddy 的同学可以跳过这一步——它靠第 4 步下载的脚本直接写配置文件，不需要导入桥。

顺序别搞反。很多人卡住都是因为先点了「生成并导入配置」，但电脑上还没有 CC Switch。正确顺序：装 CLI → 装 CC Switch → 生成配置 → 导入。
装好后请启动一次 CC Switch，它会在系统里注册 ccswitch:// 协议。首次使用时会自动识别你已装好的 CLI；如果没识别到，确认 CLI 已经装好并且至少启动过一次。
STEP 04 / CONFIG BUILDER

生成配置并一键导入

密钥只在本地浏览器参与生成，不会上传。左侧填完，右侧实时预览，点「生成并导入配置」唤起 CC Switch 确认。

连接模型服务

STEP 04
还没装 CC Switch？先去 第 3 步 装好并启动一次，否则点「导入」不会有反应。

从 控制台 → 工作台 → 设置 → 访问令牌 获取。粘贴后可用下方「测试令牌」先验一下真伪。

这枚令牌在本页怎么处理
  1. 页面上不会出现完整令牌。输入框是密码态，右侧预览里的形状是 A1b2••••••••9Zk3，前四位和后四位只用来核对是哪一枚。截图到这里是安全的。
  2. 点「复制」才把完整值写进剪贴板，页面上不渲染。复制后直接粘进配置文件，粘完再截终端图。
  3. 已经泄出去了：去 访问令牌页 删掉那一枚、重新生成一枚，旧令牌当场失效。作业进度不受影响。
Qwen3-Coder-30B-A3B-Instruct32K 上下文 · Function Calling · 实测 0.9 秒返回工具调用，第一课推荐

模型名必须与控制台里完全一致（含大小写与后缀）。若启动后报 model not found，回到 控制台 复制准确 ID，选「其他」重新填写即可。

选 WorkBuddy 不用装 CC Switch，也没有 ccswitch:// 协议可用，所以下面那颗按钮会自动变成下载一键脚本（双击运行就写完）。想把多个模型一次装进去，去第 7 步勾选。

没有装 CC Switch、或弹窗被拦截时，可点击右侧「复制配置」手动写入文件，文件路径见右侧说明。

Codex 配置预览

LIVE PREVIEW
config.toml

          

          

             安全预览 · 令牌已遮蔽
            

              
              
            

          


          

            
这个配置要放到哪里？CODEX

            

          


          

        

      

    


    
    
    

      

        
STEP 05 / VERIFY
验证它真的能用了

        
配置写完必须完全退出终端再重开（选的是 WorkBuddy 就退出客户端，托盘图标也退），然后问一句最简单的话。能看到回答，才算真的成功。

      


      

        
01 — 重开终端
关闭并重新打开终端
新开的窗口才会加载最新的环境变量与配置。已开着的窗口改了配置也不会生效——这是最容易踩的坑。

        
02 — 启动工具
运行 codex / claude，或打开 WorkBuddy
终端里直接输入对应命令回车；WorkBuddy 则是打开客户端，在模型下拉里切到 Qwen3-Coder-30B。Claude Code 可用 /model 确认模型映射是否指向你配置的那个模型。

        
03 — 发一句话
输入「用 Python 写一个冒泡排序」
能正常返回代码 = 配置成功。若报错，直接对照下方 FAQ 的报错信息排查。

      


      
      
      
把同一个 Key 交给课程里的两个网页项目

      

        第二课《赤壁·风起》和第三课《歧路》是本地运行的网页项目，同样要用到这枚令牌。
        它们不读环境变量，而是读项目目录里的 config.json。
        选一个项目，下面的命令会带着你的 Key 一起生成好——点一下就复制，粘进终端回车即可。
      


      

        

        

      


      

        

        

      

      
不确定自己开的是哪个？看窗口提示符：开头带 PS 的是 PowerShell，不带的是 CMD。选错了命令会报「文件名、目录名或卷标语法不正确」。


      
① 下载项目git clone https://www.gitlink.org.cn/ccf-ai-infra/Coding-Agent-Bootcamp.git复制

      
② 进目录并写入你的 Keycd Coding-Agent-Bootcamp/lesson-02-chibi-game/lab ; python -c "import json,shutil;shutil.copy('config.example.json','config.json');d=json.load(open('config.json',encoding='utf-8'));d['api_key']='在这里粘贴你的令牌';open('config.json','w',encoding='utf-8').write(json.dumps(d,ensure_ascii=False,indent=2));print('已写入 config.json')"复制

      
③ 启动并打开python server.py复制


      

        
        不想用 git？去仓库页下载 ZIP ↗
      

      
GitLink 的 ZIP 要先登录才能下载：打开仓库页，点右上角「克隆/下载」即可。不登录也能用上面的 git clone。用 ZIP 的话，解压出来的目录名可能带 -master 后缀，第 ② 行的 cd 按实际目录名改一下。


      

        执行完第 ③ 行，浏览器打开 http://127.0.0.1:8848 就能看到项目跑起来了。
        第 ② 行里的 Key 在页面上是 A1b2••••••••9Zk3 这样的遮蔽形，点复制才把完整值写进剪贴板。
        它只写进你本机的 config.json，该文件已被 .gitignore 排除，不会进仓库、也不会进浏览器。
      

      

      
      
      
一次把多个模型装进 WorkBuddy（可选）

      

        第 4 步选 WorkBuddy 时，只会写进当前下拉里的那一个模型。
        想同时装「写代码的 + 识图的 + 你自己填的」，在这里勾——写的是同一个文件，重复跑也不会重复添加。
        选好模型和系统后下载一键脚本双击运行就写完了；不想下脚本的，也可以复制命令自己粘进终端。
      


      
① 选模型可多选，装几个都行

      

      

        
        
        
      

      

        平台的模型列表里有 214 个，但能用哪些由你绑定的资源包决定；而且不是每个模型都开了工具调用，
        没开的接进 WorkBuddy 会一直 400。上面标了「带工具会 400」的三个是实测结果。
        想装列表外的模型，把 ID 填进上面那一格就行，报错对照：
        不支持当前模型或算力 = 资源包没覆盖；tool-call-parser = 该模型当不了 Agent。
      


      
② 选系统只影响下面那条命令怎么写

      

        

        

        

      

      
分不清 Windows 的两个终端：提示符开头带 PS 的是 PowerShell，不带的是 CMD。


      
③ 写进去两种方式选一种

      

        
        
      

      

        下载后双击就写完了，第二步的系统不用管。
        Windows 若弹出「Windows 已保护你的电脑」，点更多信息 → 仍要运行；
        macOS 若提示无法打开，右键 → 打开。脚本里带着你的令牌，用完就删掉这个文件。
      


      
或者：复制一条命令自己跑

        
写入 WorkBuddy 自定义模型python -c "..."复制

        

          
          手动配置步骤与排错 ↗
        

        

          命令里的令牌在页面上是 A1b2••••••••9Zk3 这样的遮蔽形，点复制才把完整值写进剪贴板。
        

      


      

        写完之后完全退出 WorkBuddy 再启动（托盘里也要退出），模型下拉里才会出现新加的这几个。
      

      

      

        
一键脚本到底往哪儿写了什么？

          
    
            
  • 写入位置：~/.workbuddy/models.json（Windows 上是 C:\Users\<你>\.workbuddy\models.json）。
    • 
            
  • 它先读出已有内容，只替换 id 和你勾选的那几个相同的条目，你自己配过的其它自定义模型会原样保留。重复跑多少次都一样。
    • 
            
  • 写进去的字段：接口地址 https://api.moark.com/v1/chat/completions、模型 ID、以及工具调用、识图等能力开关。
    • 
            
  • 令牌以明文存在你本机这个文件里（脚本文件里也有一份），不要提交到任何仓库，也不要截图发出去；脚本用完就删。
    • 
          

        


        
为什么有的模型标着「带工具会 400」？

          
    
            
  • WorkBuddy 每次对话都会带上工具定义，要求模型支持 tools 参数。平台只给部分模型开了工具解析，没开的会回
                "auto" tool choice requires --enable-auto-tool-choice and --tool-call-parser。
    • 
            
  • 实测（2026-11-03）：Qwen3-Coder-30B、Qwen3-VL-30B、GLM-5.3 可以；
                internlm3-8b-instruct、InternVL3-78B、Fin-R1、HY-MT2-7B、Qwen3-8B 不行。
    • 
            
  • 标了也能勾：勾上后写进去的是 supportsToolCall: False，它以纯聊天模型出现在下拉里，不能干活但能对话。
    • 
            
  • 反悔了：在 ~/.workbuddy/models.json 里删掉那一段，或重跑一次脚本、只勾能用的。
    • 
          

        


        
接进去之后要注意什么？

          
    
            
  • 模型下拉里看不到新模型：写完必须完全退出客户端再启动才会刷新（托盘图标也要退出）。
    • 
            
  • 验证方法：切到「Qwen3-Coder-30B」，发一句「只回复两个字：在」，能回就说明链路通了。
    • 
            
  • 想一次验全四项能力（对话 / 工具调用 / 流式 / 长上下文），仓库里有 tools/check_workbuddy_model.py。
    • 
            
  • 报 不支持当前模型或算力：这枚令牌绑定的资源包没覆盖这个模型，换回 Qwen3-Coder，或去平台加资源包。
    • 
          

        

      


      
      
卡住了？对照报错找答案

      

        
点了「生成并导入配置」，浏览器一点反应都没有

          
    
            
  • 99% 是本机还没装 CC Switch，或者装了但没启动过。去第 3 步装好并启动一次。
    • 
            
  • 或者浏览器把协议跳转拦截了。看地址栏右侧是否有被拦截的图标，手动允许「打开 CC Switch」。
    • 
            
  • macOS 若提示无法打开，去「系统设置 → 隐私与安全性」放行一次。
    • 
            
  • 协议没注册成功时：Windows 重装一次安装包，或检查注册表 HKEY_CLASSES_ROOT\ccswitch；macOS 执行 open -a "CC Switch" --args --register-protocol。
    • 
            
  • 兜底方案：点「复制配置」，按右侧路径提示手动写入文件。
    • 
          

        


        
报错 401 Unauthorized / invalid api key

          
    
            
  • Token 复制时多带了空格或换行。删掉重新粘贴一次，注意别把「Bearer」前缀也复制进去。
    • 
            
  • Token 被删除或过期了，回 访问令牌页重新生成一个。
    • 
            
  • 用默认的免费体验令牌时可能有每日次数限制，次数用完也会报错。
    • 
          

        


        
报错 model not found / 404 / invalid model

          
    
            
  • 模型名与平台不一致。到控制台的模型列表里原样复制模型 ID。
    • 
            
  • 带 -Preview 后缀的模型属于预览版，可能已下线或改名为正式版，建议换成不带 Preview 的型号。
    • 
            
  • 选了资源包里不包含的模型。资源包只覆盖它列出的那些模型，换一个包内模型即可。
    • 
            
  • 回到第 4 步，模型下拉选「其他 —— 手动输入模型 ID」，粘贴准确名称重新导入。
    • 
          

        


        
改了配置，但终端里还是老样子 / 完全没变化

          
    
            
  • 彻底关掉终端再重新打开。仅切标签页不算，最好整个退出进程。
    • 
            
  • 确认 CC Switch 里对应的供应商卡片是「当前启用」状态（通常有高亮边框）。
    • 
            
  • Claude Code 一般支持热加载；Codex 与 WorkBuddy 都要完全退出再启动（WorkBuddy 连托盘图标一起退）。
    • 
            
  • 检查是否同时存在多个配置来源冲突（比如你既改了 shell 里的环境变量，又用 CC Switch 导入了一份）。
    • 
          

        


        
提示 command not found / 不是内部或外部命令

          
    
            
  • 大概率是装完后没有重开终端。关掉终端重新开一个再试。
    • 
            
  • npm 全局目录没进 PATH。执行 npm config get prefix 看路径，把它加进系统环境变量 PATH。
    • 
            
  • Windows 上如果是用 nvm 装的 Node，重启一次电脑通常就能解决。
    • 
          

        


        
报错 文件名、目录名或卷标语法不正确

          
    
            
  • 你用的是 CMD，但复制的是 PowerShell 版命令——两者连接符不通用（; 只有 PowerShell 认）。
    • 
            
  • 回到第 6 步，把终端类型切成 CMD 再复制一次，整段报错就消失了。
    • 
            
  • 分不清窗口类型：看提示符，开头带 PS 的是 PowerShell，不带的是 CMD。
    • 
          

        


        
连接超时 / ETIMEDOUT / 一直卡住不动

          
    
            
  • 检查本机网络能否访问 moark.com（浏览器打开试试）。
    • 
            
  • 公司网络 / 代理可能拦截了 API 域名，换一个网络环境试试。
    • 
            
  • 确认请求地址填对了：Codex 用 https://moark.com/v1，Claude Code 用 https://moark.com/anthropic，WorkBuddy 用 https://api.moark.com/v1/chat/completions，三者不通用。
    • 
          

        


        
把 Token 填进这个网页，安全吗？

          
    
            
  • 页面本身不联网上传任何东西，所有拼接都在你浏览器本地完成，可以断网使用（会少了图标等资源）。
    • 
            
  • 但要注意：「一键导入」生成的 ccswitch:// 链接里明文包含你的 Token，它会进入浏览器历史记录。请不要复制这个链接发给别人、也不要发到公开渠道。
    • 
            
  • 如果是团队共享，推荐的做法是：链接里不放 Token，让每个人自己填；或者直接在 CC Switch 里手动「添加供应商」，完全不走链接。
    • 
          

        

      

    


    

      参考来源：
      CC Switch 快速配置文档（平台官方文档） ·
      访问令牌管理 ·
      CC Switch Releases ·
      CC Switch 深链接协议
      
请求地址与认证字段来源于平台官方文档；模型可用范围以控制台实时列表为准。