尧图网站建设 
1. 从 PyCharm 换到 Cursor 后为什么 Python 找不到模块了如果你之前一直用 PyCharm 写 Python最近换到 VS Code 或者 Cursor大概率会遇到两个让人抓狂的问题一是脚本里用相对路径读文件突然报FileNotFoundError二是import自己写的包直接甩你一句ModuleNotFoundError: No module named xxx。代码一个字没改换个编辑器就跑不起来这不是你的代码有问题而是 IDE 对「运行路径」和「模块搜索路径」的处理方式不一样。先说清楚这两个概念后面排查才不会乱。运行路径指的是os.getcwd()返回的那个目录也就是进程启动时的「当前工作目录」所有相对路径都基于它来解析。模块搜索路径指的是sys.path这个列表Python 导入模块时会按顺序在这些目录里找。PyCharm 默认把当前脚本所在目录设为工作目录还会自动把项目根目录塞进sys.path所以你写from utils.helper import xxx它能找到。而 VS Code / Cursor 本质上是「在集成终端里跑 python 命令」工作目录默认是打开的工作区根目录sys.path也不会自动帮你加项目里的子目录于是各种找不到。我试过最典型的场景项目结构是project/src/main.py和project/utils/helper.py在 PyCharm 里main.py里写from utils.helper import foo完全正常换到 Cursor 直接报错。原因就是 Cursor 从project根目录启动sys.path里没有project本身自然找不到utils这个包。搞明白这一点解决思路就清晰了要么改工作目录要么改sys.path要么两者都改。这篇内容适合正在用 VS Code / Cursor 写 Python、被路径和导入问题卡住的同学。我会从解释器选择、cwd、PYTHONPATH、launch.json到settings.json逐项拆解给出可以直接复制的配置片段和终端验证命令最后再讲怎么把 API 通道统一到 TaoToken用一段导入自检脚本确认模块能被正确解析。全程都是可跟做的步骤不玩虚的。2. 前置准备解释器、TaoToken Key 与工作区确认在动配置文件之前有三件事必须先确认否则后面改了也白改。第一选对 Python 解释器。VS Code / Cursor 底部状态栏有个 Python 版本号点它就能切换解释器。很多人报No module named其实是因为选了个没装依赖的解释器比如系统自带的 Python 和你虚拟环境里的 Python 混了。命令面板CtrlShiftP输入Python: Select Interpreter选中你项目实际用的那个通常是.venv/bin/python或.venv\Scripts\python.exe。选完之后集成终端里which pythonWindows 用where python应该指向同一个路径。第二准备好 TaoToken 的 Key 和通道。如果你打算把模型调用统一走一个 API 通道先去官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册然后在控制台 https://taotoken.net/console 里创建 API Key。创建完在 API Keys 页面 https://taotoken.net/api-keys 能看到以sk-开头的密钥复制保存好。接口地址统一用 https://taotoken.net/api 注意这个地址不带任何查询参数。模型 ID 按你实际要用的填比如claude-sonnet-4-5这类具体以文档 https://taotoken.net/doc 里的列表为准。这三样东西——Base URL、Key、Model ID——后面配置里会反复用到先记在手边。第三确认工作区根目录。在 Cursor 里打开项目时File Open Folder选的那个文件夹就是工作区根目录${workspaceFolder}指的就是它。如果你打开的是project/src而不是project那utils包在project下自然找不到。这一步经常被忽略但它是很多「配置都对却还是报错」的元凶。打开终端敲pwdWindows 用cd看看当前目录再对照你的项目结构确认一下。这三步做完你就有了一张清晰的底牌解释器是谁、Key 是什么、工作区在哪。接下来所有配置都是围绕这三样展开的。3. 可复制配置settings.json 与 launch.json 逐项设置这一节是核心直接给可复制的配置。VS Code 和 Cursor 的配置格式完全一致都是 JSON所以下面的片段两边通用。3.1 settings.json解决 cwd 和 PYTHONPATH先打开设置文件。命令面板CtrlShiftP输入Preferences: Open User Settings (JSON)或者直接编辑工作区的.vscode/settings.json。用户级配置在 Windows 下一般是C:\Users\你的用户名\AppData\Roaming\Cursor\User\settings.jsonmacOS 在~/Library/Application Support/Cursor/User/settings.json。工作区级配置优先级更高建议项目相关的都写在工作区里方便团队共享。{ python.terminal.executeInFileDir: true, terminal.integrated.env.windows: { PYTHONPATH: ${workspaceFolder};${env:PYTHONPATH} }, terminal.integrated.env.linux: { PYTHONPATH: ${workspaceFolder}:${env:PYTHONPATH} }, terminal.integrated.env.osx: { PYTHONPATH: ${workspaceFolder}:${env:PYTHONPATH} }, code-runner.fileDirectoryAsCwd: true, code-runner.executorMap: { python: python -u } }逐项解释一下。python.terminal.executeInFileDir设为true后你在编辑器里点「运行 Python 文件」时终端会在脚本所在目录启动os.getcwd()就变成了脚本目录跟 PyCharm 行为一致。terminal.integrated.env.*是给集成终端注入环境变量把工作区根目录加到PYTHONPATH最前面这样sys.path里就有项目根from utils.helper import foo就能找到。注意 Windows 用分号;分隔Linux 和 macOS 用冒号:写错了会整个路径失效。code-runner.fileDirectoryAsCwd是给 Code Runner 插件用的如果你装了它勾上这个才能让 Code Runner 也在文件目录下运行。注意${env:PYTHONPATH}是引用已有的环境变量如果系统里本来没设PYTHONPATH这个引用会展开成空字符串结果是工作区路径;末尾多个分隔符不影响使用但如果你追求干净可以去掉${env:PYTHONPATH}只留${workspaceFolder}。3.2 launch.json调试时的路径与参数调试场景和直接运行不一样launch.json控制的是调试器启动进程的方式。在项目根目录建.vscode/launch.json{ version: 0.2.0, configurations: [ { name: Python: 当前文件, type: debugpy, request: launch, program: ${file}, console: integratedTerminal, cwd: ${workspaceFolder}, env: { PYTHONPATH: ${workspaceFolder} }, envFile: ${workspaceFolder}/.env, justMyCode: true } ] }关键字段是cwd和env.PYTHONPATH。cwd决定调试进程的工作目录设成${workspaceFolder}表示从项目根启动如果你希望跟脚本目录一致改成${fileDirname}。env里的PYTHONPATH只在调试进程里生效不影响终端。envFile指向.env文件可以把 TaoToken 的 Key 放进去避免硬编码TAOTOKEN_API_KEYsk-你的密钥 TAOTOKEN_BASE_URLhttps://taotoken.net/api TAOTOKEN_MODELclaude-sonnet-4-5这样代码里用os.getenv(TAOTOKEN_API_KEY)就能读到既安全又方便切换环境。如果你用的是 Claude Code 这类工具配置思路类似Base URL 填 https://taotoken.net/api Key 填上面创建的Model ID 按文档填三件套齐全就能跑通。3.3 用 .env 统一管理通道把 Key 写进.env后记得在.gitignore里加上.env别把密钥提交上去。代码里读取的方式import os from openai import OpenAI client OpenAI( api_keyos.getenv(TAOTOKEN_API_KEY), base_urlos.getenv(TAOTOKEN_BASE_URL, https://taotoken.net/api), ) resp client.chat.completions.create( modelos.getenv(TAOTOKEN_MODEL, claude-sonnet-4-5), messages[{role: user, content: 用一句话解释什么是 PYTHONPATH}], ) print(resp.choices[0].message.content)这段代码同时验证了两件事模块导入是否正常openai能 import以及 API 通道是否通能拿到返回。如果openai报No module named说明依赖没装或解释器选错如果请求报 401说明 Key 有问题如果报连接错误检查 Base URL 是不是写成了带斜杠结尾或者带了多余路径。4. 验证请求终端命令与导入自检脚本配置改完别急着写业务代码先用几条命令确认环境是对的。第一步验证工作目录。在集成终端里跑python -c import os; print(os.getcwd())如果你在编辑器里对某个脚本点了运行输出应该是脚本所在目录如果是在终端手动敲的输出是终端当前目录。对照你的预期不对就回去检查executeInFileDir。第二步验证 sys.path。跑python -c import sys; [print(p) for p in sys.path]你应该能在输出里看到你的工作区根目录。如果没有说明PYTHONPATH没生效检查settings.json里的分隔符和路径变量拼写。第三步导入自检脚本。在项目根目录建一个check_imports.pyimport importlib import os import sys def check(module_name: str) - bool: try: importlib.import_module(module_name) print(f[OK] {module_name}) return True except ModuleNotFoundError as e: print(f[FAIL] {module_name} - {e}) return False if __name__ __main__: print(cwd:, os.getcwd()) print(sys.path[0:3]:, sys.path[0:3]) targets [utils.helper, src.main, openai] results [check(m) for m in targets] sys.exit(0 if all(results) else 1)把targets换成你自己的模块名运行python check_imports.py。全[OK]说明导入链路通了哪个[FAIL]就针对哪个排查。这个脚本的好处是它把cwd和sys.path一起打印出来报错时一眼能看出是路径问题还是模块真的不存在。第四步验证 API 通道。用第 3.3 节那段代码跑一次能打印出模型回复就说明 TaoToken 通道正常。如果报401去 API Keys 页面 https://taotoken.net/api-keys 确认 Key 没复制错、没过期如果报model not found去文档 https://taotoken.net/doc 核对 Model ID 拼写。5. 本篇常见报错排查401、local proxy failed、reading choices、OAuth配置过程中最容易撞上的几类报错这里逐个对照。ModuleNotFoundError: No module named xxx—— 这是最高频的。先跑第 4 节的check_imports.py看sys.path里有没有你的项目根。没有就检查settings.json的PYTHONPATH有但还报错说明模块名写错了或者那个目录下没有__init__.pyPython 3.3 支持命名空间包但某些工具仍要求有。还有一种情况是解释器选错which python确认一下。401 Unauthorized/invalid api key—— Key 问题。检查.env里TAOTOKEN_API_KEY有没有多余空格或引号Key 是不是从 https://taotoken.net/api-keys 正确复制的。注意 Base URL 必须是 https://taotoken.net/api 不要自己加/v1之类的后缀具体路径以文档为准。local proxy failed/ 连接被拒绝—— 通常是 Base URL 写错或者本地网络环境有干扰。确认地址拼写无误别在 URL 里塞查询参数。如果公司网络有出口限制换到能正常访问的环境再试。Error reading choices/choices字段为空—— 这类报错一般是响应结构和你解析的字段对不上。先打印完整响应print(resp)看看实际返回长什么样再对照文档调整解析代码。有时候是模型 ID 不支持当前接口格式换个模型试试。OAuth相关报错—— 如果你用的是 Claude Code 这类需要登录的工具报 OAuth 错误通常是认证方式没配对。这类工具一般支持 API Key 模式把 Base URL 设为 https://taotoken.net/api Key 填创建的密钥Model ID 按文档填三件套齐全后走 Key 认证而不是 OAuth就能绕开登录问题。具体配置参考文档 https://taotoken.net/doc 。FileNotFoundError读不到文件—— 回到os.getcwd()打印确认工作目录是不是你以为的那个。相对路径永远相对于cwd不是相对于脚本文件。要么改cwd要么用os.path.dirname(__file__)拼绝对路径。排查的通用心法是先打印cwd和sys.path再打印完整报错和响应别猜。90% 的路径和导入问题这两行打印就能定位。6. 把通道统一到 TaoToken长期编码与 Agent 场景的接入路径和导入理顺之后如果你打算长期用 Cursor 写代码、跑 Agent建议把模型调用统一到一个通道省得每个工具配一遍 Key。TaoToken 的接入方式就是标准的 OpenAI 兼容格式Base URL 用 https://taotoken.net/api Key 用控制台创建的Model ID 按文档填。对于 Claude Code 这类命令行工具配置通常写在一个 JSON 或 TOML 文件里把 Base URL、Key、Model ID 三件套填进去即可。如果你用 Cline、MCP 之类的插件也是同样的三要素接口地址、密钥、模型标识。填完之后跑一次简单请求验证能返回内容就说明通道通了。长期编码场景下如果你调用量大可以看看 Coding Plan https://taotoken.net/coding-plan 按需选择。日常想快速验证某个模型能不能用直接去模型对话页面 https://taotoken.net/chat 试一句就行不用写代码。接入文档在 https://taotoken.net/doc 遇到字段不确定的以文档为准。最后提醒一句.env和任何含 Key 的文件都别提交到 Git团队协作时用环境变量或者密钥管理服务分发。配置这东西一次写对后面就省心了。把第 4 节的check_imports.py留在项目里每次换环境跑一遍比事后 debug 划算得多。 vscode/cursor中python运行路径设置与模块导入问题：把settings.json改到TaoToken
1. 从 PyCharm 换到 Cursor 后为什么 Python 找不到模块了如果你之前一直用 PyCharm 写 Python最近换到 VS Code 或者 Cursor大概率会遇到两个让人抓狂的问题一是脚本里用相对路径读文件突然报FileNotFoundError二是import自己写的包直接甩你一句ModuleNotFoundError: No module named xxx。代码一个字没改换个编辑器就跑不起来这不是你的代码有问题而是 IDE 对「运行路径」和「模块搜索路径」的处理方式不一样。先说清楚这两个概念后面排查才不会乱。运行路径指的是os.getcwd()返回的那个目录也就是进程启动时的「当前工作目录」所有相对路径都基于它来解析。模块搜索路径指的是sys.path这个列表Python 导入模块时会按顺序在这些目录里找。PyCharm 默认把当前脚本所在目录设为工作目录还会自动把项目根目录塞进sys.path所以你写from utils.helper import xxx它能找到。而 VS Code / Cursor 本质上是「在集成终端里跑 python 命令」工作目录默认是打开的工作区根目录sys.path也不会自动帮你加项目里的子目录于是各种找不到。我试过最典型的场景项目结构是project/src/main.py和project/utils/helper.py在 PyCharm 里main.py里写from utils.helper import foo完全正常换到 Cursor 直接报错。原因就是 Cursor 从project根目录启动sys.path里没有project本身自然找不到utils这个包。搞明白这一点解决思路就清晰了要么改工作目录要么改sys.path要么两者都改。这篇内容适合正在用 VS Code / Cursor 写 Python、被路径和导入问题卡住的同学。我会从解释器选择、cwd、PYTHONPATH、launch.json到settings.json逐项拆解给出可以直接复制的配置片段和终端验证命令最后再讲怎么把 API 通道统一到 TaoToken用一段导入自检脚本确认模块能被正确解析。全程都是可跟做的步骤不玩虚的。2. 前置准备解释器、TaoToken Key 与工作区确认在动配置文件之前有三件事必须先确认否则后面改了也白改。第一选对 Python 解释器。VS Code / Cursor 底部状态栏有个 Python 版本号点它就能切换解释器。很多人报No module named其实是因为选了个没装依赖的解释器比如系统自带的 Python 和你虚拟环境里的 Python 混了。命令面板CtrlShiftP输入Python: Select Interpreter选中你项目实际用的那个通常是.venv/bin/python或.venv\Scripts\python.exe。选完之后集成终端里which pythonWindows 用where python应该指向同一个路径。第二准备好 TaoToken 的 Key 和通道。如果你打算把模型调用统一走一个 API 通道先去官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册然后在控制台 https://taotoken.net/console 里创建 API Key。创建完在 API Keys 页面 https://taotoken.net/api-keys 能看到以sk-开头的密钥复制保存好。接口地址统一用 https://taotoken.net/api 注意这个地址不带任何查询参数。模型 ID 按你实际要用的填比如claude-sonnet-4-5这类具体以文档 https://taotoken.net/doc 里的列表为准。这三样东西——Base URL、Key、Model ID——后面配置里会反复用到先记在手边。第三确认工作区根目录。在 Cursor 里打开项目时File Open Folder选的那个文件夹就是工作区根目录${workspaceFolder}指的就是它。如果你打开的是project/src而不是project那utils包在project下自然找不到。这一步经常被忽略但它是很多「配置都对却还是报错」的元凶。打开终端敲pwdWindows 用cd看看当前目录再对照你的项目结构确认一下。这三步做完你就有了一张清晰的底牌解释器是谁、Key 是什么、工作区在哪。接下来所有配置都是围绕这三样展开的。3. 可复制配置settings.json 与 launch.json 逐项设置这一节是核心直接给可复制的配置。VS Code 和 Cursor 的配置格式完全一致都是 JSON所以下面的片段两边通用。3.1 settings.json解决 cwd 和 PYTHONPATH先打开设置文件。命令面板CtrlShiftP输入Preferences: Open User Settings (JSON)或者直接编辑工作区的.vscode/settings.json。用户级配置在 Windows 下一般是C:\Users\你的用户名\AppData\Roaming\Cursor\User\settings.jsonmacOS 在~/Library/Application Support/Cursor/User/settings.json。工作区级配置优先级更高建议项目相关的都写在工作区里方便团队共享。{ python.terminal.executeInFileDir: true, terminal.integrated.env.windows: { PYTHONPATH: ${workspaceFolder};${env:PYTHONPATH} }, terminal.integrated.env.linux: { PYTHONPATH: ${workspaceFolder}:${env:PYTHONPATH} }, terminal.integrated.env.osx: { PYTHONPATH: ${workspaceFolder}:${env:PYTHONPATH} }, code-runner.fileDirectoryAsCwd: true, code-runner.executorMap: { python: python -u } }逐项解释一下。python.terminal.executeInFileDir设为true后你在编辑器里点「运行 Python 文件」时终端会在脚本所在目录启动os.getcwd()就变成了脚本目录跟 PyCharm 行为一致。terminal.integrated.env.*是给集成终端注入环境变量把工作区根目录加到PYTHONPATH最前面这样sys.path里就有项目根from utils.helper import foo就能找到。注意 Windows 用分号;分隔Linux 和 macOS 用冒号:写错了会整个路径失效。code-runner.fileDirectoryAsCwd是给 Code Runner 插件用的如果你装了它勾上这个才能让 Code Runner 也在文件目录下运行。注意${env:PYTHONPATH}是引用已有的环境变量如果系统里本来没设PYTHONPATH这个引用会展开成空字符串结果是工作区路径;末尾多个分隔符不影响使用但如果你追求干净可以去掉${env:PYTHONPATH}只留${workspaceFolder}。3.2 launch.json调试时的路径与参数调试场景和直接运行不一样launch.json控制的是调试器启动进程的方式。在项目根目录建.vscode/launch.json{ version: 0.2.0, configurations: [ { name: Python: 当前文件, type: debugpy, request: launch, program: ${file}, console: integratedTerminal, cwd: ${workspaceFolder}, env: { PYTHONPATH: ${workspaceFolder} }, envFile: ${workspaceFolder}/.env, justMyCode: true } ] }关键字段是cwd和env.PYTHONPATH。cwd决定调试进程的工作目录设成${workspaceFolder}表示从项目根启动如果你希望跟脚本目录一致改成${fileDirname}。env里的PYTHONPATH只在调试进程里生效不影响终端。envFile指向.env文件可以把 TaoToken 的 Key 放进去避免硬编码TAOTOKEN_API_KEYsk-你的密钥 TAOTOKEN_BASE_URLhttps://taotoken.net/api TAOTOKEN_MODELclaude-sonnet-4-5这样代码里用os.getenv(TAOTOKEN_API_KEY)就能读到既安全又方便切换环境。如果你用的是 Claude Code 这类工具配置思路类似Base URL 填 https://taotoken.net/api Key 填上面创建的Model ID 按文档填三件套齐全就能跑通。3.3 用 .env 统一管理通道把 Key 写进.env后记得在.gitignore里加上.env别把密钥提交上去。代码里读取的方式import os from openai import OpenAI client OpenAI( api_keyos.getenv(TAOTOKEN_API_KEY), base_urlos.getenv(TAOTOKEN_BASE_URL, https://taotoken.net/api), ) resp client.chat.completions.create( modelos.getenv(TAOTOKEN_MODEL, claude-sonnet-4-5), messages[{role: user, content: 用一句话解释什么是 PYTHONPATH}], ) print(resp.choices[0].message.content)这段代码同时验证了两件事模块导入是否正常openai能 import以及 API 通道是否通能拿到返回。如果openai报No module named说明依赖没装或解释器选错如果请求报 401说明 Key 有问题如果报连接错误检查 Base URL 是不是写成了带斜杠结尾或者带了多余路径。4. 验证请求终端命令与导入自检脚本配置改完别急着写业务代码先用几条命令确认环境是对的。第一步验证工作目录。在集成终端里跑python -c import os; print(os.getcwd())如果你在编辑器里对某个脚本点了运行输出应该是脚本所在目录如果是在终端手动敲的输出是终端当前目录。对照你的预期不对就回去检查executeInFileDir。第二步验证 sys.path。跑python -c import sys; [print(p) for p in sys.path]你应该能在输出里看到你的工作区根目录。如果没有说明PYTHONPATH没生效检查settings.json里的分隔符和路径变量拼写。第三步导入自检脚本。在项目根目录建一个check_imports.pyimport importlib import os import sys def check(module_name: str) - bool: try: importlib.import_module(module_name) print(f[OK] {module_name}) return True except ModuleNotFoundError as e: print(f[FAIL] {module_name} - {e}) return False if __name__ __main__: print(cwd:, os.getcwd()) print(sys.path[0:3]:, sys.path[0:3]) targets [utils.helper, src.main, openai] results [check(m) for m in targets] sys.exit(0 if all(results) else 1)把targets换成你自己的模块名运行python check_imports.py。全[OK]说明导入链路通了哪个[FAIL]就针对哪个排查。这个脚本的好处是它把cwd和sys.path一起打印出来报错时一眼能看出是路径问题还是模块真的不存在。第四步验证 API 通道。用第 3.3 节那段代码跑一次能打印出模型回复就说明 TaoToken 通道正常。如果报401去 API Keys 页面 https://taotoken.net/api-keys 确认 Key 没复制错、没过期如果报model not found去文档 https://taotoken.net/doc 核对 Model ID 拼写。5. 本篇常见报错排查401、local proxy failed、reading choices、OAuth配置过程中最容易撞上的几类报错这里逐个对照。ModuleNotFoundError: No module named xxx—— 这是最高频的。先跑第 4 节的check_imports.py看sys.path里有没有你的项目根。没有就检查settings.json的PYTHONPATH有但还报错说明模块名写错了或者那个目录下没有__init__.pyPython 3.3 支持命名空间包但某些工具仍要求有。还有一种情况是解释器选错which python确认一下。401 Unauthorized/invalid api key—— Key 问题。检查.env里TAOTOKEN_API_KEY有没有多余空格或引号Key 是不是从 https://taotoken.net/api-keys 正确复制的。注意 Base URL 必须是 https://taotoken.net/api 不要自己加/v1之类的后缀具体路径以文档为准。local proxy failed/ 连接被拒绝—— 通常是 Base URL 写错或者本地网络环境有干扰。确认地址拼写无误别在 URL 里塞查询参数。如果公司网络有出口限制换到能正常访问的环境再试。Error reading choices/choices字段为空—— 这类报错一般是响应结构和你解析的字段对不上。先打印完整响应print(resp)看看实际返回长什么样再对照文档调整解析代码。有时候是模型 ID 不支持当前接口格式换个模型试试。OAuth相关报错—— 如果你用的是 Claude Code 这类需要登录的工具报 OAuth 错误通常是认证方式没配对。这类工具一般支持 API Key 模式把 Base URL 设为 https://taotoken.net/api Key 填创建的密钥Model ID 按文档填三件套齐全后走 Key 认证而不是 OAuth就能绕开登录问题。具体配置参考文档 https://taotoken.net/doc 。FileNotFoundError读不到文件—— 回到os.getcwd()打印确认工作目录是不是你以为的那个。相对路径永远相对于cwd不是相对于脚本文件。要么改cwd要么用os.path.dirname(__file__)拼绝对路径。排查的通用心法是先打印cwd和sys.path再打印完整报错和响应别猜。90% 的路径和导入问题这两行打印就能定位。6. 把通道统一到 TaoToken长期编码与 Agent 场景的接入路径和导入理顺之后如果你打算长期用 Cursor 写代码、跑 Agent建议把模型调用统一到一个通道省得每个工具配一遍 Key。TaoToken 的接入方式就是标准的 OpenAI 兼容格式Base URL 用 https://taotoken.net/api Key 用控制台创建的Model ID 按文档填。对于 Claude Code 这类命令行工具配置通常写在一个 JSON 或 TOML 文件里把 Base URL、Key、Model ID 三件套填进去即可。如果你用 Cline、MCP 之类的插件也是同样的三要素接口地址、密钥、模型标识。填完之后跑一次简单请求验证能返回内容就说明通道通了。长期编码场景下如果你调用量大可以看看 Coding Plan https://taotoken.net/coding-plan 按需选择。日常想快速验证某个模型能不能用直接去模型对话页面 https://taotoken.net/chat 试一句就行不用写代码。接入文档在 https://taotoken.net/doc 遇到字段不确定的以文档为准。最后提醒一句.env和任何含 Key 的文件都别提交到 Git团队协作时用环境变量或者密钥管理服务分发。配置这东西一次写对后面就省心了。把第 4 节的check_imports.py留在项目里每次换环境跑一遍比事后 debug 划算得多。