> ## Documentation Index
> Fetch the complete documentation index at: https://fireworks.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Manual setup (advanced)

> Configure a coding harness for Fireworks by hand, without installing the Nexus CLI.

The Nexus CLI writes your harness settings for you and undoes them with one command. Most people should use it. Manual setup is for when you can't install a CLI, or when you need settings the Nexus CLI doesn't write.

## When to use manual setup

* You can't install the Nexus CLI. It needs Node.js 22 or later, `git`, and `bash`, and runs an install script.
* You manage harness configs yourself, through dotfiles or a team rollout.
* You want Nexus Auto to use Anthropic or OpenAI models without [Provider Keys](https://fireworks.ai/docs/nexus/provider-keys.md) or the Nexus CLI. You add the `x-anthropic-api-key` or `x-openai-api-key` header yourself. With the Nexus CLI, `nexus auto --anthropic-api-key` or `--openai-api-key` writes them for you.
* You want to review every setting that changes.

## What changes without the Nexus CLI

You point the harness at the same Fireworks endpoints, with your own API key. Some things the Nexus CLI normally handles become your job.

| | With the Nexus CLI | With manual setup |
| - | - | - |
| Fireworks models in the picker | Added for you | Set the model ID in your config |
| Anthropic model turns in Claude Code | Paid by your Claude login | Need an Anthropic [Provider Key](https://fireworks.ai/docs/nexus/provider-keys.md) or an `x-anthropic-api-key` header |
| MCP tool search | Turned on | Claude Code: add `ENABLE_TOOL_SEARCH`. Codex: write a model catalog that sets `supports_search_tool` (see [What the Nexus CLI writes](https://fireworks.ai/docs/nexus/harnesses/codex.md#what-the-nexus-cli-writes)) |
| Session cost status line (Claude Code) | Installed | Not available |
| Anthropic and OpenAI keys for Nexus Auto | Saved once with `nexus auto` and written into each harness that can send them | Add `x-anthropic-api-key` or `x-openai-api-key` headers to each config |
| Undo | `nexus <harness> off` | Restore your own backup |
| Updates | `nexus update` refreshes connected harnesses | Update your configs yourself |

## Before you start

1. Create an API key in [Fireworks settings](https://app.fireworks.ai/settings/users/api-keys) and export it:

   ```bash wrap theme={null}
   export FIREWORKS_API_KEY="fw_..."
   ```

2. Back up the config file you're about to edit.

3. Use these endpoints:

   | API | Base URL to configure | Full endpoint | Typical clients |
   | - | - | - | - |
   | Anthropic Messages | `https://api.fireworks.ai/inference` | `https://api.fireworks.ai/inference/v1/messages` | Anthropic SDK, Claude Code |
   | OpenAI Chat Completions | `https://api.fireworks.ai/inference/v1` | `https://api.fireworks.ai/inference/v1/chat/completions` | OpenAI SDK, Fireworks SDK, most gateways and harnesses |
   | OpenAI Responses | `https://api.fireworks.ai/inference/v1` | `https://api.fireworks.ai/inference/v1/responses` | OpenAI SDK, Codex |

   Anthropic-style clients add `/v1/messages` to the base URL themselves, so their base URL ends at `/inference`.

Use any model ID from [Open Models](https://fireworks.ai/docs/nexus/open-models.md), such as `glm-latest`, or `auto` for [Nexus Auto](https://fireworks.ai/docs/nexus/auto.md).

## Set up your harness

| Harness | Status | Manual setup |
| - | - | - |
| [Claude Code](https://fireworks.ai/docs/nexus/harnesses/claude-code.md) | Generally available | [Manual setup tab](https://fireworks.ai/docs/nexus/harnesses/claude-code.md#manual-setup-advanced) |
| [Claude Agent SDK](https://fireworks.ai/docs/nexus/harnesses/claude-code.md#claude-agent-sdk) | Preview | Reads your Claude Code settings. Set up Claude Code first. |
| [Claude Desktop](https://fireworks.ai/docs/nexus/harnesses/claude-desktop.md) | Preview | Not available. Use the Nexus CLI. |
| [Codex](https://fireworks.ai/docs/nexus/harnesses/codex.md) | Generally available | [Manual setup tab](https://fireworks.ai/docs/nexus/harnesses/codex.md#manual-setup-advanced) |
| [ChatGPT desktop app](https://fireworks.ai/docs/nexus/harnesses/chatgpt.md) | Generally available | [Manual setup tab](https://fireworks.ai/docs/nexus/harnesses/chatgpt.md#manual-setup-advanced) |
| [OpenCode](https://fireworks.ai/docs/nexus/harnesses/opencode.md) | Generally available | [Manual setup tab](https://fireworks.ai/docs/nexus/harnesses/opencode.md#manual-setup-advanced) |
| [Pi](https://fireworks.ai/docs/nexus/harnesses/pi.md) | Generally available | [Manual setup tab](https://fireworks.ai/docs/nexus/harnesses/pi.md#manual-setup-advanced) |
| [Cursor IDE](https://fireworks.ai/docs/nexus/harnesses/cursor.md) | Preview | [Manual setup tab](https://fireworks.ai/docs/nexus/harnesses/cursor.md#manual-setup-advanced) |
| [VS Code](https://fireworks.ai/docs/nexus/harnesses/vscode.md) | Preview | [Manual setup tab](https://fireworks.ai/docs/nexus/harnesses/vscode.md#manual-setup-advanced) |
| [Copilot App](https://fireworks.ai/docs/nexus/harnesses/copilot-app.md) | Preview | [Manual setup tab](https://fireworks.ai/docs/nexus/harnesses/copilot-app.md#manual-setup-advanced) |
| [Copilot CLI](https://fireworks.ai/docs/nexus/harnesses/copilot-cli.md) | Preview | [Manual setup tab](https://fireworks.ai/docs/nexus/harnesses/copilot-cli.md#manual-setup-advanced) |
| [DeepSeek Harness](https://fireworks.ai/docs/nexus/harnesses/deepseek.md) | Generally available | [Manual setup tab](https://fireworks.ai/docs/nexus/harnesses/deepseek.md#manual-setup-advanced) |

## Use Nexus Auto with manual setup

For Nexus Auto to use an Anthropic or OpenAI model, one of these must be true:

* The harness sends an `x-anthropic-api-key` or `x-openai-api-key` header.
* Your account has [Provider Keys](https://fireworks.ai/docs/nexus/provider-keys.md).

The [harness setup builder](https://fireworks.ai/docs/nexus/auto.md#nexus-cli) generates a config with the headers included. Cursor IDE and the Copilot App can't send extra headers, so they need Provider Keys.

## Microsoft Foundry

To configure a harness by hand against Fireworks on Microsoft Foundry, see [Configure a harness manually](https://fireworks.ai/docs/nexus/microsoft-foundry.md#configure-a-harness-manually).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.