两种方式,任选其一

Claude Code 接入

接入只要两个值:本站地址和你的密钥。下半部分还有新手上手的使用建议。

先选一种方式

1
用 CC Switch 配置
推荐新手首选

图形界面填两个值就行——不用开终端、不用设环境变量。在 CC Switch 里把应用选成 Claude Code,然后填 Base URL https://issueacard.top不要带 /v1)和你的 sk- 密钥。

去看 CC Switch 教程(含下载安装)→
2
手动配置
进阶

自己设两个环境变量。适合想完全掌控配置、或 CC Switch 装不上的情况。就在本页,见下面「手动配置」一节。

两种方式都需要先装好 Claude Code 本体。配好之后的使用建议在本页下半部分,两条路都适用。

先提醒:本站是 GPT 模型

Claude Code 是按 Claude 设计的,接 GPT 要经过协议翻译,可能遇到个别兼容问题。想省事、要稳定,建议直接用 Codex

方式二:手动配置(设置两个环境变量)

选了 方式一 CC Switch 的话跳过本节,直接看下面的「启动前检查」。

sk-你的密钥 换成你自己的密钥(在 API 密钥 页创建)。

Windows(在 PowerShell 里执行):

setx ANTHROPIC_BASE_URL "https://issueacard.top"
setx ANTHROPIC_AUTH_TOKEN "sk-你的密钥"

macOS / Linux(在终端里执行):

echo 'export ANTHROPIC_BASE_URL="https://issueacard.top"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"' >> ~/.zshrc

设完要关掉终端重开(Windows 用户彻底退出 Claude Code 再打开)才会生效。有的工具用 ANTHROPIC_API_KEY,本站两种都支持。

Base URL 千万不要加 /v1

Claude Code 会自己拼上 /v1/messages。加了 /v1 就变成重复路径,报 404。(Codex 那边反而加,两者别搞混。)

启动前检查

  • 环境变量已生效(或 CC Switch 已切换到 Issue A Card 配置)。
  • 你的 API 密钥没有禁用、过期或额度耗尽。
  • Base URL 是 https://issueacard.top,末尾没有 /v1
  • 你已经进入一个真实项目目录,而不是桌面或下载目录。

进入项目并启动

cd 你的项目目录
claude

如果你还没有项目,可以先新建一个测试目录:

mkdir claude-code-test
cd claude-code-test
claude

第一次可以这样问

请先阅读这个项目的文件结构,然后告诉我它大概是做什么的。不要修改文件。

确认能正常回复后,再让它做更具体的事情:

请帮我找出这个项目里最适合添加登录功能的位置,并给出修改计划。先不要改代码。

新手推荐工作方式

先让 Claude Code 读项目

不要一上来就让它大改。先让它总结项目结构、技术栈、启动方式。

先要计划,再让它改

你可以说“先给我计划,不要改文件”。确认方向没问题后,再让它开始修改。

每次只做一个目标

比如“修复登录报错”或“新增一个按钮”。目标越清楚,结果越稳定。

让它运行检查

修改完成后,让 Claude Code 运行测试、构建或格式化命令,并把结果告诉你。

常用指令示例

你想做什么 可以这样说
看懂项目 请阅读项目结构,告诉我入口文件、主要模块和启动方式。
改一个小功能 请帮我新增一个“复制链接”按钮,先说明会改哪些文件。
修 bug 这个报错是怎么来的?请定位原因并给出最小修改方案。
检查质量 请 review 刚才的修改,重点看有没有安全问题和边界情况。
看到权限确认是正常的

Claude Code 可能会在读文件、改文件或运行命令前请求确认。新手阶段建议认真看一下它要做什么,再选择是否允许。